Usa l'NDK con altri sistemi di compilazione

Nota: i contenuti descritti in questa pagina richiedono almeno NDK r19. Se stai utilizzando un NDK meno recente, valuta la possibilità di eseguire l'upgrade. Se non riesci a eseguire l'upgrade, utilizza <NDK>/build/tools/make_standalone_toolchain.py.

NDK contiene il supporto ufficiale per ndk-build e CMake. La maggior parte degli utenti dovrebbe consulta una di queste guide per creare il codice dell'applicazione. Lo scopo di questo documento descrive come creare codice esistente che utilizza altre build sistemi operativi. Questo si verifica spesso con dipendenze di terze parti che non sono Specifici per Android, ad esempio OpenSSL e libbzip2.

Creare manutentori di sistema che vogliono aggiungere il supporto NDK nativo alla propria build devono leggere la Guida per i gestori del sistema di build.

Panoramica

Il compilatore clang nel file NDK è utilizzabile con una configurazione minima necessari per definire l'ambiente di destinazione.

Per assicurarti di creare l'architettura corretta, trasmetti i passaggi appropriati scegliere il target con -target quando richiami Clang. Ad esempio, per compilare i campi ARM Android con minSdkVersion di 21:

$ $NDK/toolchains/llvm/prebuilt/$HOST_TAG/bin/clang++ \
    --target aarch64-linux-android21 foo.cpp

In alternativa, esistono punti di ingresso con prefisso target per Clang. Potrebbero essere tramite symlink o script che eseguono il clang, a seconda della release NDK e il sistema operativo host. Richiamare direttamente Clang con --target sarà più affidabile, il flusso di lavoro più testato e a volte ci sono argomenti di bug negli script. Su Windows, i CreateProcess aggiuntivi necessari per l'inoltro dallo script al compilatore reale potrebbe potenzialmente avere un un impatto negativo sulla velocità della build.

$ $NDK/toolchains/llvm/prebuilt/$HOST_TAG/bin/aarch64-linux-android21-clang++ \
    foo.cpp

In entrambi i casi, sostituisci $NDK con il percorso dell'NDK e del valore $HOST_TAG da far corrispondere l'NDK scaricato in base alla tabella seguente:

Variante NDK OS	Tag host
macOS	darwin-x86_64
Linux	linux-x86_64
Windows a 64 bit	windows-x86_64

Nota: nonostante il tag x86_64 nel nome Darwin, si tratta di file binari complessi che includono il supporto M1. I percorsi non sono stati aggiornati in modo da riflettere questo supporto questa operazione avrebbe interrotto le build esistenti che codificano quei percorsi.

Il formato del prefisso o dell'argomento target qui è la tripla di destinazione con un che indica minSdkVersion. Questo suffisso viene utilizzato solo con clang/clang++; gli strumenti binutils (come ar e strip) non richiedono un perché non sono interessati da minSdkVersion. Android supportato le triple target sono i seguenti:

ABI	Triplo
Armeabi-V7a	armv7a-linux-androideabi
arm64-v8a	aarch64-linux-android
x86	i686-linux-android
x86-64	x86_64-linux-android

Nota: per ARM a 32 bit, il compilatore ha il prefisso armv7a-linux-androideabi, ma gli strumenti binutils hanno il prefisso arm-linux-androideabi. Per altro architetture, i prefissi sono gli stessi per tutti gli strumenti.

Molti progetti gli script di build prevedono cross-compilatori in stile GCC, il compilatore ha come target una sola combinazione di sistema operativo/architettura e quindi potrebbe non gestire -target in modo pulito. In questi casi, in genere puoi includere -target nella definizione del compilatore (ad es. CC="clang -target aarch64-linux-android21). Nei rari casi in cui il sistema di compilazione in uso non in grado di utilizzare quel modulo, usa i file binari Clang con triplo prefisso.

Conf. automatica

Attenzione :i progetti Autoconf in genere non sono supportati da Windows. Utenti Windows possono creare questi progetti usando l'NDK Linux in una VM Linux. Anche il sottosistema Windows per Linux potrebbe funzionare, ma non ufficialmente supportati. È noto che WSL1 non funziona.

I progetti Autoconf consentono di specificare la toolchain da utilizzare con l'ambiente come la codifica one-hot delle variabili categoriche. Ad esempio, quanto segue mostra come creare libpng per Android x86-64 con minSdkVersion di livello API 21 su 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

Gli strumenti selezionati in questo esempio sono corretti per NDK r22 e versioni successive. NDK meno recenti potrebbero richiedere strumenti diversi.

Progetti di creazione non autoconf

Attenzione: non tutti i progetti supportano la compilazione incrociata e non tutti lo supportano allo stesso modo. È molto probabile che il progetto non venga creato senza modifiche. In questi casi, consulta la Guida per i gestori del sistema di build per istruzioni sulla portabilità della build su Android.

Alcuni progetti makefile consentono la compilazione incrociata eseguendo l'override delle stesse variabili come con un progetto autoconf. Ad esempio, quanto segue mostra come per sviluppare libbzip2 per Android x86-64 con un minSdkVersion di 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

Gli strumenti selezionati in questo esempio sono corretti per NDK r22 e versioni successive. NDK meno recenti potrebbero richiedere strumenti diversi.