android.mk文件语法

$(call function)

NDK提供的功能宏：得到function的值，它将返回文本化的信息。

my-dir

由Build System提供。返回包含Android.mk的目录路径。

all-subdir-makefiles:

返回一个列表，包含’my-dir’中所有子目录中的Android.mk。

this-makefile：

当前Makefile的路径。

parent-makefile：

返回include tree中父Makefile 路径。 也就是include 当前Makefile的Makefile Path。

import-module：

允许寻找并import其它modules到本Android.mk中来。 它会从NDK_MODULE_PATH寻找指定的模块名。
$(call import-module,)

LOCAL_PATH := $(call my-dir)

每个Android.mk文件必须以定义LOCAL_PATH为开始。它用于在开发tree中查找源文件。

include $(CLEAR_VARS)

CLEAR_VARS 变量由Build System提供。并指向一个指定的GNU Makefile，由它负责清理很多LOCAL_xxx.但不清理LOCAL_PATH.
注意：这个清理动作是必须的，因为所有的编译控制文件由同一个GNU Make解析和执行，其变量是全局的。所以清理后才能避免相互影响。

LOCAL_MODULE := hello-jni

modules名。在include $(BUILD_XXXXX)之前，必须定义这个变量。此变量必须唯一且不能有空格,通常，由此变量名决定最终生成的目标文件名。
Build System会自动添加适当的前缀和后缀。例如，foo，要产生动态库，则生成libfoo.so. 但请注意：如果模块名被定为：libfoo.则生成libfoo.so. 不再加前缀。

LOCAL_MODULE_FILENAME:

可选。用来override LOCAL_MODULE. 即允许用户重新定义最终生成的目标文件名。
LOCAL_MODULE := foo-version-1 LOCAL_MODULE_FILENAME := libfoo

LOCAL_SRC_FILES := hello-jni.c

LOCAL_SRC_FILES变量必须包含将要打包如模块的C/C++ 源码。不必列出头文件，build System 会自动帮我们找出依赖文件。
缺省的C++源码的扩展名为.cpp. 也可以修改，通过LOCAL_CPP_EXTENSION。

LOCAL_C_INCLUDES：

一个可选的path列表。相对于NDK ROOT 目录。编译时，将会把这些目录附上。
LOCAL_C_INCLUDES := sources/foo LOCAL_C_INCLUDES := $(LOCAL_PATH)/../foo

LOCAL_CPP_EXTENSION

指出C++ 扩展名。(可选) LOCAL_CPP_EXTENSION := .cxx
从NDK R7后，可以写多个： LOCAL_CPP_EXTENSION := .cxx .cpp .cc

LOCAL_CFLAGS:

一个可选的设置，在编译C/C++ source 时添加如Flags。
用来附加编译选项。 注意：不要尝试在此处修改编译的优化选项和Debug等级。它会通过您Application.mk中的信息自动指定。
也可以指定include 目录通过：LOCAL_CFLAGS += -I。 这个方法比使用LOCAL_C_INCLUDES要好。因为这样也可以被ndk-debug使用。

include $(BUILD_SHARED_LIBRARY)

BUILD_SHARED_LIBRARY：是Build System提供的一个变量，指向一个GNU Makefile Script。
它负责收集自从上次调用 include $(CLEAR_VARS) 后的所有LOCAL_XXX信息。并编译成动态库
BUILD_STATIC_LIBRARY：编译为静态库
BUILD_SHARED_LIBRARY ：编译为动态库
BUILD_EXECUTABLE：编译为Native C可执行程序

REBUILT_SHARED_LIBRARY：

把这个共享库声明为 “一个” 独立的模块。
指向一个build 脚本，用来指定一个预先编译好多动态库。 与BUILD_SHARED_LIBRARY and BUILD_STATIC_LIBRARY不同，

此时模块的LOCAL_SRC_FILES应该被指定为一个预先编译好的动态库，而非source file.

LOCAL_PATH := $(call my-dir)    
include $(CLEAR_VARS)
LOCAL_MODULE := foo-prebuilt        // 模块名
LOCAL_SRC_FILES := libfoo.so        // 模块的文件路径（相对于 LOCAL_PATH）
include $(PREBUILT_SHARED_LIBRARY)  // 注意这里不是 BUILD_SHARED_LIBRARY

这个共享库将被拷贝到

 $PROJECT/obj/local 和 $PROJECT/libs/<abi> (stripped)  

主要是用在将已经编译好的第三方库使用在本Android Project中
PREBUILT_STATIC_LIBRARY: 预先编译的静态库。 同上

LOCAL_STATIC_LIBRARIES:

要链接到本模块的静态库list。(built with BUILD_STATIC_LIBRARY)

LOCAL_SHARED_LIBRARIES:

要链接到本模块的动态库。

LOCAL_LDLIBS：

linker flags。 可以用它来添加系统库。 如 -lz:
LOCAL_LDLIBS := -lz