Android: NDK中的Android.mk和Application.mk

时间:2021-09-22 13:11:44

1. 简介

Android.mk  可用来描述要编译的某个具体模块的相关信息。比如:指定编译该模块时所需要的源文件、编译该模块时要链接的库文件、该模块编译完成后生成的库的名字等等。
Application.mk 可用来描述整个应用程序编译时的相关信息。比如:指定编译支持的ABI平台(armeabi-V7a, arm64-v8a, all...)、指定NDK编译时的模块列表、指定目标Android 平台的名称等等。

2. 一个简单的Android.mk文件

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)
LOCAL_MODULE := hello-jni
LOCAL_SRC_FILES := hello-jni.c jnihelp.cpp Calculator.cpp
include $(BUILD_SHARED_LIBRARY)

LOCAL_PATH:  必须位于Android.mk文件的开始,用来定义源文件的位置,$(call my-dir)返回当前路径,即android.mk所在的目录。my-dir是构建系统提供的宏函数,它将会返回当前目录的路径;
include $(CLEAR_VARS): 清除除LOCAL_PATH之外的所有LOCAL_XXX变量。这个清理动作是必须的,因为所有的编译控制文件都是由同一个GNU Make解析和执行,其变量是全局的,只有清理后才能避免相互影响。
LOCAL_MODULE: 表示Android.mk所在模块的模块名,名字必须唯一且不包含空格。构建系统在生成最终的so库文件时,会参考该模块名生成最终的so库,如:libhello-jni.so;
LOCAL_SRC_FILES: 编译该模块时所需的C/C++源文件,如果有多个文件需要用空格分离,如果想换行则需要在每个源文件末尾加上反斜杠"\" ,类似于C语言中的多行宏定义;
include ${BUILD_SHARED_LIBRARY}: 确定要构建的内容及其操作方法。BUILD_SHARED_LIBRARY  表示要编译为动态库,构建系统会生成后缀名为.so的库文件;BUILD_STATIC_LIBRARY 表示要编译为静态库,构建系统会生成后缀名为.a 的为文件。

该文件中的一些扩展的变量:

# 指定头文件所在的目录
LOCAL_C_INCLUDES := $(LOCAL_PATH) # 指定在构建动态库或可执行文件时需要链接的其它库列表,如Android系统提供的日志库,OpenGL ES, EGL等
# 每个链接的库文件都必须加上-l 前缀(注意是小写英文字母l,不是数字1)
# 多个链接的库文件使用空格分隔
LOCAL_LDLIBS += -llog -landroid -lc

3. 一个简单的Application.mk文件

APP_ABI = armeabi-v7a
APP_MODULES = hello-jni

APP_ABI:指定支持的ABI平台。上面所示为armeabi-v7a, 可选的值有all (代表全平台)、arm64-v8a、x86、x86_64,多个平台用空格隔开。
APP_MODULES:如果指定,那么NDK只会编译列出的模块列表,模块名用空格隔开,如果没有指定那么NDK会编译所有的Android.mk声明的所有的LOCAL_MODULE模块。

该文件的一些扩展的变量:

# 指定目标Android平台的名称
APP_PLATFORM = android- # 是否支持C++标准库
APP_STL := stlport_static # 为项目中的所有C++编译传递的标记
APP_CPPFLAGS := -frtti -fexceptions -std=c++

4. 多个编译模块的处理

有时候要编译的模块(UDP、FFmpeg、Openssl、libyuv)比较多,如果把所有的C/C++代码放到同一个目录下会显得比较乱,因此可以在每一个模块下都定义一个Android.mk文件,然后在jni 的根目录下放置一个Android.mk文件,内容如下:

include $(call all-subdir-makefiles)

比如:

Android: NDK中的Android.mk和Application.mk

5. 其它注意事项

1. 以LOCAL_、PRIVATE_、NDK_、APP_ 开头的名称是NDK编译系统的保留变量名称,在自定义变量时不要以以上变量名打头。如果你想在Android.mk文件中定义自己的变量,建议在名称前附加 MY_;

2. Makefile中的 := 、?=、+=、= 的区别。= 是最基本的赋值,:= 是覆盖之前的值,?= 是如果没有被赋值过就赋予等号后面的值,+= 是添加等号后面的值。

参考链接:

1. Google Developers —— NDK Android.mk说明
2. Android.mk中以LOCAL_ 打头的变量说明
3. Android 中的android.mk 和 application.mk 文件编写(总结版)
4. Makefile 中:= ?= += =的区别
5. JNI学习——关于Android.mk / Application.mk