作者:阿宝
更新:2016-08-31
来源:彩色世界(https://blog.hz601.org/2016/07/26/android-NDK-application-mk/index.html)
英文原版: Android NDK Application.mk
前言
Application.mk文件用来说明一款APP依赖于哪些本地模块。本地模块可以是静态链接库,动态链接库,或者可执行文件。
注: 我们强烈建议你在阅读本文之前,先阅读 Android.mk,以便更好的理解。
概述
Application.mk文件是一个迷你的GNU Makefile片段,用来定义一些编译变量。Application.mk文件一般放在$PROJECT/jni/目录下,其中$PROJECT代表项目目录。也可以把文件放在$NDK/app//目录下,其中$NDK为NDK根目录,为项目简称。例如
$NDK/apps/<myapp>/Application.mk
变量
APP_PROJECT_PATH
此变量值必须是项目根目录的绝对路径。用于指定JNI生成的.so文件的安装路径或拷贝路径。
注:此变量对于概述中的第一种方法是可选的,但对于第二种方法却是必须的。
APP_OPTIM
可选值为 release 或 debug。用来设置编译器的编译优化级别。
默认为 release 模式,用于生成优化过的二进制机器码。debug 模式用于生成未优化的二进制机器码,方便调试错误。
无论在哪种模式下,都可以进行调试。不同的是在release模式下调试器可提供的信息更少。比如,一些被优化过的变量,是无法用于检查,单步调试,或者跟踪的。
如果在项目的manifest文件中声明了 android:debuggable 标签,那么Apllication.mk文件中此变量的默认值被修改为 debug。你也可以在Apllication.mk文件中设置此变量来覆盖manifest文件中的设置。
APP_CFLAGS
此变量用来指定编译C/C++代码的编译选项。当你需要修改某个指定模块的编译参数时,可以修改此变量,而不必去修改Android.mk文件。
此变量中涉及到的文件路径,可以使用相对路径(相对于NDK根目录),或绝对路径。例如
sources/foo/Android.mk
sources/bar/Android.mk
如果你想要在编译模块时把bar目录添加进foo/Android.mk文件中,可以这样做:
APP_CFLAGS += -Isources/bar
或者这样:
APP_CFLAGS += -I$(LOCAL_PATH)/../bar
注意,不能使用 -I../bar 这样的方式,因为它会被编译器解析为 -I$NDK_ROOT/../bar,这明显不是我们想要的结果。
注: 在android-ndk-1.5_r1版本中,此变量只能用于C代码。之后的版本中C/C++都是支持的。
APP_CPPFLAGS
此变量用来指定编译C++代码的编译选项。
注: 在android-ndk-1.5_r1版本中,此变量同时适用于C和C++代码。之后的版本中只支持C++代码。如果要同时支持C/C++代码,可以使用APP_CFLAGS变量。
APP_LDFLAGS
此变量用来指定生成应用时使用到的链接选项。此选项用于编译动态链接库和可运行程序,当编译静态链接库时,此选项被忽略。
APP_BUILD_SCRIPT
此变量用来指定NDK编译脚本,默认为jni/Android.mk。可以使用相对路径(相对于NDK根目录),或绝对路径。
APP_ABI
默认情况下,NDK会使用'armeabi' ABI来生成二进制机器码,这是基于ARMv5TE并支持浮点运算的机器码。可以使用此变量来指定不同的ABI。下表中列出了适用于不同指令集的 ABI 选项。
表1:不同指令集下的 APP_ABI 设置
指令集 | 取值 |
---|---|
支持基于armv7 FPU指令集的设备 | APP_ABI := armeabi-v7a |
ARMv8 AArch64 | APP_ABI := x86 |
IA-32 | APP_ABI := x86 |
Intel64 | APP_ABI := x86_64 |
MIPS32 | APP_ABI := mips |
MIPS64 (r6) | APP_ABI := mips64 |
支持所有指令集 | APP_ABI := all |
注: 从NDKr7开始支持all取值。
你可以同时指定多个取值,取值之间使用空格分隔。例如
APP_ABI := armeabi armeabi-v7a x86 mips
有关可用的ABI列表,信息,及使用限制,参考这里ABI Management。
APP_PLATFORM
此变量用来指定目标Android平台的名称。例如'android-3'代表了Android 1.5系统。完整的Android平台名称及系统版本参见Android NDK Native APIs。
APP_STL
默认情况下,NDK通过Androoid自带的迷你C++运行库(system/lib/libstdc++.so)来提供标准C++头文件。另外,NDK提供了可供选择的C++实现,你可以通过此变量来指定在程序内使用或链接的C++库。更多有关支持的C++库和特性参见这里NDK Runtimes and Features。
APP_SHORT_COMMANDS
此变量用来给所有的模块设置LOCAL_SHORT_COMMANDS选项。更详细的说明查看 Android.mk 的LOCAL_SHORT_COMMANDS选项。
NDK_TOOLCHAIN_VERSION
此变量用来指定编译器(默认为GCC)的版本。64位ABI默认GCC版本为4.9,32位默认为4.8。如果使用Clang编译器,可选值为clang3.4 或 clang3.5 或 clang。clang表示使用最新版本。
APP_PIE
安卓动态链接器,从4.1系统(API 16)开始支持基于位置的可执行程序(PIE)特性。从5.0系统(API 21)开始,可执行程序依赖于PIE特性。通过设置-fPIE选项来编译支持PIE的可执行程序。糟糕的是,这个选项会让随机代码位置引起的内存泄露的分析变得更加困难。
如果项目目标为SDK 16或以上版本,ndk-build会默认启用此选项。当然你也可以设置为false来禁用此选项。
此选项仅对可执行程序有效。换句话说,在编译动/静态库时使用无任何效果。
注: 此选项不支持安卓4.1以前的系统。
APP_THIN_ARCHIVE
此选项用来给所有的模块设置LOCAL_THIN_ARCHIVE默认值。更多信息请查看Android.mk的LOCAL_THIN_ARCHIVE选项。