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)