Android.mk文件书写方法

mk文件用来告知NDK build 系统关于source的信息，本身是Makefile文件的一部分，讲被Build system解析一次或者多次。尽量少在里面什么变量，也不要假定任何东西不会被解析过程中定义。

 

1. 语法:

1. 每一个Android.mk文件必须以LOCAL_PATH为开始，用于在开发tree中查找源文件。
   LOCAL_PATH :=$(call my-dir)
   宏my-dir由Build System提供。返回包含Android.mk的目录路径
2. 第二步清理很多的LOCAL_xxx文件，是必须的。
   include $(CLEAR_VARS)
   由Build system提供CLEAR_VARS，并指向一个指定的GNU makefile。注意不会清理LOCAL_PATH，其他都会清理。清理避免全局变量相互影响
3. LOCAL_MODULE 模块是必须定义的，名字必须唯一且不包含空格，表示每一个Android.mk中的每一个模块。Build system会自动的添加后缀和前缀。
4. LOCAL_SRC_FILES变量用于包含将要大包的模块的源代码(如:C/C++代码)，不用列出头文件。Build system会自动找出依赖头文件。
5. Include $(BUILD_SHARD_LIBRARY), BUILD_SHARD_LIBRARY 是Build system的一个变量，指向GNU Makefile Script,负责收集自从上次调用include $(CLEAR_VARS)后的所有LOCAL_XXX信息，并决定编译为 什么？
   BUILD_STATIC_LIBRARY：编译为静态库
   BUILD_SHRED_LIBRARY：编译为动态库
   BUILD_EXECUTABLE：编译为Native C可执行程序
6. NDK Build System变量:

1. NDK Build system保留以下变量名:
   1. 以LOCAL_为开头的
   2. 以PRIVATE_,NDK_或者APP_开头的
   3. 小写字母名字:my-dir
   4. 如果需要定义自己的Android.mk中使用的变量名，建议添加MY_ 前缀做区分。
2. CLEAR_VARS 指向一个编译脚本，需要在新模块之前包含他
3. BUILD_SHARED_LIBRARY指向GNU Makefile Script,负责收集自从上次调用include $(CLEAR_VARS)后的所有LOCAL_XXX信息，并决定如果将所列出的Source变成成一个动态库
4. BUILD_STATIC_LIBRARY 指向GNU Makefile Script,负责收集自从上次调用include $(CLEAR_VARS)后的所有LOCAL_XXX信息，并决定如果将所列出的Source变成成一个静态库
5. BUILD_EXECUTABLE 负责收集自从上次调用include $(CLEAR_VARS)后的所有LOCAL_XXX信息，并决定如果将所列出的Source变成成一个可执行的Native程序
6. PREBUILT_SHARED_LIBRARY:把这个共享库申明为“一个”独立的模块，执行一个build脚本，用来指定一个预先编译好的动态库，它与BUILD_SHARED_LIBRARY和BUILD_STATIC_LIBRARY 不同，指定该类型的时候，LOCAL_SRC_FILES不是执行source file，而是指定为一个预先编译好的动态库。
   如下:
   LOCAL_PATCH :=$(my-dir)
   Include $(CLEAR_VARS)
   LOCAL_MODULE :=foo-prebuilt #模块名
   LOCAL_SRC_FILES := libfoo.so #模块的文件路径相对于 LOCAL_PATH
   Include $( PREBUILT_SHARED_LIBRARY)

这个共享库将被拷贝到 $PROJECT/obj/local 和 $PROJECT/libs/<abi> (stripped)  主要是用在将已经编译好的第三方库

使用在本Android Project中。为什么不直接将其COPY到libs/armabi目录呢？因为这样做缺陷很多。下一节再详细说明。

1. PREBUILT_STATIC_LIBRARY 同PREBUILT_SHARED_LIBRARY
2. TARGET_ARCH:目标CPU的架构名，如果为“arm”则声称ARM兼容的指令，与CPU架构版本无关。
3. TARGET_PLATFORM：目标平台的名字。
4. TARGET_ARCH_ABI
   Name of the target CPU+ABI 
   armeabi For ARMv5TE  armeabi-v7a
5. TARGET_ABI

1. NDK提供的功能宏

1. my-dir:$(call my-dir)：返回最近一次include的Makefile的路径。通常是返回Android.mk所在的路径。用来作为Android.mk开头定位LOCAL_PATH。
   注意：使用该宏时，如果在include其他Makefile文件之后，调用my-dir的路径就是第二次调用Android.mk的路径了。

例如: LOCAL_PATH := $(call my-dir)   ... declare one module   include $(LOCAL_PATH)/foo/Android.mk   LOCAL_PATH := $(call my-dir)   ... declare another module

则第二次返回的LOCAL_PATH　为：$PATH/foo。 而非$PATH.

 

1. all-subdir-makefiles： 返回一个列表，包含my-dir中的所有子目录中的Android.mk
2. this-makefile：当前Makefile的路径
3. parent-makefile:返回include tree中父Makefile路径。
4. import-module：允许寻找并inport其他modules到本Android.mk中来，它会从NDK_MODULE_PATH寻找到指定的模块名。

$(call import-module,<name>)

1. 模块描述变量

1. LOCAL_PATH:用来给定当前目录，在Android.mk的开头定义。
2. LOCAL_MODULE:module名，在include $(BUILD_XXXX)之前，必须定义，且唯一不能有空格。
3. LOCAL_MODULE_FILENAME:可选，用来overrid LOCAL_MODULE.即允许用户重新定义最终生成的目标文件名。

LOCAL_MODULE := foo-version-1  LOCAL_MODULE_FILENAME := libfoo

1. LOCAL_SRC_FILES:为build modules提供source文件列表。文件相对于LOCAL_PATH存放，提供相对路径
2. LOCAL_CPP_EXTENSION:指出C++扩展名

例:

LOCAL_CPP_EXTENSION := .cxx 从NDK R7后，可以写多个：  

LOCAL_CPP_EXTENSION := .cxx .cpp .cc

 

1. LOCAL_CPP_FEATURES：指定C++ features

例:

LOCAL_CPP_FEATURES := rtti  

LOCAL_CPP_FEATURES := exceptions

1. LOCAL_C_INCLUDES：一个可选的path列表，相对于NDE ROOT目录。编译时，将会把些目录附上

例:

LOCAL_C_INCLUDES := sources/foo  LOCAL_C_INCLUDES := $(LOCAL_PATH)/../foo

 

1. LOCAL_CFLAGS:一个可选的设置，在编译C/C++ source时添加如FLAGS。用来附加编译选项，注意:不要在此处修改编译的优化选项和Debug等级。它会通过application.mk这种的信息自动指定。

也可以指定include 目录通过：LOCAL_CFLAGS += -I<path>。 这个方法比使用LOCAL_C_INCLUDES要好。因为这样也可以被ndk-debug使用

 

1. LOCAL_CPPFLAGS：C++ Source编译时添加的C Flags。这些Flags将出现在LOCAL_CFLAGS flags的后面。
2. LOCAL_CXXFLAGS，为LOCAL_CPPFLAGS的别名
3. LOCAL_STATIC_LIBRARIES:要链接模块的静态库list
4. LOCAL_SHARED_LIBRARIES:要链接到本模块的动态库
5. LOCAL_WHOLE_STATIC_LIBRARIES:静态库全链接
6. LOCAL_LDLIBS：linker flags，可以用他来添加系统库。
7. LOCAL_ALLOW_UNDEFINED_SYMBOLS:
8. LOCAL_ARM_MODE：缺省模式下，ARM目标嗲吗被编译为thumb模式，每一个指令16位，如果指定此变量为arm，则指令为32位，
   LOCAL_ARM_MODE :=arm 其实也可以指定一个或者某几个文件的ARM指令模式。
9. LOCAL_ARM_NEON:设置为true时，会将浮点编译成neon指令，会极大地加快浮点运算(需要硬件支撑)，另需要设置targeting为‘armeabi-v7a’时才可以
10. LOCAL_DISABLE_NO_EXECUTE
11. LOCAL_EXPORT_CFLAGS:定义这个变量用例记录C/C++编译器标志集合，并且会被添加到其他任何以LOCAL_STATIC_LIBRARIES和LOCAL_SHARED_LIBRARIES的模块的LOCAL_CFLAGS定义中。

注意:该是以NDK的版本为NDK R7C为例，其他版本可能有差异。

摘自: https://www.cnblogs.com/wainiwann/p/3837936.html