您现在的位置是：首页 > 文章详情

NDK基础之Android.mk基础

日期：2019-04-26点击：480收藏

Android NDK官方介绍
Android Developers NDK 指南

1、 Android.mk介绍

用于向构建系统描述源文件和共享库

1.1 定义 Application.mk；

1.2 构建系统和环境变量所未定义的项目范围设置；

1.3 替换特定模块的项目范围设置。

2、 Android.mk基本写法

2.1 首先定义LOCAL_PATH变量

在这里，构建系统提供的红函数my-dir将范湖当前目录（包含Android.mk所在目录)
LOCAL_PATH := $(call my-dir)

2.2 接着声明CLEAR_VARS变量

CLEAR_VARS变量指向特殊GNU Makefile，可为您清除许多LOCAL_XXX变量
注意：它不会清除LOCAL_PATH变量，此变量必须保留其值，因为系统在单一GNU Make执行环境（其中所有变量都是全局变量）解析所有构建控制文件，在描述每个模块之前，必须声明（重新声明）此变量

include $(CLEAR_VARS)

2.3 LOCAL_MODULE变量将存储您要构建的模块名称

XXX代表你要生成的库文件的名称
在生成过程中系统会自动在XXX前面加上lib，形成libXXX.so的形式
应用的每个模块都应该使用一个该变量
LOCAL_MODULE := XXX

2.4 枚举源文件，以空格分隔多个文件

变量必须包含要构建到模块中的C或者C++等源文件列表
LOCAL_SRC_FILES := hello.c index.c

2.5 连接系统所有内容

BUILD_SHARED_LIBRARY 变量指向GNU Makefile脚本，用于收集您最近include后在LOCAL_XXX变量中定义的所有信息
GNU Makefile脚本确定要构建的内容及操作方法
include $(BUILD_SHARED_LIBRARY)

2.6 自定义变量，不要与NDK构建系统预留变量冲突如

以LOCAL_开头的名称，如LOCAL_MODULE
以PRIVATE_、NDK_、或APP开头的名称，构建系统在内部使用这些变量
小写名称，例如my-dir
如果为了方便需要自定义变量，建议名称前附件MY_；
NDK变量和相关宏定义

Application.mk介绍

该文件实际也是微型GNU Makefile片段，用于定义编译的多个变量。该文件通常位于￥PROJECT/jni/下，与Android.mk同个目录，其中PROJECT指向应用的项目目录，另一种方式是将其放在顶级$NDK/apps/目录的子目录下。例如
$NDK/apps/<myapp>/Application.mk
这里的myapp是用于向NDKgo构建系统描述应用的jianch个，他不会实际进入生成的共享库或者最终软件包。

3.1 APP_PROJECT_PATH

此变量用于存储应用项目根目录的绝对路径。构建系统使用此信息将生成的 JNI 共享库的简缩版放入 APK 生成工具已知的特定位置。
如果您将 Application.mk 文件放在 $NDK/apps// 下，则必须定义此变量。如果将其放在 $PROJECT/jni/ 下，则此变量可选。

3.2 APP_MODULES

如果定义此变量，变量会指示 ndk-build 仅构建相应模块及其依赖的模块。列出模块名称时必须用空格分隔，与其在 Android.mk 文件 LOCAL_MODULE 定义中的显示方式一样。

如果未定义此变量，ndk-build 会查找所有可安装的顶级模块的列表，即 Android.mk 文件及其直接包括的任何文件所列的模块。但是，导入的模块不是顶级模块。

可安装的模块是共享库或可执行文件，后者会在 libs/$ABI/ 中生成一个文件。

如果未定义此变量，而且项目中没有可安装的顶级模块，ndk-build 就会改为构建所有顶级静态库及其依赖项。这些库会放在 obj/ 或 obj-debug/ 下的常用位置。

3.3 APP_OPTIM

请将这个可选变量定义为 release 或 debug。使用此变量可以在构建应用的模块时变更优化级别。

发布模式为默认模式，可以生成高度优化的二进制文件。调试模式会生成未经优化的二进制文件，如此更容易调试。

请注意，您可以调试发布或调试二进制文件。但是，发布二进制文件在调试时提供的信息较少。例如，构建系统会优化掉一些变量，导致您无法对其进行检查。此外，代码重新排序可能增大单步调试代码的难度；堆栈轨迹可能不可靠。

在应用清单的标记中声明 android:debuggable 将导致此变量默认为 debug 而非 release。将 APP_OPTIM 设置为 release 可替换此默认值。

3.4 APP_CFLAGS

此变量用于存储一组 C 编译器标记，供构建系统在为任何模块编译任何 C 或 C++ 源代码时传递到编译器。使用此变量可以根据需要给定模块的应用更改该模块的版本号，而无需修改 Android.mk 文件本身。使用 APP_CPPFLAGS 只能为 C++ 指定标记。

这些标记中的所有路径都应相对于顶级 NDK 目录。例如，如果您有以下设置：

sources/foo/Android.mk sources/bar/Android.mk

要在 foo/Android.mk 中指定您在编译时要添加指向 bar 源文件的路径，应使用：

APP_CFLAGS += -Isources/bar

或者：

APP_CFLAGS += -I$(LOCAL_PATH)/../bar

-I../bar 无效，因为它相当于 -I$NDK_ROOT/../bar。

3.5 APP_CPPFLAGS

此变量包含一组 C++ 编译器标记，仅供构建系统构建 C++ 源文件时传递到编译器。使用 APP_CFLAGS 可以为 C 和 C++ 指定标记。

3.6 APP_LDFLAGS

在链接应用时，构建系统传递的一组链接程序标记。仅当构建系统构建共享库和可执行文件时，此变量才相关。当构建系统构建静态库时，它会忽略这些标记。

3.7 APP_BUILD_SCRIPT

默认情况下，NDK 构建系统在 jni/ 下查找名为 Android.mk 的文件。

如果您要替换此行为，可以将 APP_BUILD_SCRIPT 定义为指向替代构建脚本。构建系统始终将非绝对路径解释为相对于 NDK 的顶级目录。

3.8 APP_ABI

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

3.9 APP_PLATFORM

此变量包含您想支持的最低版本的 Android 平台。例如，android-15 值指定您的库使用在低于 Android 4.0.3（API 级别 15）的版本中不可用的 API，而且不能在运行低版本平台的设备上使用。如需平台名称和对应 Android 系统映像的完整列表，请参阅 Android NDK 原生 API。

请勿直接更改此标记，而应设置您模块级 build.gradle 文件中 defaultConfig 或 productFlavors 块的 minSdkVersion 属性。这样就能确保只有安装在 Android 版本足够高的设备上的应用才能使用您的库。 ndk-build 工具链使用以下逻辑，根据您所构建的 ABI 以及您指定的 minSdkVersion 来为您的库选择最低版本的平台：

如果现有 ABI 平台版本等于 minSdkVersion，则 ndk-build 会使用该版本。
否则，如果现有 ABI 平台版本低于 minSdkVersion，则 ndk-build 会使用其中版本最高的平台。这种选择较为合理，因通常情况下，平台版本缺失意味着自上一个可用版本以来，原生平台 API 未作任何改变。
否则，ndk-build 会使用下一个高于 minSdkVersion 的可用平台版本。