Application.mk

本文档介绍了 ndk-build 使用的 Application.mk 构建文件。

建议您先阅读概念页面再阅读本文档。

概览

Application.mk 指定了 ndk-build 的项目范围设置。默认情况下，它位于应用的项目目录中的 jni/Application.mk。

变量

APP_ABI

默认情况下，NDK 构建系统会为所有未废弃的 ABI 生成代码。您可以使用 APP_ABI 设置为特定 ABI 生成代码。表 1 显示了不同指令集的 APP_ABI 设置。

表 1. 不同指令集的 APP_ABI 设置。

指令集 值
32 位 ARMv7 APP_ABI := armeabi-v7a
64 位 ARMv8 (AArch64) APP_ABI := arm64-v8a
x86 APP_ABI := x86
x86-64 APP_ABI := x86_64
所有支持的 ABI（默认） APP_ABI := all

您也可以通过将多个值放在同一行并用空格分隔来指定它们。例如

APP_ABI := armeabi-v7a arm64-v8a x86

如需了解所有支持的 ABI 及其用法和限制的列表，请参阅Android ABI。

APP_ASFLAGS

要传递给汇编器，用于项目中的每个汇编源文件（.s 和 .S 文件）的标志。

APP_ASMFLAGS

要传递给 YASM，用于所有 YASM 源文件（.asm，仅限 x86/x86_64）的标志。

APP_BUILD_SCRIPT

默认情况下，ndk-build 假定 Android.mk 文件位于项目根目录下的 jni/Android.mk。

要从其他位置加载 Android.mk 文件，请将 APP_BUILD_SCRIPT 设置为 Android.mk 文件的绝对路径。

APP_CFLAGS

要传递给项目中的所有 C/C++ 编译的标志。

另请参阅：APP_CONLYFLAGS、APP_CPPFLAGS。

APP_CLANG_TIDY

设为 true 可为项目中的所有模块启用 clang-tidy。默认情况下禁用。

APP_CLANG_TIDY_FLAGS

要传递给项目中的所有 clang-tidy 执行的标志。

APP_CONLYFLAGS

要传递给项目中的所有 C 编译的标志。这些标志不用于 C++ 代码。

另请参阅：APP_CFLAGS、APP_CPPFLAGS。

APP_CPPFLAGS

要传递给项目中的所有 C++ 编译的标志。这些标志不用于 C 代码。

另请参阅：APP_CFLAGS、APP_CONLYFLAGS。

APP_CXXFLAGS

与 APP_CPPFLAGS 相同，但在编译命令中会出现在 APP_CPPFLAGS 之后。例如

APP_CPPFLAGS := -DFOO
APP_CXXFLAGS := -DBAR

上述配置将生成类似于 clang++ -DFOO -DBAR 的编译命令，而不是 clang++ -DBAR -DFOO。

APP_DEBUG

设为 true 可构建一个可调试的应用。

APP_LDFLAGS

链接可执行文件和共享库时要传递的标志。

APP_MANIFEST

AndroidManifest.xml 文件的绝对路径。

默认情况下，如果存在 $(APP_PROJECT_PATH)/AndroidManifest.xml)，将使用该文件。

APP_MODULES

要构建的模块的显式列表。此列表中的元素是模块在 Android.mk 文件中 LOCAL_MODULE 中显示的名称。

默认情况下，ndk-build 将构建所有共享库、可执行文件及其依赖项。静态库仅在项目使用它们、项目仅包含静态库或在 APP_MODULES 中命名时才会构建。

APP_OPTIM

将此可选变量定义为 release 或 debug。默认情况下将构建 release 二进制文件。

Release 模式启用优化，并可能生成无法与调试器一起使用的二进制文件。Debug 模式禁用优化，以便可以使用调试器。

请注意，您可以调试 release 或 debug 二进制文件。但是，release 二进制文件在调试期间提供的信息较少。例如，变量可能会被优化掉，从而无法检查。此外，代码重新排序可能会使单步调试代码更加困难；堆栈跟踪可能不可靠。

在您的应用清单的 <application> 标签中声明 android:debuggable 将使此变量默认为 debug 而不是 release。通过将 APP_OPTIM 设置为 release 来覆盖此默认值。

APP_PLATFORM

APP_PLATFORM 声明了构建此应用所针对的 Android API 级别，并对应于应用的 minSdkVersion。

如果未指定，ndk-build 将针对 NDK 支持的最低 API 级别。最新 NDK 支持的最低 API 级别始终足够低，以支持几乎所有活跃设备。

例如，值 android-16 指定您的库使用的 API 在 Android 4.1（API 级别 16）以下版本中不可用，并且无法在运行较低平台版本的设备上使用。有关平台名称和相应 Android 系统映像的完整列表，请参阅Android NDK 原生 API。

使用 Gradle 和 externalNativeBuild 时，不应直接设置此参数。而是应在模块级 build.gradle 文件中的 defaultConfig 或 productFlavors 块中设置 minSdkVersion 属性。这可以确保您的库仅由安装在运行适当版本 Android 的设备上的应用使用。

请注意，NDK 不包含适用于 Android 每个 API 级别的库。未包含新原生 API 的版本被省略，以节省 NDK 中的空间。ndk-build 按偏好降序使用：

  1. 与 APP_PLATFORM 匹配的平台版本。
  2. 低于 APP_PLATFORM 的下一个可用 API 级别。例如，当 APP_PLATFORM 为 android-20 时，将使用 android-19，因为 android-20 中没有新的原生 API。
  3. NDK 支持的最低 API 级别。

APP_PROJECT_PATH

项目的根目录的绝对路径。

APP_SHORT_COMMANDS

LOCAL_SHORT_COMMANDS 的项目范围等效项。有关更多信息，请参阅 Android.mk 中关于 LOCAL_SHORT_COMMANDS 的文档。

APP_STL

此应用要使用的 C++ 标准库。

默认使用 system STL。其他选项包括 c++_shared、c++_static 和 none。请参阅NDK C++ 运行时和功能。

APP_STRIP_MODE

要传递给 strip 以用于此应用中的模块的参数。默认为 --strip-unneeded。要避免剥离模块中的所有二进制文件，请设置为 none。有关其他剥离模式，请参阅 strip 文档。

APP_THIN_ARCHIVE

设为 true 可对项目中的所有静态库使用精简存档。有关更多信息，请参阅 Android.mk 中关于 LOCAL_THIN_ARCHIVE 的文档。

APP_WRAP_SH

要包含在此应用中的 wrap.sh 文件的路径。

此变量的变体存在于每个 ABI 中，也存在 ABI 通用变体

  • APP_WRAP_SH
  • APP_WRAP_SH_armeabi-v7a
  • APP_WRAP_SH_arm64-v8a
  • APP_WRAP_SH_x86
  • APP_WRAP_SH_x86_64