本文档是关于Android.mk文件语法和写法的总结，主要包括变量，函数的使用
LOCAL_PATH := $(call my-dir) # my-dir是由编译系统提供的宏函数，用于返回Android.mk所在路径
include $(CLEAR_VARS) # CLEAR_VARS是编译系统预定义变量，指向一个特殊的Makefile，这个Makefile用于清除LOCAL_XXX变量
# 的定义（除了LOCAL_PATH），以防止不同模块编译中同名变量的影响
LOCAL_MODULE := hello-jni # 定义模块名字，编译后自动驾驶前缀和后缀，如libhello-jni.so
LOCAL_SRC_FILES := hello-jni.c # 定义源码文件集合
include $(BUILD_SHARED_LIBRARY) # BUILD_SHARED_LIBRARY预定义的变量，指向一个Makefile，编译后得到一个动态库
# 如果要编译成静态库，则可以换成BUILD_STATIC_LIBRARY
不能用小写字母命名变量，不能用LOCAL_, PRIVATE_, NDK_, APP_开头命名变量
指向一个已编译好的共享库，次数LOCAL_SRC_FILES不再指向源文件，而是指向这个预编译共享库文件如，libfoo.so.可以在其他模块中，
通过使用LOCAL_PREBUILDS变量来引用这个预编译模块，具体用法可以参考：
预编译
与PREBUILT_SHARED_LIBRARY相同，只不过这里是静态库
目标CPU架构的名字
目标Android平台的名字, 具体参考Stable APIs
目标CPU和ABI组合的名字，目前只有2个值可以用：armeabi(ARMv5TE), armeabi-v7a
目标平台和ABI的组合，定义为
这个变量表示当前文件（一般是Android.mk）所在的路径，该变量很重要，必须定义
LOCAL_PATH := $(call my-dir)
该变量定义当前模块的名字，名字必须唯一，不能有空格
该变量可以用来重定义输出文件的名字, 当定义了LOCAL_MODULE_FILENAME之后，输出文件名就是这个变量指定的名字
该变量用来指定该模块对应的源文件
用来定义C++代码文件的扩展名
LOCAL_CPP_EXTENSION := .cxx
该变量用来指定C++代码所依赖的特殊C++特性
LOCAL_CPP_FEATURES := rtti #告诉编译器C++代码使用了RTTI（RunTime Type Information）
LOCAL_CPP_FEATURES := exceptions #指定C++代码使用了C++异常
一个路径的列表，当编译C/C++、汇编文件时，这些路径将被追加到头文件搜索路径列表中
指定当编译C/C++源码的时候，传给编译器的标志
编译C++代码的时候传递给编译器的选项（编译C代码不会用这里的选项）
指定应该链接到当前模块的静态库（可指定多个）。当前模块是动态库时，该选项才有意义
指定的是运行时该模块所依赖共享库（可指定多个）。这些信息是链接阶段必须的。
它是LOCAL_STATIC_LIBRARIES的变体，用来表示它对应的模块对于linker来说应该是一个“whole archive”. 当静态库之间有循环依赖时，会用到这个选项
用来指定模块编译时的其余连接器标志
LOCAL_LDLIBS := -lz #告诉链接器在加载该共享库的时候必须链接 /system/lib/libz.so 这个共享库
常用的链接库可以查看这里Stable APIs
这个变量定义一些C/C++编译器flags。这些flags（标志）会被追加到使用了这个模块
LOCAL_EXPORT_CFLAGS := -DFOO=1 #编译foo模块时声明了此变量
LOCAL_CFLAGS := -DBAR=2 #编译bar模块时声明了此变量
LOCAL_STATIC_LIBRARIES := foo #依赖foo模块，这样编译bar模块时传递给编译器的标志就是“-DFOO=1 -DBAR=2”
下面是NDK预定义的“函数”宏，用法是 $(call ) ，返回的是文本信息
返回当前的my-dir目录下的所有子目录的Android.mk文件的列表
返回当前的Makefile的路径（即该函数调用时的位置）
如果当前这个Makefile被另一个Makefile包含，则返回那个包含了自己的Makefile的路径（即parent）
...
该函数用于按模块名查找另一个模块的Android.mk文件，并包含进来
$(call import-module,<name>) #在 NDK_MODULE_PATH变量所指定的目录列表中寻找名为<name>的模块，找到之后将包含进来
通过预编译，可以使用一个提前编译好的库（预编译库）来加速编译过程，或者向第三方NDK开发人员发布你的共享库而不用提供源码
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := foo-prebuilt
LOCAL_SRC_FILES := libfoo.so
include $(PREBUILT_SHARED_LIBRARY) #如果你的库是共享库，则包含 PREBUILT_SHARED_LIBRARY;如果是静态库，则包含 PREBUILT_STATIC_LIBRARY
include $(CLEAR_VARS)
LOCAL_MODULE := foo-user
LOCAL_SRC_FILES := foo-user.c
LOCAL_SHARED_LIBRARIES := foo-prebuilt
include $(BUILD_SHARED_LIBRARY)
include $(CLEAR_VARS)
LOCAL_MODULE := foo-prebuilt
LOCAL_SRC_FILES := libfoo.so
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/include
include $(PREBUILT_SHARED_LIBRARY)
LOCAL_LDLIBS := -lXXX #XXX标识链接库名
| 库名称 | 符号 | 特性 |
|---|---|---|
| C库 | 不需要指定 | |
| 数学库 | -lm | 不需要指定 |
| C++库 | -lstdc++等 | 不需要指定 |
| android log | -llog | 包含<android/log.h>，使用Android log |
| zlib | -lz | 包含<zlib.h> 和 <zconf.h> |
| 动态链接器 | -ldl | 包含<dlfcn.h>,提供dlopen,dlsym等函数 |
| OpenGL ES 1.x 库 | -lGLESv1_CM.so | 包含 <GLES/gl.h> 和 <GLES/glext.h> |
| OpenGL ES 2.0 | -lGLESv2.so | 包含<GLES2/gl2.h> 和 <GLES2/gl2ext.h> |
| jnigraphics | -ljnigraphics | 提供对Java中的 bitmap 对象的操作 |
| OpenSL ES音频库 | -lOpenSLES | |
| 本地android | -landroid | 用C/C++来写android程序 |