將 NDK 與其他建構系統搭配使用

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

NDK 提供對 ndk-buildCMake 的官方支援。大部分使用者都應參閱這些指南中的其中一份,瞭解如何建構應用程式程式碼。本文件旨在說明如何建構採用其他建構系統的現有程式碼。這種情況通常出現於不是 Android 特有的第三方依附元件中,例如 OpenSSL 和 libbzip2。

如果建構系統維護人員想要為建構系統新增原生 NDK 支援,則應改為參閱建構系統維護人員指南

總覽

自 NDK r19 起,NDK 預設安裝的工具鏈可供使用。與任意建構系統互動時,不再需要使用 make_standalone_toolchain.py 指令碼。

為確保使用正確的架構進行建構,請在叫用 Clang 時透過 -target 傳遞適當的目標,或叫用將前置字串設為目標的 Clang。例如,如要編譯 64 位元的 ARM Android (minSdkVersion 為 21),可以使用以下任一方法 (您可以從中選擇您認為最簡便的方法):

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

在這兩種情況下,請將 $NDK 替換為 NDK 的路徑,並將 $HOST_TAG 替換為您依照下表下載的 NDK 的路徑:

NDK OS 變化版本 主機標記
macOS darwin-x86_64
Linux linux-x86_64
32 位元 Windows windows
64 位元 Windows windows-x86_64

這裡的前置字串或目標引數格式是目標三元組,並在結尾加上表示 minSdkVersion 的後置字串。這個後置字串只能搭配 clang/clang++ 使用,binutils 工具 (例如 arstrip) 則因為不受 minSdkVersion 影響而不需要後置字串。Android 支援的目標三元組如下:

ABI 三元組
armeabi-v7a armv7a-linux-androideabi
arm64-v8a aarch64-linux-android
x86 i686-linux-android
x86-64 x86_64-linux-android

許多專案的建構指令碼預計使用 GCC 樣式的交叉編譯器,其中每個編譯器僅指定一個 OS/架構組合,因此可能無法正常處理 -target。在這種情況下,最好使用前置字串為三元組的 Clang 二進位檔。

Autoconf

透過 Autoconf 專案,您可以指定與環境變數搭配使用的工具鏈。例如,以下範例說明如何在 Linux 上透過 API 級別 21 的 minSdkVersion 為 Android x86-64 建構 libpng

# 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/$TARGET$API-clang
export AS=$CC
export CXX=$TOOLCHAIN/bin/$TARGET$API-clang++
export LD=$TOOLCHAIN/bin/ld
export RANLIB=$TOOLCHAIN/bin/llvm-ranlib
export STRIP=$TOOLCHAIN/bin/llvm-strip
./configure --host $TARGET
make

這個範例中選取的工具適用於 NDK r22 及更新版本。舊版 NDK 可能需要不同的工具。

非 autoconf make 專案

部分 makefile 專案允許覆寫與 autoconf 專案相同的變數,藉此進行跨平台程式碼編譯。例如,以下範例說明如何為 Android x86-64 (minSdkVersion 為 21) 建構 libbzip2

# 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/$TARGET$API-clang \
    AR=$TOOLCHAIN/bin/llvm-ar \
    RANLIB=$TOOLCHAIN/bin/llvm-ranlib \
    bzip2

這個範例中選取的工具適用於 NDK r22 及更新版本。舊版 NDK 可能需要不同的工具。