Android.mk 配置参数

0x00 LOCAL_PATH

根据 Android 构建系统要求,Android.mk 文档必须以 LOCAL_PATH 变量的定义开头。

1
LOCAL_PATH := $(call my-dir)

Android 构建系统利用 LOCAL_PATH 来定位源文件。因为将改变量设置为硬编码值不合适,所以 Android 构建系统提供了一个名为 my-dir 的宏功能。通过将该变量设置为 my-dir 宏功能的返回值,可以将其放在当前目录下。

0x01 CLEAR_VARS

Android 构建系统将 CLEAR_VARS 变量设置为 clear-vars.mk 片段的位置。包含 Makefile 片段可以清除除了 LOCAL_PATH 以外的LOCAL_name 变量,例如 LOCAL_MODULE 与 LOCAL_SRC_FILE 等。

1
Include $(CLEAR_VARS)

这样做是因为 Android 构建系统可以在单次执行中解析多个构建文件和模式定义,LOCAL_ 是全局变量。清除它们可以避免冲突,每一个原生组件被称为一个模块。

0x02 LOCAL_MODULE

改变了是用来给这些模块设定一个唯一的名称。下面的代码将该模块的名称设为 hello-jni:

1
LOCAL_MODULE := hello-jni

因为模块名称也被用于给构建过程的所生成的文件命名,所以构建系统给文件添加适当的前缀和后缀。本例中, hello-jni 模块会生成一个共享文件且构建系统会将它命名为 libhello-jni.so。

0x03 LOCAL_SRC_FILES

该变量用来建立和组装这个模块的源文件列表。

1
LOCAL_SRC_FILES := hello-jni.c

这里,hello-jni 模块只有一个源文件生成,而 LOCAL_SRC_FILES 变量可以包含用空格分开的多个源文件名。

0x04 BUILD_SHARED_LIBRARY

为了建立可供主应用程序使用的模块,必须将该模块变成共享库。Android NDK 构建系统将 BUILD_SHARED_LIBRARY 变量设置成 build_shared_libray.mk 文件保存的位置。改 Makefile 片段包含了将源文件构建和组装成共享库的必要过程。

1
include $(BUILD_SHARED_LIBRARY)

0x05 BUILD_STATIC_LIBRARY

建立静态库,Android 应用并不直接使用静态库,一般是将第三方代码作为静态库引入动态库中使用。

1
include $(BUILD_STATIC_LIBRARY)

0x06 引入共享库和静态库

1
2
LOCAL_SHARED_LIBRARY := avilib_share
LOCAL_STATIC_LIBRARY := avilib_static

0x07 多项目共享模块

多个项目共享某个模块时,先将源码导入%NDK_HOME%/source,配置好对应的 Android.mk 文件。在需要的项目中添加:

1
2
LOCAL_SHARED_LIBRARIES := avilib
$(call import-module, transcode/avilib)

0x08 用 Prebuilt 库

将已编译好的 so 文件作为项目的共享模块:

1
2
3
4
5
6
7
LOCAL_PATH := $(call my-dir)
#第三方模块
include $(CLEAR_VARS)
LOCAL_MODULE := avilib
LOCAL_SRC_FILES := libavilib.so
include $(RREBUILT_SHARED_LIBRARY)

0x09 构建可执行文件

1
include $(BUILD_EXECUTABLE)

0x10 其他构建系统变量

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
#目标 CPU 体系结构名称
TARGET_ARCH := arm
#目标 Android 平台名称
TARGET_PLARFORM := andoid-3
#目标 CPU 体系结构和 ABI 名称
TARGET_ARCH_ABI := armeabi-v7a
#目标平台和 ABI 串联
TARGET_ABI := android-3-armeabi-v7a
#重定向输出文件名(默认为 LOCAL_MODULE)
LOCAL_MODULE_FILENAME := avilib
#指定 C++ 源码文件扩展名
LOCAL_CPP_EXTENSION := .cpp .cxx
#指定模块所依赖的具体 C++ 特性
LOCAL_CPP_FEATURES := rtti
#可选目录列表,NDK安装目录的相对路径,用来搜索头文件
LOCAL_C_INCLUDES := sources/shared-module
#添加编译器标志(添加宏定义)
LOCAL_CFLAGS := -DNDEBUG -DPROT=1234
#添加编译器标志(添加宏定义)仅C++
LOCAL_CPP_CFLAGS := -DNDEBUG -DPROT=1234
#LOCAL_STATIC_LIBRARY变体,所有静态库内容(当几个静态库有循环依赖的时候很有用)
LOCAL_WHOLE_STATIC_LIBRARY := avilib bvilib
#链接标志的可选列表
LOCAL_LDLIBS := -llog
#禁止生产文件中进行缺失符号检查
LOCAL_ALLOW_UNDEFINED_SYMBOLS :
#指定要生成的 ARM 二进制类型
LOCAL_ARM_MODE := arm
#开启 NEON 指令
LOCAL_ARM_NEON := true
#禁用 NX bit 安全特性(Never Execute)
LOCAL_DISABLE_NO_EXECUTE := true
#记录一组编译器标志
LOCAL_EXPORT_CFLAGS := -DENABLE_AUDIO
#与上面类型,仅用于 C++
LOCAL_EXPORT_CPPFLAGS := -DENABLE_AUDIO
#与 LOCAL_EXPORT_CFLAGS 类型用于链接器标志
LOCAL_EXPORT_LDFLAGS := -DENABLE_AUDIO
#允许记录路径集
LOCAL_EXPORT_C_INCLUDES :=
#用于有大量资源或者独立的静态库/动态库的模块,分解命令长度
LOCAL_SHORT_COMMANDS := true
#定义了用于过滤来至 LOCAL_SRC_FILES变量的装配文件的应用程序
LOCAL_FILTER_ASM :=

0x11 其他构建系统函数宏

1
2
3
4
5
6
7
8
9
10
11
#返回当前目录下的所有子目录下的 Android.mk 构建文件列表
include $(call all-subdir-makefiles)
#放回当前 Android.mk 构建文件的路径
this-makefile
#返回包含当前构建文件的父 Android.mk 构建文件路径
parent-makefile
#和 parent-makefile 一样但用于祖父目录
grand-parent-makefile

0x12 定义新变量

LOCAL 和 NDK 开头的为预留构建名称,可使用 MY_ 开头的变量

1
2
3
MY_SRC_FILES := avilib.c platform_posix.c
LOCAL_SRC_FILES := $(addprefix avilib/, $(MY_SRC_FILES))

0x13 条件操作

在每个体系结构中包含一个不同的源码文件集

1
2
3
4
5
ifeq ($(TARGET_ARCH), arm)
LOCAL_SRC_FILES += armonly.c
else
LOCAL_SRC_FILES += generic.c
endif

0x14 Application.mk

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
#覆盖 Android.mk 构建的模块列表
APP_MODULES := avilib
#设置二进制文件的优化级别,默认 release
APP_OPTIM := relase / debug
#编译器标志
APP_CLAGS
#编译器标志,作用于 C++ 源文件
APP_CPPLAGS
#从非 jni 子目录下查找 Android.mk 构建文件
APP_BUILD_SCRIPT
#构建系统的二进制文件,默认 armeabi ABI
APP_ABI := all / armeabi mips
#使用不同 STL 实现库,默认 system 库
APP_STL := stlport_shared
#与 LOCAL_CPP_EXTENSIONS 变量相似,表明所有模块都依赖与具体的 C++ 特性,如 RTTI,exceptions
APP_GUNSTL_FORCE_CPP_FEATURES
#与 LOCAL_SHORT_COMMANDS 变量类似
APP_SHORT_COMMANDS