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_ 作为前缀。