Android NDK Application.mk（中文翻译）

红太狼 2022-07-17 04:49 134阅读 0赞

作者:阿宝　  
更新:2016-08-31　  
来源:彩色世界([https://blog.hz601.org/2016/07/26/android-NDK-application-mk/index.html][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/<myapp>/目录下，其中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 设置

<table> 
 <thead> 
  <tr> 
   <th>指令集</th> 
   <th>取值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>支持基于armv7 FPU指令集的设备</td> 
   <td>APP_ABI := armeabi-v7a</td> 
  </tr> 
  <tr> 
   <td>ARMv8 AArch64</td> 
   <td>APP_ABI := x86</td> 
  </tr> 
  <tr> 
   <td>IA-32</td> 
   <td>APP_ABI := x86</td> 
  </tr> 
  <tr> 
   <td>Intel64</td> 
   <td>APP_ABI := x86_64</td> 
  </tr> 
  <tr> 
   <td>MIPS32</td> 
   <td>APP_ABI := mips</td> 
  </tr> 
  <tr> 
   <td>MIPS64 (r6)</td> 
   <td>APP_ABI := mips64</td> 
  </tr> 
  <tr> 
   <td>支持所有指令集</td> 
   <td>APP_ABI := all</td> 
  </tr> 
 </tbody> 
</table>

*注: 从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选项。

**工具推荐**  
1.软件开发必备翻墙代理，低延迟(50ms)，月费10元，详询（宝哥儿QQ1066690060）请自觉遵守国家法律法规

[https_blog.hz601.org_2016_07_26_android-NDK-application-mk_index.html]: https://blog.hz601.org/2016/07/26/android-NDK-application-mk/index.html
[Android NDK Application.mk]: https://developer.android.com/ndk/guides/application_mk.html
[Android.mk]: https://blog.hz601.org/2016/07/26/android-NDK-android-mk/index.html
[ABI Management]: https://developer.android.com/ndk/guides/abis.html
[Android NDK Native APIs]: https://developer.android.com/ndk/guides/stable_apis.html
[NDK Runtimes and Features]: https://developer.android.com/ndk/guides/cpp-support.html#runtimes