Android.mk文件解析



一、一个简单的Android.mk文件如下：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := native-interface
LOCAL_SRC_FILES := video.c \
     adpcm.c \
     audio.c \
     sip.c \
     network.c \
     circular_queue.c \
     native_interface.c
LOCAL_SHARED_LIBRARIES := libosip \
        libexosip \
        libavcodec \
        libavutil \
        libswscale
# LOCAL_SHARED_LIBRARIES := libavcodec \
        # libavutil \
        # libswscale
#需要链接的系统默认库
LOCAL_LDLIBS += -llog
LOCAL_LDLIBS += -lOpenSLES
LOCAL_LDLIBS += -landroid
include $(BUILD_SHARED_LIBRARY)
#添加外部导入库目录
$(call import-add-path, $(LOCAL_PATH))
#添加到入库
$(call import-module, libffmpeg)
$(call import-module, libosip)
$(call import-module, libexosip)</span></span>

二、Android.mk文件作用

    Android.mk文件是针对Android的Makefile文件.具体来说：该文件是GNU Makefile的一小部分，会被编译系统解析一次或多次。

你可以在每一个Android.mk file中定义一个或多个模块，你也可以在几个模块中使用同一个源代码文件。编译系统为你处理许多细节问题。

三、解析：

    每一个编译模块都是由include $(CLEAR_VARS)开始，到include $(BUILD_SHARED_LIBRARY)结束

1、include可以理解为执行

2、LOCAL_PATH:= $(call my-dir) 设置LOCAL_PATH变量；my-dir为宏函数，由编译系统提供

类似的函数有：

• $(call my-dir)：获取当前文件夹路径。
• $(call all-java-files-under, <src>)：获取指定目录下的所有 Java 文件。
• $(call all-c-files-under, <src>)：获取指定目录下的所有 C 语言文件。
• $(call all-Iaidl-files-under, <src>) ：获取指定目录下的所有 AIDL 文件。
• $(call all-makefiles-under, <folder>)：获取指定目录下的所有 Make 文件。
• $(call intermediates-dir-for, <class>, <app_name>, <host or target>, <common?> )：获取 Build 输出的目标文件夹路径。

3、$(call <function>)

    GNU Make‘功能’宏，必须通过使用'$(call <function>)'来求值，他们返回文本化的信息。

    1）my-dir

     返回当前Android.mk所在的目录路径，相对于ＮＤＫ编译系统的顶层。这是有用的，在Android.mk文件的开头如此定义：

     LOCAL_PATH := $(call my-dir) 

    2）all-subdir-makefiles

     返回一个位于当前'my-dir'路径的子目录列表。例如，看下面的目录层次：

    sources/foo/Android.mk

    sources/foo/lib1/Android.mk

    sources/foo/lib2/Android.mk

    如果sources/foo/Android.mk包含一行：

    include $(call all-subdir-makefiles)

    那么它就会自动包含sources/foo/lib1/Android.mk 和sources/foo/lib2/Android.mk

这项功能用于向编译系统提供深层次嵌套的代码目录层次。注意，在默认情况下，ＮＤＫ将会只搜索在sources/*/Android.mk中的文件。 

    3）this-makefile

    返回当前Makefile的路径（即这个函数调用的地方）

    4）parent-makefile

     返回调用树中父Makefile路径。即包含当前Makefile的Makefile路径。

    5）grand-parent-makefile

4、include $(CLEAR_VARS)

     CLEAR_VARS定义在/build/core/clear_vars.mk中，用以清除许多LOCAL变量。因为这些变量往往都是全局的，故需要对其进行清除；

而其通常也被认为是一个便以模块的开始标志。

5、一些重要变量设置

• LOCAL_SRC_FILES               ：当前模块包含的所有源代码文件。
• LOCAL_MODULE                 ：当前模块的名称，这个名称应当是唯一的，模块间的依赖关系就是通过这个名称来引用的。
• LOCAL_C_INCLUDES           ：C 或 C++ 语言需要的头文件的路径。
• LOCAL_STATIC_LIBRARIES  ：当前模块在静态链接时需要的库的名称。
• LOCAL_SHARED_LIBRARIES：当前模块在运行时依赖的动态库的名称。
• LOCAL_CFLAGS                   ：提供给 C/C++ 编译器的额外编译参数。
  （LOCAL_CFLAGS-D                                  增加全局宏定义。
     LOCAL_CFLAGS := -DUSE_JSC                相当于在所有源文件中增加一个#define USE_JSC
     LOCAL_CFLAGS := -DUSE_COPY_BIT=1 相当于在所有源文件中增加一个#define USE_COPY_BIT 1）
• LOCAL_JAVA_LIBRARIES     ：当前模块依赖的 Java 共享库。
• LOCAL_STATIC_JAVA_LIBRARIES：当前模块依赖的 Java 静态库。
• LOCAL_PACKAGE_NAME    ：当前 APK 应用的名称。
• LOCAL_CERTIFICATE           ：签署当前应用的证书名称。
• LOCAL_MODULE_TAGS      ：当前模块所包含的标签，一个模块可以包含多个标签。标签的值可能是 debug, eng, user，development 或者 optional。其中，optional 是默认标签。标签是提供给编译类型使用的。不同的编译类型会安装包含不同标签的模块，关于编译类型的说明如表 7 所示：

6、LOCAL_SRC_FILES 

     LOCAL_SRC_FILES变量必须包含将要编译打包进模块中的C或C++源代码文件。注意，你不用在这里列出头文件和包含文件，因为编译系统将会自动为你找出依赖型的文件；仅仅列出直接传递给编译器的源代码文件就好。

7、include $(BUILD_SHARED_LIBRARY)表示该编译模块希望生成的文件状态。

     BUILD_SHARED_LIBRARY是编译系统提供的变量，指向一个GNU Makefile脚本（应该就是在build/core目录下的shared_library.mk），负责收集自从上次调用'include $(CLEAR_VARS)'以来，定义在LOCAL_XXX变量中的所有信息，并且决定编译什么，如何正确地去做。并根据其规则生成静态库。

    类似的BUILD_XXX变量还有：

• BUILD_SHARED_LIBRARY
• BUILD_STATIC_LIBRARY
  
• BUILD_EXECUTABLE
• BUILD_PACKAGE
• BUILD_JAVA_LIBRARY等

8、另外在Android.mk文件中，还可以指定最后的目标安装路径，用LOCAL_MODULE_PATH和LOCAL_UNSTRIPPED_PATH来指定。不同的文件系统路径用以下的宏进行选择：

• TARGET_ROOT_OUT：表示根文件系统。
• TARGET_OUT：表示system文件系统。
  
• TARGET_OUT_DATA：表示data文件系统。
  

用法如：

    LOCAL_MODULE_PATH:=$(TARGET_ROOT_OUT)