Le NDK est officiellement compatible avec ndk-build et CMake. La plupart des utilisateurs doivent se référer à l'un de ces guides pour créer le code d'application. L'objectif de ce document est de décrire comment compiler du code existant qui utilise d'autres systèmes de compilation. C'est souvent le cas des dépendances tierces qui ne sont pas spécifiques d'Android, comme OpenSSL et libbzip2.
Les personnes qui gèrent un système de compilation et souhaitent lui intégrer la compatibilité NDK native doivent plutôt consulter la page Build System Maintainers Guide.
Aperçu
Le compilateur Clang du NDK est utilisable avec la configuration minimale requise pour définir votre environnement cible.
Pour vous assurer que votre build repose sur la bonne architecture, transmettez les
target avec -target lors de l'appel de Clang. Par exemple, pour compiler pour des projets de code
ARM sur Android avec un minSdkVersion de 21:
$ $NDK/toolchains/llvm/prebuilt/$HOST_TAG/bin/clang++ \
--target aarch64-linux-android21 foo.cpp
Il existe également des points d'entrée avec préfixe cible pour Clang. Il peut s'agir de
Liens symboliques ou scripts redirigeant vers clang, en fonction de la version du NDK
et l'OS hôte. Appeler Clang directement avec --target sera plus fiable, car
qui est le workflow le plus testé, et il arrive que le transfert d'arguments
les bugs dans les scripts. Sous Windows, le CreateProcess supplémentaire nécessaire pour transférer
du script au véritable compilateur peut potentiellement avoir un problème
peut avoir un impact négatif
sur la vitesse de compilation.
$ $NDK/toolchains/llvm/prebuilt/$HOST_TAG/bin/aarch64-linux-android21-clang++ \
foo.cpp
Dans les deux cas, remplacez $NDK par le chemin d'accès au NDK et définissez $HOST_TAG pour qu'il corresponde au NDK que vous avez téléchargé, conformément au tableau suivant :
| Variante d'OS du NDK | Balise d'hôte |
|---|---|
| macOS | darwin-x86_64 |
| Linux | linux-x86_64 |
| Windows 64 bits | windows-x86_64 |
Le format du préfixe ou de l'argument cible correspond ici au triplet cible avec un suffixe indiquant la minSdkVersion. Ce suffixe n'est utilisé qu'avec clang/clang++. Les outils binutils (tels que ar et strip) ne nécessitent pas de suffixe, car ils ne sont pas affectés par la minSdkVersion. Les triplets cibles compatibles avec Android sont les suivants :
| ABI | Triplet |
|---|---|
| armeabi-v7a | armv7a-linux-androideabi |
| arm64-v8a | aarch64-linux-android |
| x86 | i686-linux-android |
| x86-64 | x86_64-linux-android |
Les scripts de compilation d'un grand nombre de projets prévoient des compilateurs croisés de type GCC, où chaque compilateur ne cible qu'une seule combinaison OS/architecture. Il est donc possible qu'ils ne gèrent pas correctement -target. Dans ce cas, vous pouvez généralement inclure le -target
argument dans la définition du compilateur (par exemple, CC="clang -target
aarch64-linux-android21). Dans les rares cas où le système de compilation que vous utilisez est
ne pouvez pas utiliser ce formulaire, utilisez les binaires Clang avec le triplet en préfixe.
Autoconf
Les projets autoconf vous permettent de spécifier la chaîne d'outils à utiliser avec des variables d'environnement. L'exemple suivant montre comment compiler libpng pour Android x86-64 avec une minSdkVersion de niveau d'API 21, sous Linux.
# Check out the source. git clone https://github.com/glennrp/libpng -b v1.6.37 cd libpng# Only choose one of these, depending on your build machine... export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/darwin-x86_64 export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64# Only choose one of these, depending on your device... export TARGET=aarch64-linux-android export TARGET=armv7a-linux-androideabi export TARGET=i686-linux-android export TARGET=x86_64-linux-android# Set this to your minSdkVersion. export API=21# Configure and build. export AR=$TOOLCHAIN/bin/llvm-ar export CC="$TOOLCHAIN/bin/clang --target=$TARGET$API" export AS=$CC export CXX="$TOOLCHAIN/bin/clang++ --target=$TARGET$API" export LD=$TOOLCHAIN/bin/ld export RANLIB=$TOOLCHAIN/bin/llvm-ranlib export STRIP=$TOOLCHAIN/bin/llvm-strip ./configure --host $TARGET make
Les outils sélectionnés dans cet exemple conviennent à NDK r22 ou version ultérieure. Les NDK plus anciens peuvent nécessiter des outils différents.
Projets make sans autoconf
Certains projets makefile autorisent la compilation croisée via le remplacement des mêmes variables que dans un projet autoconf. L'exemple suivant montre comment compiler libbzip2 pour Android x86-64 avec une minSdkVersion de 21.
# Check out the source.
git clone https://gitlab.com/bzip/bzip2.git
cd bzip2
# Only choose one of these, depending on your build machine...
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/darwin-x86_64
export TOOLCHAIN=$NDK/toolchains/llvm/prebuilt/linux-x86_64
# Only choose one of these, depending on your device...
export TARGET=aarch64-linux-android
export TARGET=armv7a-linux-androideabi
export TARGET=i686-linux-android
export TARGET=x86_64-linux-android
# Set this to your minSdkVersion.
export API=21
# Build.
make \
CC="$TOOLCHAIN/bin/clang --target=$TARGET$API" \
AR=$TOOLCHAIN/bin/llvm-ar \
RANLIB=$TOOLCHAIN/bin/llvm-ranlib \
bzip2
Les outils sélectionnés dans cet exemple conviennent à NDK r22 ou version ultérieure. Les NDK plus anciens peuvent nécessiter des outils différents.