Android.mk 各变量的解析(根据NDK的ANDROID-MK.html文档)

Android.mk 各变量的解析(根据NDK的ANDROID-MK.html文档)

   ---------- cut here ------------------
   LOCAL_PATH := $(call my-dir)

   include $(CLEAR_VARS)

   LOCAL_MODULE    := hello-jni
   LOCAL_SRC_FILES := hello-jni.c

   include $(BUILD_SHARED_LIBRARY)
   ---------- cut here ------------------

解析这些行：

LOCAL_PATH := $(call my-dir)

一个Android.mk文件必须以变量LOCAL_PATH 开始，my-dir是一个宏方法，它用来返回Android.mk文件所在的目录，由编译系统提供。

include $(CLEAR_VARS)

变量CLEAR_VARS用来清除LOCAL_XXX变量的值(如：LOCAL_MODULE, LOCAL_SRC_FILES, LOCAL_STATIC_LIBRARIES ...),以及清除LOCAL_PATH产生的异常信息。这个是很有必要的，因为这些变量在一个单独的GNU Make的上下文为全局变量。

LOCAL_MODULE := hello-jni

变量LOCAL_MODULE在Android.mk文件中的值必须唯一，即不可有重复的值，并且不能包含空格。编译系统 将会自动的的添加合适的前缀与后缀，例如，一个分享库module取名为'foo'，它将会生成'libfoo.so'。

注意：如果你的module取名为'libfoo'，这个编译系统将不会再添加'lib'前缀，将会生成 libfoo.so

LOCAL_SRC_FILES := hello-jni.c

变量LOCAL_SRC_FILES包含一系列C/C++源文件，源文件将会被编译并组合进入同一模块，注意不不需要包含它们的头文件，因为编译系统 会自动 的找到它们依赖的头文件。

另外C++源文件的默认扩展名为 '.cpp' ,你也可以指不同的扩展名通过变量LOCAL_CPP_EXTENSION，不要忘记 '.' 符号(如 ‘.cxx’可以正常工作，而'cxx'则不能工作);

include $(BUILD_SHARED_LIBRARY)

变量 BUILD_SHARED_LIBRARY用来收集所有的定义为 LOCAL_XXX 的变量信息，从最近的 ‘include $(CLEAR_VARS)’ 开始到它自己的位置结束。这里也有变量BUILD_STATIC_LIBRARY用来生成一个静态库。

Makefile有一些保留变量名，在自定义变量时要注意：

- 变量名以 LOCAL_ 开头(如 LOCAL_MODULE)

- 变量名以 PRIVATE_ ，NDK_ 或者 APP_  (内部使用)

- 小写字母的名字 （内部使用，如 ‘my-dir’）

如果想自己定义变量推荐使用 MY_ 作为前缀。