Android系统build/core下.mk文件分析

网上整理加上自己理解的

 

Android编译系统的架构：

         分析Android编译系统，你会发现，Android编译系统完成的并不仅仅是对目标（主机）系统二进制文件、java应用程序的编译、链接、打包等，而且还有包括生成各种依赖关系、确保某个模块的修改引起相依赖的文件的重新编译链接，甚至还包括目标文件系统的生成，配置文件的生成等，因此Android编译系统具有支持多架构（linux-x86、windows、arm等）、多语言（汇编、C、C++、Java等）、多目标、多编译方式。这些目标和结构决定其架构也很重要。

         Android编译系统集中于build/core下，几个很重要的*.mk文件如下：

         main.mk(主控Makefile)

         base_rules.mk(对一些Makefile的变量规则化)

         config.mk（关于编译参数、编译命令的一些配置）

         definations.mk（定义了很多编译系统中用到的宏，相当于函数库）

         Makefile（这个Makefile特指build/core下的Makefile，此文件主要控制生成system.img,ramdisk.img,userdata.img,以及recorvery image，sdk等）

         Binary.mk(控制如何生成目标文件)

         Clear_vars.mk（清除编译系统中用到的临时变量）

         Combo/linux-arm.mk(控制如何生成linux-arm二进制文件，包括ARM相关的编译器，编译参数等的设置)

         Copy_headers.mk（将头文件拷贝到指定目录）

         分散于各个目录下的Android.mk(控制生成局部模块的源码，名称所需头文件路径，依赖库等特殊选项)

         Build/envsetup.mk(编译环境初始化，定义一些实用的shell函数，方便编译使用)

 

         以上几个主要的文件，可以按照社会分工打一个比方：

 

         Main.mk是总统，是老大，承担了很多工作。

         Makefile是副总统，辅佐老大Main.mk

         Base_rules.mk是交警，让不规则的东西，变得规则。

         Config.mk是省长，规定了各个人民群众该如何行事

         Definations.mk是图书馆管理员

         Binary.mk应该属于村长了，规定每个人该如何行事

         Clear_vars.mk应该属于保洁公司的工人吧

         Combo/linux-arm.mk应该属于社会公民了，他决定自己该如何去做

Android的make脚本的内容

文档简要整理Android的make脚本的内容。以供备忘和参考。

1.    Build Layers

Build Layers描述的是产品的硬件配置情况，据此make时选择不同的配置和模块。按照从上到下的顺序，Build Layer分成4层。
Layer    sample    Note
Arch    arm, x86    处理器的种类
Board    －    板子类型的代号
Device    －    device配置的类型代号
Product    －    具体产品的代号

2.    添加应用

2.1 一个例子

以calculator为例，app代码可以放到packages/apps/目录下边，一个app对应一个目录，此例，pakcages/apps/Calculator/。Android.mk，已去除多余的注释行。

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS := optional
LOCAL_STATIC_JAVA_LIBRARIES := libarity
LOCAL_SRC_FILES := $(call all-java-files-under, src)
LOCAL_SDK_VERSION := current
LOCAL_PACKAGE_NAME := Calculator
include $(BUILD_PACKAGE)
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := libarity:arity-2.1.2.jar
include $(BUILD_MULTI_PREBUILT)
# Use the folloing include to make our test apk.
include $(call all-makefiles-under,$(LOCAL_PATH))

至少有一个子目录，src下放源码。

Android.mk中需要赋值的几个LOCAL_XXX变量，
LOCAL_PATH，调用my-dir（在defination.mk中定义），得到当前路径，即，<yourSrcPath>/ pakcages/apps/Calculator/。
LOCAL_MODULE_TAGS，取值范围debug eng tests optional samples shell_ash shell_mksh。注意不能取值user，如果要预装，则应定义core.mk。
LOCAL_SRC_FILES，app的所有源码，如果是java源码的话，可以调用all-java-files-under得到。
LOCAL_PACKAGE_NAME，package的名字，这个名字在脚本中将标识这个app或package。
$(CLEAR_VARS)指的是clear_vars.mk，脚本会清空所有LOCAL_xxx的变量，不影响后面这些变量的使用。

$(BUILD_PACKAGE)指的是package.mk

最后一句all-makefiles-under将会 包含 当前目录下 所有的mk脚本 文件。

2.2 LOCAL_XXX的列表相关简绍

说明：
    必须定义, 在app或package的Android.mk中必须给定值。
    可选定义，在app或package的Android.mk中可以也可以不给定值。
    不用定义，在app或package的Android.mk中不要给定值，脚本自动指定值。

LOCAL_PATH，            当前路径，必须定义。
LOCAL_PACKAGE_NAME，    必须定义，package的名字，这个名字在脚本中将标识app或package。
LOCAL_MODULE_SUFFIX，    不用定义，module的后缀，=.apk。
LOCAL_MODULE，            不用定义，=$(LOCAL_PACKAGE_NAME)。
LOCAL_JAVA_RESOURCE_DIRS，    不用定义。
LOCAL_JAVA_RESOURCE_FILES，    不用定义。
LOCAL_MODULE_CLASS，    不用定义。
LOCAL_MODULE_TAGS，        可选定义。默认optional。取值范围user debug eng tests optional samples shell_ash shell_mksh。
LOCAL_ASSET_DIR，    可选定义，推荐不定义。默认$(LOCAL_PATH)/assets
LOCAL_RESOURCE_DIR，    可选定义，推荐不定义。默认product package和device package相应的res路径和$(LOCAL_PATH)/res。
LOCAL_PROGUARD_ENABLED，    可选定义，默认为full，如果是user或userdebug。取值full, disabled, custom。
full_android_manifest，        不用定义，=$(LOCAL_PATH)/AndroidManifest.xml。
LOCAL_EXPORT_PACKAGE_RESOURCES，    可选定义，默认null。如果允许app的资源被其它模块使用，则设置true。
LOCAL_CERTIFICATE，    可选定义，默认为testkey。最终
        private_key := $(LOCAL_CERTIFICATE).pk8
        certificate := $(LOCAL_CERTIFICATE).x509.pem

2.3 mm创建apk时的package.mk中变量分析

以Calculator为例，
由LOCAL_PATH，LOCAL_PACKAGE_NAME导出变量LOCAL_MODULE，all_assets，all_resources。
设置LOCAL_MODULE_CLASS=APPS，此值local-intermediates-dir会用到。
设置中间生成目录路径，中间路径将放置R.stamp文件。
package_expected_intermediates_COMMON := $(call local-intermediates-dir,COMMON)
这里COMMON是null，而LOCAL_MODULE_CLASS=APPS，所以
package_expected_intermediates_COMMON=out/target/common/obj/$(LOCAL_MODULE_CLASS)/$(LOCAL_MODULE)_intermediates
即
package_expected_intermediates_COMMON=out/target/common/obj/APPS/Calculator_intermediates

设置
LOCAL_BUILT_MODULE_STEM := package.apk
而
LOCAL_BUILT_MODULE := $(built_module_path)/$(LOCAL_BUILT_MODULE_STEM)    @base_rules.mk
built_module_path := $(intermediates)        @base_rules.mk
intermediates := $(call local-intermediates-dir)    @java.mk
最终
LOCAL_BUILT_MODULE=out/target/product/<PRODUCT>/obj/$(LOCAL_MODULE_CLASS)/$(LOCAL_MODULE)_intermediates/$(LOCAL_BUILT_MODULE_STEM)
即
LOCAL_BUILT_MODULE=out/target/product/generic/obj/APPS/Calculator_intermediates/package.apk

由LOCAL_CERTIFICATE导出
private_key := $(SRC_TARGET_DIR)/product/security/$(LOCAL_CERTIFICATE).pk8
certificate := $(SRC_TARGET_DIR)/product/security/$(LOCAL_CERTIFICATE).x509.pem
LOCAL_CERTIFICATE默认为testkey。

2.4 package.mk中定义的几个PACKAGE.xxx变量

PACKAGES.$(LOCAL_PACKAGE_NAME).PRIVATE_KEY := $(private_key)
PACKAGES.$(LOCAL_PACKAGE_NAME).CERTIFICATE := $(certificate)
PACKAGES.$(LOCAL_PACKAGE_NAME).OVERRIDES := $(strip $(LOCAL_OVERRIDES_PACKAGES))
PACKAGES.$(LOCAL_PACKAGE_NAME).RESOURCE_FILES := $(all_resources)

PACKAGES := $(PACKAGES) $(LOCAL_PACKAGE_NAME)
全编译时，PACKAGES变量将会记录遍历到的packages。

build/core下.mk文件分析

https://blog.csdn.net/wh_19910525/article/details/7519919