0x00 LOCAL_PATH
根据 Android 构建系统要求,Android.mk 文档必须以 LOCAL_PATH 变量的定义开头。
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 等。
Include $(CLEAR_VARS)
这样做是因为 Android 构建系统可以在单次执行中解析多个构建文件和模式定义,LOCAL_<name> 是全局变量。清除它们可以避免冲突,每一个原生组件被称为一个模块。
0x02 LOCAL_MODULE
改变了是用来给这些模块设定一个唯一的名称。下面的代码将该模块的名称设为 hello-jni:
LOCAL_MODULE := hello-jni
因为模块名称也被用于给构建过程的所生成的文件命名,所以构建系统给文件添加适当的前缀和后缀。本例中, hello-jni 模块会生成一个共享文件且构建系统会将它命名为 libhello-jni.so。
0x03 LOCAL_SRC_FILES
该变量用来建立和组装这个模块的源文件列表。
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 片段包含了将源文件构建和组装成共享库的必要过程。
include $(BUILD_SHARED_LIBRARY)
0x05 BUILD_STATIC_LIBRARY
建立静态库,Android 应用并不直接使用静态库,一般是将第三方代码作为静态库引入动态库中使用。
include $(BUILD_STATIC_LIBRARY)
0x06 引入共享库和静态库
LOCAL_SHARED_LIBRARY := avilib_share LOCAL_STATIC_LIBRARY := avilib_static
0x07 多项目共享模块
多个项目共享某个模块时,先将源码导入%NDK_HOME%/source
,配置好对应的 Android.mk 文件。在需要的项目中添加:
LOCAL_SHARED_LIBRARIES := avilib $(call import-module, transcode/avilib)
0x08 用 Prebuilt 库
将已编译好的 so 文件作为项目的共享模块:
LOCAL_PATH := $(call my-dir) #第三方模块 include $(CLEAR_VARS) LOCAL_MODULE := avilib LOCAL_SRC_FILES := libavilib.so include $(RREBUILT_SHARED_LIBRARY)
0x09 构建可执行文件
include $(BUILD_EXECUTABLE)
0x10 其他构建系统变量
#目标 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 其他构建系统函数宏
#返回当前目录下的所有子目录下的 Android.mk 构建文件列表 include $(call all-subdir-makefiles) #放回当前 Android.mk 构建文件的路径 this-makefile #返回包含当前构建文件的父 Android.mk 构建文件路径 parent-makefile #和 parent-makefile 一样但用于祖父目录 grand-parent-makefile
0x12 定义新变量
LOCAL_ 和 NDK_ 开头的为预留构建名称,可使用 MY_ 开头的变量
MY_SRC_FILES := avilib.c platform_posix.c LOCAL_SRC_FILES := $(addprefix avilib/, $(MY_SRC_FILES))
0x13 条件操作
在每个体系结构中包含一个不同的源码文件集
ifeq ($(TARGET_ARCH), arm) LOCAL_SRC_FILES += armonly.c else LOCAL_SRC_FILES += generic.c endif
0x14 Application.mk
#覆盖 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
来源:https://www.cnblogs.com/YZFHKMS-X/p/12635667.html