一、一个简单的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,
:获取指定目录下的所有 Java 文件。
<src>)$(call all-c-files-under,
:获取指定目录下的所有 C 语言文件。
<src>)$(call all-Iaidl-files-under,
:获取指定目录下的所有 AIDL 文件。
<src>)$(call all-makefiles-under,
:获取指定目录下的所有 Make 文件。
<folder>)$(call intermediates-dir-for,
:获取 Build 输出的目标文件夹路径。
<class>, <app_name>, <host or target>, <common?> )
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变量必须包含将要编译打包进模块中的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)