将 NDK 与其他构建系统配合使用

注意：本页介绍的内容适用于 NDK r19 及更高版本。如果您使用的是旧版 NDK，请考虑进行升级。如果无法升级，请使用 <NDK>/build/tools/make_standalone_toolchain.py。

NDK 提供对 ndk-build 和 CMake 的官方支持。大多数用户应参考其中一个指南来构建应用代码。本文旨在介绍如何构建使用其他构建系统的现有代码。如果您要使用并非特定于 Android 的第三方依赖项，例如 OpenSSL 和 libbzip2，则可以参考本文。

如果构建系统维护者希望为构建系统增加原生 NDK 支持，应阅读构建系统维护者指南。

概览

只需完成定义目标环境所需的极少配置工作，即可使用 NDK 中的 Clang 编译器。

为了确保针对正确的架构进行构建，请将适当的 在调用 Clang 时，将目标与 -target 搭配使用。例如，要针对 64 位 对于 minSdkVersion 为 21 的 ARM Android，请执行以下操作：

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

或者，Clang 还提供了带有目标前缀的入口点。这些可能是 转发到 Clang 的符号链接或脚本，具体取决于 NDK 版本 和主机操作系统。直接使用 --target 调用 Clang 会更可靠，因为 这是测试最频繁的工作流，偶尔会有参数转发 存在一些 bug在 Windows 上，转发所需的额外 CreateProcess 从脚本发送到真正的编译器时，可能会出现明显的 会对构建速度产生负面影响。

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

在这两种情况下，请将 $NDK 替换为指向 NDK 的路径，将 $HOST_TAG 替换为指向根据下表所下载的 NDK 的路径：

NDK 操作系统变体	主机标记
macOS	darwin-x86_64
Linux	linux-x86_64
64 位 Windows	windows-x86_64

注意：虽然 Darwin 名称中包含 x86_64 标记，但这些是包含 M1 支持的胖二进制文件。路径并未更新以反映这项支持，因为这样做会导致编码这些路径的现有 build 损坏。

这里的前缀或目标参数的格式是目标三元组，带有表示 minSdkVersion 的后缀。该后缀仅与 clang/clang++ 一起使用；binutils 工具（例如 ar 和 strip）不需要后缀，因为它们不受 minSdkVersion 影响。Android 支持的目标三元组如下：

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

注意：对于 32 位 ARM，编译器会使用前缀 armv7a-linux-androideabi，但 binutils 工具会使用前缀 arm-linux-androideabi。对于其他架构，所有工具的前缀都相同。

许多项目的构建脚本都预计使用 GCC 风格的交叉编译器，其中每个编译器仅针对一种操作系统/架构组合，因此可能无法正常处理 -target。在这些情况下，您通常可以添加 -target 作为编译器定义的一部分（例如 CC="clang -target aarch64-linux-android21）。在极少数情况下，您所使用的构建系统 无法使用该形式，请使用三元组前缀的 Clang 二进制文件。

Autoconf

注意：通常无法在 Windows 上构建 Autoconf 项目。Windows 用户可以使用 Linux 虚拟机中的 Linux NDK 构建这些项目。适用于 Linux 的 Windows 子系统或许也能正常运行，但不受官方支持。目前已知 WSL1无法正常运行。

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/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

此示例中选择的工具适用于 NDK r22 及更高版本。旧版 NDK 可能需要不同的工具。

非 Autoconf make 项目

注意：并非所有的 make 项目都支持交叉编译，且并非所有 make 项目都以相同的方式支持交叉编译。如果不进行修改，很可能无法构建项目。在这些情况下，请参阅构建系统维护者指南，了解有关将 build 移植到 Android 的说明。

一些 makefile 项目允许通过覆盖与在 autoconf 项目中覆盖的变量相同的变量进行交叉编译。以下示例展示了如何使用 API 级别 21 的 minSdkVersion 为 Android x86-64 构建 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/clang --target=$TARGET$API" \
    AR=$TOOLCHAIN/bin/llvm-ar \
    RANLIB=$TOOLCHAIN/bin/llvm-ranlib \
    bzip2

此示例中选择的工具适用于 NDK r22 及更高版本。旧版 NDK 可能需要不同的工具。