Android.mk具体解释

概述

    Android.mk文件用来向编译系统描写叙述怎样编译你的源码。更确切地说，该文件事实上就是一个小型的Makefile。由于该文件会被NDK的编译工具解析多次，因此应该尽量降低源码中声明变量，由于这些变量可能会被多次定义从而影响到后面的解析。这个文件的语法同意把源码组织成模块。每一个模块属于下列类型之中的一个：

• APK程序：一般的Android程序。编译打包生成apk文件。

• JAVA库：java类库。编译打包生成jar包文件。
• C\C++应用程序：可运行的C/C++应用程序。
• C\C++静态库：编译生产C/C++静态库。并打包成.a文件。
• C\C++共享库：编译生成共享库。并打包成.so文件，有且仅仅有共享库才干被安装/拷贝到APK包中。

举例

    这里參考了网上一个通用的样例，编译简单的“Hello World”，来说明一下Android.mk编写。比如以下的文件：

1. sources/test/hello.c

2. sources/test/Android.mk

    当中“hello.c”是一个JNI共享库。实现返回“hello world”字符串的原生方法。

因此，Android.mk文件内容例如以下：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := hello
LOCAL_SRC_FILES := hello.c
include $(BUILD_SHARED_LIBRARY)

解释一下这几行代码：

1. LOCAL_PATH := $(call my-dir) ： 一个Android.mk文件首先必须定义好LOCAL_PATH变量，用于在开发树中查找源文件。

在这个样例中，宏函数my-dir由编译系统提供，用于返回当前路径（即包括Android.mk文件的文件夹）。

2. include $(CLEAR_VARS)：CLEAR_VARS由编译i系统提供，指定让GNU MAKEFILE清除除了LOCAL_PATH变量外的很多LOCAL_***变量（比如：LOCAL_MODULE、LOCAL_SRC_FILES等）。

这是很有必要的。由于全部的编译文件都在同一个GUN MKAE运行环境中，全部的变量都是全局变量。不清除easy引起解析错误。

3. LOCAL_MODULE := hello：LOCAL_MODULE变量必须定义，用来标识在Android.mk文件描写叙述的每个模块。并且名称必须是唯一的。并且不能包括空格。编译系统会自己主动产生合适的前缀和后缀，比方一个被命名为hello的共享库模块。将会生成libhello.so文件。假设把库命名为libhello。编译系统将不会加入不论什么lib前缀，也会生成libhello.so文件。

4. LOCAL_SRC_FILES := hello.c：LOCAL_SRC_FILES变量必须包括将要编译打包进模块中的源码文件。

5. include $(BUILD_SHARED_LIBRARY)：BUILD_SHARED_LIBRARY是编译系统提供的变量，指向一个GNU Makefile脚本（应该就是build/core文件夹下的shared_library.mk）,负责收集自从上次调用include $(CLEAR_VARS)以来，定义在LOCAL_***变量中的全部信息。而且决定编译什么，怎样正确地去做，并依据其规则生成静态库。

6. 解释一下Android.mk里变量定义字符":="。“:=”类似于c中的宏，即在定义处明白展开。全然进行文本替换。

模块描写叙述变量

     以下的变量用于向系统描写叙述我们自己的模块，它应该定义在include $(CLEAR_VARS)和include $(BUILD_***)之间。正如前面讲述的那样，$(CLEAR_VARS)是一个脚本，清除全部这些变量，除非在描写叙述中显示注明。

1. LOCAL_PATH：这个变量用于给出当前文件的路径。必须在Android.mk的开头定义。能够这样使用：LOCAL_PATH := $(call my-dir)。这样这个变量不会被$(CLEAR_VARS)清除。由于每一个Android.mk仅仅须要定义一次（即使一个文件里定义了多个模块的情况下）。

2. LOCAL_SRC_FILES：当前模块包括的全部源码文件。

3. LOCAL_MODULE：当前模块的名称，这个名称应当是唯一的。而且不能包括空格。模块间的依赖关系就是通过这个名称来引用的。

4. LOCAL_MODULE_CLASS：标识所编译模块最后放置的位置。

ETC表示放置在/system/etc.文件夹下。APPS表示放置在/system/app文件夹下，SHARED_LIBRARIES表示放置在/system/lib文件夹下。假设详细指定，则编译的模块不会放到编译系统中。最后会在out相应product的obj文件夹下的相应文件夹中。

5. LOCAL_SRC_FILES：这是要编译的源码文件列表。仅仅要列出要传递给编译器的文件就可以。编译系统会自己主动计算依赖关系。源码文件路径都是相相对于LOCAL_PATH的。因此能够使用相对路径进行描写叙述。

6. LOCAL_JAVA_LIBRARIES：当前模块依赖的Java共享库，也叫Java动态库。

比如framework.jar包。

7. LOCAL_STATIC_JAVA_LIBRARIES：当前模块依赖的Java静态库，在Android里。导入的jar包和引用的第三方project都属于Java静态库。

8. LOCAL_STATIC_LIBRARIES：当前模块在执行时依赖的静态库的名称。

9. LOCAL_SHARED_LIBRARIES：当前模块在执行时依赖的动态库的名称。

10. LOCAL_C_INCLUDES：c或c++语言须要的头文件的路径。

11. LOCAL_CFLAGS：提供给C/C++编译器的额外编译參数。

12. LOCAL_PACKAGE_NAME：当前APK应用的名称。

13. LOCAL_CERTIFICATE：签署当前应用的证书名称。

14. LOCAL_MODULE_TAGS：当前模块所包括的标签，一个模块能够包括多个标签。标签的值可能是eng、user、debug、development、optional。当中，optional是默认标签。

15. LOCAL_DEX_PREOPT：apk的odex优化开关，默认是false。

    除此之外。Build系统中还定义了一些函数方便在Android.mk中使用。包含：

1. $(call my-dir)：获取当前目录的路径。

2. $(call all-java-files-under, <src>)：获取指定文件夹下的全部java文件。

3. $(call all-c-files-under, <src>)：获取指定文件夹下的全部c文件。

4. $(call all-Iaidl-files-under, <src>)：获取指定文件夹下的全部AIDL文件。

5. $(call all-makefiles-under, <folder>)：获取指定文件夹下的全部Make文件。

6. $(call intermediates-dir-for, <class>, <app_name>, <host or target>, <common?>)：获取Build输入的目标目录路径。