Android.mk是Android工程管理文件,类似于编译文件的说明书,用来向编译系统描述源代码,并将源文件分组为模块(包括静态库、共享库、独立可执行文件)。Android.mk会被编译系统解析一次或多次,可以在每一个Android.mk文件中定义一个或多个模块,也可以多个模块使用同一个 .mk 文件。
#源文件在开发树中的位置
LOCAL_PATH := $(call my-dir)
#清除LOCAL_PATH变量之外的LOCAL_XXX变量
include $(CLEAR_VARS)
#需要编译的文件
LOCAL_SRC_FILES :=$(call all-subdir-java-files)
#生成的模块名称
LOCAL_MODULE := TestMK
#编译的标签
LOCAL_MODULE_TAGS := optional
#指定签名
LOCAL_CERTIFICATE := platform
#引用静态jar
LOCAL_STATIC_JAVA_LIBRARIES := jar1 jar2
#编译apk
include $(BUILD_PACKAGE)
#需要进行预编译的库
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := jar1:path1 \
jar2:path2
include $(BUILD_MULTI_PREBUILT)
LOCAL_PATH := $(call my-dir)
LOCAL_PATH 是表示当前模块位置的变量,my-dir 是由系统提供的宏函数,返回当前文件所在的路径,$(call my-dir) 表示调用这个函数。
include $(CLEAR_VARS)
这句代码清除了 LOCAL_PATH 变量之外的 LOCAL_XXX 变量。所有的编译控制文件都在同一个GNU MAKE执行环境中,所有的变量都是全局的,在编译该模块之前可能编译过别的模块,产生了大量变量,会被系统误认为是属于该模块的,可能产生不可预知的错误。
LOCAL_SRC_FILES :=$(call all-subdir-java-files)
LOCAL_SRC_FILES 变量代表需要编译的文件,all-subdir-java-files 函数返回LOCAL_PATH 子目录的所有java文件。也可以直接写出需要编译的文件路径:
LOCAL_SRC_FILES :=src/com/example/test/MainActivity.java \
src/com/example/test/Demo1.java \
src/com/example/test/Demo2.java
但要注意,在文件最后面加上以下语句,指明 LOCAL_PATH 目录。
include $ (call all-makefiles-under,$(LOCAL_PATH))
或者在每个文件路径下都加上 LOCAL_PATH :
LOCAL_SRC_FILES :=$(LOCAL_PATH)/src/com/example/test/MainActivity.java \
$(LOCAL_PATH)/src/com/example/test/Demo1.java \
$(LOCAL_PATH) /src/com/example/test/Demo2.java
几个常用的获取源文件的方法:
$(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 文件。
LOCAL_MODULE := TestMK
LOCAL_MODULE 变量必须定义且唯一,作为模块的标识,编译系统会自动产生合适的前缀和后缀。
LOCAL_MODULE_TAGS := optional
常用的有:debug, eng, user,development 或者 optional(默认)。
LOCAL_CERTIFICATE := platform
常用的有:
platform:该 APK 完成一些系统的核心功能。经过对系统中存在的文件夹的访问测试。
shared:该APK需要和 home/contacts 进程共享数据。
media:该APK是 media/download 系统中的一环。
LOCAL_STATIC_JAVA_LIBRARIES := jar1 jar2
jar1、jar2 是第三方 Java 包的别名,需要定义,见后文。
LOCAL_JAVA_LIBRARIES 用于引用动态jar。
include $(BUILD_PACKAGE)
include $(BUILD_STATIC_LIBRARY)
:编译成静态库
include $(BUILD_SHARED_LIBRARY)
:编译成动态库
include $(BUILD_EXECUTABLE)
:编译成可执行程序
include $(BUILD_STATIC_JAVA_LIBRARY)
:编译成Java静态库
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := jar1:path1 \
jar2:path2
jar1、jar2 定义静态库别名,path1、path2 是静态库的路径,注意要一直写到后缀 .jar.。
include $(BUILD_MULTI_PREBUILT)
将 prebuild 定义的库拷到本地进行编译。
通过 LOCAL_MODULE_PATH 变量,可以指定生成的 apk 目录:
LOCAL_MODULE_PATH := $(TARGET_OUT)/
$(TARGET_OUT)
代表 /system ,后续路劲按需要补充完整
$(TARGET_OUT_DATA_APPS)
代表 data/app 目录
菜鸟一枚,错误之处,还望大佬们指正,感激不尽。
主要参考博文:
Android mk 引用 jar 包、so 库、aar 包,系统签名
Android.mk入门
Android.mk文件学习,将工程编译到系统中(实践篇)