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)

二、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所在的目录路径,相对于NDK编译系统的顶层。这是有用的,在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

这项功能用于向编译系统提供深层次嵌套的代码目录层次。注意,在默认情况下,NDK将会只搜索在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_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变量必须包含将要编译打包进模块中的CC++源代码文件。注意,你不用在这里列出头文件和包含文件,因为编译系统将会自动为你找出依赖型的文件;仅仅列出直接传递给编译器的源代码文件就好。
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_PATHLOCAL_UNSTRIPPED_PATH来指定。不同的文件系统路径用以下的宏进行选择:
  • TARGET_ROOT_OUT:表示根文件系统。
  • TARGET_OUT:表示system文件系统。
  • TARGET_OUT_DATA:表示data文件系统。

用法如:

    LOCAL_MODULE_PATH:=$(TARGET_ROOT_OUT)


郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。