全面深入分析Android.mk (build/core/*.mk脚本)

Home / Android MrLee 2015-3-25 5505

特此整理文档供日后用
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中定义),得到当前路径,即,/ 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//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。

==================== 1.    java.mk分析
选取APPS场景,以Calculator为例说明。 LOCAL_JAVA_LIBRARIES=true时,Android.mk中不能定义LOCAL_SDK_VERSION。 当LOCAL_SDK_VERSION=current时,LOCAL_JAVA_LIBRARIES=android_stubs_current。
package.mk中定义LOCAL_BUILT_MODULE_STEM=package.apk。 两个中间目录的路径,即对应的obj目录下APPS/_intermediates/。 intermediates=out/target/product/generic/obj/APPS/Calculator_intermediates intermediates.COMMON=out/target/common/obj/APPS/Calculator_intermediates
LOCAL_INTERMEDIATE_TARGETS先前package.mk中已经定义了R.stamp,java.mk有增添了7个。 LOCAL_INTERMEDIATE_TARGETS += \ $(full_classes_jar) \ $(full_classes_compiled_jar) \ $(full_classes_emma_jar) \ $(full_classes_full_names_jar) \ $(full_classes_stubs_jar) \ $(full_classes_jarjar_jar) \ $(built_dex) 此例中,具体值是 LOCAL_INTERMEDIATE_TARGETS= out/target/common/obj/APPS/Calculator_intermediates/src/R.stamp            @defined in package.mk out/target/common/obj/APPS/Calculator_intermediates/classes.jar            @full_classes_jar out/target/common/obj/APPS/Calculator_intermediates/classes-full-debug.jar        @full_classes_compiled_jar out/target/common/obj/APPS/Calculator_intermediates/emma_out/lib/classes-full-debug.jar    @full_classes_emma_jar out/target/common/obj/APPS/Calculator_intermediates/classes-full-names.jar @full_classes_full_names_jar out/target/common/obj/APPS/Calculator_intermediates/stubs.jar @full_classes_stubs_jar out/target/common/obj/APPS/Calculator_intermediates/classes-jarjar.jar    @full_classes_jarjar_jar out/target/common/obj/APPS/Calculator_intermediates/classes.dex    @built_dex
java.mk随后include base_rules.mk
后面处理了EMMA,PROGUARD在enable/disable情况下的动作
最后定义的target, $(LOCAL_MODULE)-findbugs因为prebuilt/common下还没有findbugs,目前不可用。
java.mk还定义了几个特别的变量, ALL_MODULES.$(LOCAL_MODULE).PROGUARD_ENABLED:=$(LOCAL_PROGUARD_ENABLED) ALL_MODULES.$(LOCAL_MODULE).CHECKED := $(full_classes_compiled_jar) ALL_MODULES.$(LOCAL_MODULE).STUBS := $(full_classes_stubs_jar)
2. base_rules.mk的分析
续1的场景。 提取变量my_prefix:=TARGET_ LOCAL_MODULE_TAGS在Android.mk或package.mk中已经设定,默认是optional。 确认LOCAL_MODULE_PATH,默认$($(my_prefix)OUT$(use_data)_$(LOCAL_MODULE_CLASS)),此例中是out/target/product/generic/system/app 设定module_id := MODULE.$(TARGET).$(LOCAL_MODULE_CLASS).$(LOCAL_MODULE),此例MODULE.TARGET.APPS.Calculator。 设定中间目录路径intermediates,intermediates.COMMON,参见1.
设定LOCAL_MODULE_STEM=$(LOCAL_MODULE),此例,Calculator。LOCAL_INSTALLED_MODULE_STEM=Calculator.apk。
LOCAL_INTERMEDIATE_TARGETS追加上package.apk,参见1.
处理aidl,转为java,放在intermediates.COMMON下的目录中。
处理logtag,转为java,放在intermediates.COMMON下的目录中。
确定java_sources,这包括android.mk中包含的,aidl和logtag生成的。
处理java_resource_files
处理了java lib相关
定义clean-$(LOCAL_MODULE) target, 可以删除app/package的生成文件,包括$(PRIVATE_CLEAN_FILES),$(LOCAL_BUILT_MODULE),$(LOCAL_INSTALLED_MODULE),$(intermediates),$(intermediates.COMMON) 还定义了$(LOCAL_MODULE) target, 几个变量的值 LOCAL_MODULE=Calculator LOCAL_BUILT_MODULE=out/target/product/generic/obj/APPS/Calculator_intermediates/package.apk LOCAL_INSTALLED_MODULE=out/target/product/generic/system/app/Calculator.apk
最后定义了几个ALL_MODULES变量。 ALL_MODULES.$(LOCAL_MODULE).CLASS ALL_MODULES.$(LOCAL_MODULE).PATH ALL_MODULES.$(LOCAL_MODULE).TAGS ALL_MODULES.$(LOCAL_MODULE).CHECKED ALL_MODULES.$(LOCAL_MODULE).BUILT ALL_MODULES.$(LOCAL_MODULE).INSTALLED ALL_MODULES.$(LOCAL_MODULE).REQUIRED ALL_MODULES.$(LOCAL_MODULE).EVENT_LOG_TAGS 3. multi_prebuilt.mk的分析
续1的场景。 mulit_prebuilt.mk顾名思义就是多次调用prebuilt.mk,对几种明确的prebuilt library完成需要的copy操作。
multi_prebuilt.mk定义了命令auto-prebuilt-boilerplate。入口有6个参数 # $(1): file list, ":" # $(2): IS_HOST_MODULE # $(3): MODULE_CLASS # $(4): OVERRIDE_BUILT_MODULE_PATH # $(5): UNINSTALLABLE_MODULE # $(6): BUILT_MODULE_STEM 根据这6个参数,命令确定 LOCAL_IS_HOST_MODULE LOCAL_MODULE_CLASS OVERRIDE_BUILT_MODULE_PATH LOCAL_UNINSTALLABLE_MODULE LOCAL_MODULE LOCAL_SRC_FILES LOCAL_BUILT_MODULE_STEM LOCAL_MODULE_SUFFIX 并调用prebuilt.mk
multi_prebuilt.mk中分别对下面5中lib调用了auto-prebuilt-boilerplate。
prebuilt_static_libs := $(filter %.a,$(LOCAL_PREBUILT_LIBS)) prebuilt_shared_libs := $(filter-out %.a,$(LOCAL_PREBUILT_LIBS)) prebuilt_executables := $(LOCAL_PREBUILT_EXECUTABLES) prebuilt_java_libraries := $(LOCAL_PREBUILT_JAVA_LIBRARIES) prebuilt_static_java_libraries := $(LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES)
4. prebuilt.mk的分析
续1的场景。
首先,include base_rules.mk
定义 PACKAGES.$(LOCAL_MODULE).OVERRIDES
第二步,如果是APPS类型,则zipalign,并拷贝到中间路径$(intermediates)。不是APPS,则不做zipalign。 本例是JAVA_LIBRARY类型,目的路径out/target/common/obj/JAVA_LIBRARIES/libarity_intermediates/javalib.jar,注意其中的libarity和javalib.jar。 最后检查 signed情况。
Android Make脚本的简记(3) ========================

1. main.mk
1.检查版本号,设置环境变量(BUILD_SYSTEM)和 缺省的目标BUILD_SYSTEM= build/core
2.包含文件BUILD_SYSTEM/config.mk根据配置信息和主机目标机信息,设置一些变量。
3.包含文件BUILD_SYSTEM/cleanbuild.mk。如果当前配置改变,强制删除上次的编译结果
4.包含文件OUT_DIR/version_check.mk。就设置了VERSIONS_CHECKED。如果版本序号改变,即VERSION_CHECK_SEQUENCE_NUMBER!=VERSIONS_CHECKED,检查文件系统是否大小写不敏感。文件路径上是否没有空格。JAVA,JAVAC的版本是否是1.6。
5.包含文件BUILD_SYSTEM/definitions.mk。定义了很多函数供makefile文件系统使用。
主要的是transform-xxx-to-xxx的形式,比如transform-cpp-to-o。并定义了一个make目标dist,额外的拷贝一些重要的文件到目标文件夹。
6.检查MAKECMDGOALS和TARGE_BUILD_VARIANT.根据MAKECMDGOALS设置标量is_sdk_build,是否编译SDK。
7.根据TARGE_BUILD_VARIANT,设置tags_to_install,ADDITIONAL_DEFAULT_PROPERTIES
TARGE_BUILD_VARIANT tags_to_install ADDITIONAL_DEFAULT_PROPERTIES
user user ro.secure=1 ro.allow.mock.location=0
eng user debug eng ro.setupwizard.mode=OPTIONAL
tests user debug eng
sdk user debug eng xmpp.auto-presence=true ro.config.nocheckin=yes
user debug user debug ro.sercure=1 dalvik.vm.lockprof.threshold=500 ro.allow.mock.location=0 ro.debuggable=1 persist.service.adb=1
8.检查PARDUCT_TAG是否包含dalvik.gc.type-precise,如果包含设置ADDITIONAL_DEFAULT_PROPERTIES+=dalvik.vm.dexopt-flags=m=y
9.判断PRODUCT_COPY_FILES。为空就安装apns-conf.xml文件
PRODUCT_COPY_FILE=development/data/etc/apns-conf_sdk.xml:system/etc/apns-conf.xml
如果TARGE_BUILD_VARIANT包含eng,tests但不包含sdk,且vendor/google/etc/apns-conf.xml文件存在,则PRODUCT_COPY_FILE=vendor/google/etc/apns-conf.xml:system/etc/apns-conf.xml
10.设置ADDITIONAL_BUILD_PROPERTIES+= net.bt.name=Android
dalvik.vm.stack-trace-file=/data/anr/traces.txt
11.如果MAKECMDGOALS仅包含showcommands或checkbuild,设置make目标为DEFAULT_GOALS
12.如果MAKECMDGOALS不包含clean,clobber,dataclean,installclean,根据不同的主机平台和处理器品平台,包含进要编译的模块,设置subdirs。
13.通过build/tools/findleaves.py,把subdirs目录下的Android.mk存在subdirs_makefiles。并包含这些文件。如果使用mm命令,只包含当前目录下的Android.mk。
14.若是全部编译,包含frameworks/policies/base/PolicyConfig.mk。生成android.policy模块,并定义了自己的make删除操作policy_installclean。
15.根据tags_to_install和is_sdk_build,设置哪些模块需要安装,并存入modules_to_install.
这里主要有两个函数要说明一下:
get-tagged-modules $1 $2 这两个参数一般都是ALL_MODULE_TAGS=debug eng gnuoptional samples testsuser里面的值,取得$1中不包括$2的列表,比如tests user,返回$(ALL_MODULE_TAGS.user)$(ALL_MODULE_TAGS.tests)即带有user或tests标记模块的目标文件路径列表。
Module-installed-files $1 $1一般的是一个短的模块名,比如framework,Browers,返回这个模块的目标文件路径
16.包含:$(BUILD_SYSTEM)/Makefile。主要是定义了一些伪目标。
17.定义modules_to_check,文件路径列表,若模块没有定义LOCAL_DONT_CHECK_MODULE,会把生成目标的规则加入到这个变量,以便在modules_to_install后检查目标是否生成成功,目标不存在的话再次生成目标。
二. config.mk
首先,包含pathmap.mk, 其次,定义了一些变量,例如通用的编译参数,package的后缀名等。 随后包含buildspec.mk。 接着包含envsetup.mk。 然后包含$(board_config_mk)。$(board_config_mk)是位于build/target/board /$(TARGET_DEVICE)/,device/*/$(TARGET_DEVICE)/,或vendor/*/$(TARGET_DEVICE) /目录下的BoardConfig.mk文件。

1.设置一些原文件路径,以SRC_开头
2.包含文件$(BUILD_SYSTEM)/pathmap.mk,定义了一些短名到长路径名的影射,
存放在pathmap_INCL,通过include-path-for $1 根据短名获取到长路径名FRAMEWORKS_BASE_JAVA_SRC_DIRS 保存了所有要编进Android.jar的framework/base下的文件路径。
3.设置编译目标,.jar,.bin,.so,.a,.apk,...。以BUILD_开头,指向具体的mk文件。比如BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk
4.设置一般编译选项和不同类型的文件后缀名。以COMMON_开头。COMMON_GLOBAL_CFLAGS,COMMON_RELEASE_CFLAGS。COMMON_PACKAGE_SUFFIX:=.zip
5.包含include$(TOPDIR)buildspec.mk。设置一些主要的变量,比如目标产品名称。这些都要我们在make之前设置。这个文件有个模版是build/buildspec.mk.default。
6.包含include$(BUILD_SYSTEM)/envsetup.mk。设置一些跟product相关的变量。
7.包含$(board_config_mk),在build/target/board/$(TARGET_DEVICE)/BroadConfig.mk,device/*/$(TARGET_DEVICE)/BroadConfig.mk, veror/*/$(TARGET_DEVICE)/BroadConfig.mk 这三个路径下查找product的目标设备的BroadConfig.mk文件并包含进来。BroadConfig.mk设置了每个设备的自己的一些变量值,来区别编译时的行为。TARGET_CPU_ABI 必须要设置。这些设备是被product.mk中 TARGET_DEVICE指定,一个设备信息可以被很多个product使用。
8.设置combo_target := HOST_,包含include $(BUILD_SYSTEM)/combo/select.mk。
根据操作系统和CPU类型设置以HOST_开头的变量,并包含include$(BUILD_SYSTEM)/combo/HOST_$(HOST_OS)_$(HOST_ARCH).mk,其中HOST_OS是主机操作系统,HOST_ARCH是主机CPU类型,比如HOST_linux_x86.mk.在这个文件里修改以HOST_开头的变量,主要是向HOST_GLOBAL_CFLAGS添加标志。
9.设置combo_target := TARGET_,包含include $(BUILD_SYSTEM)/combo/select.mk。
根据操作系统和CPU类型设置以TARGET_开头的变量,并包含include$(BUILD_SYSTEM)/combo/TARGET_$(TARGET_OS)_$(TARGET_ARCH).mk,其中TARGET_OS是目标操作系统,TARGET_ARCH是目标CPU类型,比如TARGET_linux_arm.mk.在这个文件里修改以TARGET_开头的变量,主要是设置交叉编译工具和参数和基本的系统头文件。定义了transform-o-to-shared-lib-inner,transform-o-to-executable-inner,transform-o-to-static-executable-inner三个函数,把.o文件分别转化成共享库文件,可执行文件,静态库文件。
10.包含 include$(BUILD_SYSTEM)/combo/javac.mk。得到一个JAVAC编译器
CUSTOM_JAVA_COMPILER COMMON_JAVAC
eclipse =java -Xmx256m -jar prebuilt/common/ecj/ecj.jar -5 \ -maxProblems 9999999 -nowarn
openjdk = prebuilt/common/openjdk/bin/javac -target 1.5 \ -Xmaxerrs 9999999
others Windows: = development/host/windows/prebuilt/javawrap.exe -J-Xmx256m \ -target 1.5 -Xmaxerrs 9999999
Other:=javac -J-Xmx512M -target 1.5 -Xmaxerrs 9999999
11.检查BUILD_ENV_SEQUENCE_NUMBER,这个是在前面的buildspec.mk设置或者通过envsetup.sh脚本设置。
12.设置主机通用工具变量。其中一些是主机自带的LEX:= flex
YACC:=bison -d DOXYGEN:= doxygen,还有一些是在/out/target/$($(HOST_OS)-$(HOST_ARCH))/bin下的程序,MKBOOTIMG:=$(HOST_OUT_EXECUTABLES)/mkbootimg。
13.设置最终的编译连接参数。有如下参数变量:
HOST_GLOBAL_CFLAGS, HOST_RELEASE_CFLAGS, HOST_GLOBAL_CPPFLAGS,
HOST_RELEASE_CPPFLAGS, TARGET_GLOBAL_CFLAGS, TARGET_RELEASE_CFLAGS,
TARGET_GLOBAL_CPPFLAGS,TARGET_RELEASE_CPPFLAGS, HOST_GLOBAL_LD_DIRS,
TARGET_GLOBAL_LD_DIRS, HOST_PROJECT_INCLUDES, TARGET_PROJECT_INCLUDES,
13.获得sdk和ndk的版本号列表。TARGET_AVAILABLE_SDK_VERSIONS和TARGET_AVAILABLE_NDK_VERSIONS
三. envsetup.mk
1.包含:include$(BUILD_SYSTEM)/version_defaults.mk ,设置那些我们需要设置的变量的缺省值。这个文件我们不因该改动,改动应该在build_id.mk里
PLATFORM_VERSION 2.2.1
PLATFORM_SDK_VERSION 8
PLATFORM_VERSION_CODENAME REL
DEFAULT_APP_TARGET_SDK PLATFORM_SDK_VERSION
BUILD_ID MASTER
BUILD_NUMBER eng.$(USER).$(date)
2.设置在文件buildspec.mk里或通过envsetup.sh设置的变量的缺省值。
TARGET_PRODUCT generic(TARGET_SIMULATOR := false)sim(TARGET_SIMULATOR:=false)
TARGET_BUILD_VARIANT eng
HOST_OS windows/linux/darwin
HOST_ARCH x86/ppc
HOST_BUILD_TYPE release
TARGET_OS linux
TARGET_ARCH arm
TARGET_BUILD_TYPE release
3.包含:include$(BUILD_SYSTEM)/product_config.mk。定义了两种MAKECMDGOALS参数形式,根据product和device目录下的mk文件生成相应的PRODUCTS_xxx_xxx和DEVICES_xxx_xxx变量。中间的是文件的路径,后面的是文件里定义的变量。
4.设置一些列路径变量。主机路径以HOST_OUT_* 或HOST_*_OUT_*形式,目标机路径以TARGET_OUT_* 或TARGET_*_OUT_*形式。
5.根据MAKECMDGOALS,若其中包含dumpvar-%或dumpvar-abs-%,就生成一个以dumpvar-%或dumpvar-abs-%命名的make目标。实现是打印出%所表示的变量的值。这个变量必须要在这之前已经定义了,后一种在前面还打印出当前的路径。这两种情况必须要先设置CALLED_FROM_SETUP=true。envsetup.sh的get_build_var和get_abs_build_var()函数就是运用的这个原理打印变量的值。
# Get the exact value of a buildvariable.
function get_build_var()
{
T=$(gettop)
if [ ! "$T" ]; then
echo "Couldn't locate the top of the tree. Try setting TOP." >&2
return
fi
CALLED_FROM_SETUP=trueBUILD_SYSTEM=build/core \
make--no-print-directory -C "$T" -f build/core/config.mk dumpvar-$1
}
# Get the value of a build variable asan absolute path.
function get_abs_build_var()
{
T=$(gettop)
if [ ! "$T" ]; then
echo "Couldn't locate the top of the tree. Try setting TOP.">&2
return
fi
CALLED_FROM_SETUP=trueBUILD_SYSTEM=build/core \
make --no-print-directory -C "$T"-f build/core/config.mk dumpvar-abs-$1
}

四. product_config.mk
1.定义两种命令形式:
makePRODUCT--
TARGET_PRODUCT := prodname TARGET_BUILD_VARIANT := goal
make APP-
TARGET_BUILD_APPS := appnames
2.包含:include$(BUILD_SYSTEM)/node_fns.mk
include $(BUILD_SYSTEM)/product.mk
include $(BUILD_SYSTEM)/device.mk
这三个文件主要是定义了一些函数来相互调用或供product_config.mk文件调用
函数名 说明
node_fns.mk Import- nodes $(1) $(2) $(3) import-nodes需要3个入口参数: $(1)是一个字串,是输出变量的主干名。例如”PRODUCTS"和”DEVICES“。 $(2)是一个makefile文件列表,这些文件中应该含有对$(3)中变量的定义。 $(3)是一个变量列表。import- nodes会创建这样形式的变量,以$(1)="PRODUCTS",$(2)中含有"build/target/product/core.mk", $(3)中含有"PRODUCT_NAME",而且core.mk中定义了PRODUCT_NAME:=core为例, PRODUCT.build/target/product/core.mk.PRODUCT_NAME:=coreimport-nodes中还考虑了inherit的问题,如果某个PRODUCT.xxx.xxx变量的值中有‘@inherit:’标识后面跟的是mk文件名,则会把那个mk文件中相应的变量的属性添加到PRODUCT.xxx.xxx中。'@inherit:'是inherit-product命令添加的。这个函数在product.mk。
product.mk _find-android-products-files 得到device/和vendor/, 包括子目录,以及build/target/product/下的AndroidProducts.mk文件列表
product.mk get-all-product-makefiles 得到所有AndroidProducts.mk文件中 PRODUCT_MAKEFILES变量定义的mk文件列表
product.mk import-products 调用import-nodes(node_fns.mk),设置$1=PRODUCTS,设置$3=$(_product_var_list),_product_var_list是以PRODUCT_开头的变量名。
product.mk inherit-product 将在所有的PRODUCT_xxx变量值后缀加上'@inherit:'
product.mk check-all-products 检查PRODUCT_NAME,PRODUCT_BRAND,PRODUCT_COPY_FILES定义的是否正确
product.mk resolve-short-product-name 根据product的名字,得到定义它的mk文件路径(resolve-short-product-name generic → /build/target/product/generic.mk)
device.mk import-devices 调用import-nodes(node_fns.mk),设置$1=DEVICES,设置$3=$(_device_var_list),_device_var_list是以DEVICE_开头的变量名。
device.mk inherit-device 将在所有的DEVICE_变量值后缀加上'@inherit:'
device.mk resolve-short-device-name 根据device的名字,得到定义它的mk文件路径
3.调用import-products函数,判断TARGET_BUILD_APPS是否为空,若为空,只导入
$(SRC_TARGET_DIR)/product/AndroidProducts.mk里的mk文件。否则调用get-all-product-makefiles,导入全部mk文件。再调用check-all-products检查变量设置的正确性。
4.根据要编译的目标TARGET_PRODUCT,通过调用resolve-short-product-name得到mk文件,结果存放在INTERNAL_PRODUCT变量里。再将PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_xxx的值赋值给PRODUCT_xxx。ADDITIONAL_BUILD_PROPERTIES追加PRODUCT_PROPERTY_OVERRIDES。这些PRODUCT_变量都在product下的mk文件里定义。如下:
TARGET_DEVICE,PRODUCT_LOCALES ,PRODUCT_BRAND, PRODUCT_MODEL, PRODUCT_MANUFACTURER, PRODUCT_DEFAULT_WIFI_CHANNELS, PRODUCT_POLICY,PRODUCT_COPY_FILES, PRODUCT_PROPERTY_OVERRIDES, PRODUCT_PACKAGE_OVERLAYS, DEVICE_PACKAGE_OVERLAYS, PRODUCT_TAGS,PRODUCT_OTA_PUBLIC_KEYS
五. cleanbuild.mk
1. 定义了add-clean-step函数。有一个入口参数$(1),执行删除操作的具体shell命令。 一般add-clean-step应当在%/cleanspec.mk脚本中使用,命令会为$(1)定义一个变量保存,变量的名字是INTERNAL_STEP.$(_acs_id),所有的$(_acs_id)保存在INTERNAL_STEPS中。$(_acs_id)的值分成3个部分构造: 第一部分是有cleanspec.mk的路径转化而来,用'_'替代'/','-'替代'.',后缀_acs。
第二部分是$(INTERNAL_CLEAN_BUILD_VERSION),默认是4。
第三部分是有'@'组成,cleanspec.mk中的第几个add- clean-step就用几个@。 例如,packages/apps/Camera/cleanspec.mk中定义了两个删除动作 $(call add-clean-step, rm -rf $(PRODUCT_OUT)/obj/APPS/Camera*) $(call add-clean-step, rm -rf $(OUT_DIR)/target/common/obj/APPS/Camera*) 那么,对应的生成变量有:
INTERNAL_STEP.packages_apps_Camera_CleanSpec-mk_acs4@:= rm -rf $(PRODUCT_OUT)/obj/APPS/Camera* INTERNAL_STEP.packages_apps_Camera_CleanSpec-mk_acs4@@ := rm -rf$(OUT_DIR)/target/common/obj/APPS/Camera*
INTERNAL_CLEAN_STEPS+=packages_apps_Camera_CleanSpec-mk_acs4@:
INTERNAL_CLEAN_STEPS+packages_apps_Camera_CleanSpec-mk_acs4@@:
2.包含:$(BUILD_SYSTEM)/cleanspec.mk。设置INTERNAL_CLEAN_BUILD_VERSION :=3,并通过add-clean-step函数,加进一些默认的删除操作,在通过build/tools/findleaves.py枚举所有的CleanSpec.mk文件,并把它们包含进来。在这些文件里根据具体的模块加删除操作。
3.包含:$(PRODUCT_OUT)/clean_steps.mk。这个文件是自动生成的,设置CURRENT_CLEAN_BUILD_VERSION :=INTERNAL_CLEAN_BUILD_VERSION
4.比较CURRENT_CLEAN_BUILD_VERSION和INTERNAL_CLEAN_BUILD_VERSION若相等执行INTERNAL_CLEAN_STEPS里的命令,否则表示我们修改过cleanspec.mk, 删除整个$(OUT_DIR)。
5.包含:$(PRODUCT_OUT)/previous_build_config.mk。这个文件也是自动生成的,查看PREVIOUS_BUILD_CONFIG是否于当前的编译选项一致。不相同就强制删除中间文件,并将当前的编译选项写入文件。删除的文件是由installclean_files,dataclean_files定义。PREVIOUS_BUILD_CONFIG的格式是$(TARGET_PRODUCT)-$(TARGET_BUILD_VARIANT)$(building_sdk)-{$(locale_list)}。
6.定义两个make目标installclean和dataclean。分别用来删除安装文件和数据文件。
六. Makefile
1.生成一些记录文件
(1).生成$(OUT_DOCS)/index.html文件,将frameworks/base/docs/docs-redirect-index.html文件内容拷贝进去。
(2).生成$(TARGET_ROOT_OUT)/default.prop文件,将ADDITIONAL_DEFAULT_PROPERTIES的值写入文件。生成$(TARGET_OUT)/build.prop文
件,主要存放的是build.properties,
主要来自于三个方面:
1,通过执行build/tools/buildinfo.sh根据PRODUCT_NAME变量值...获得
2.文件$(TARGET_DEVICE_DIR)/system.prop
3.ADDITIONAL_BUILD_PROPERTIES变量值
(3).生成文件$(PRODUCT_OUT)/sdk/sdk-build.prop,拷贝$(TARGET_OUT)/build.prop内容,并修改sdk_build_prop_remove定义的属性列表值都为generic。
(4).生成文件$(PRODUCT_OUT)/module-info.txt,列出全部模块的信息,需声明CREATE_MODULE_INFO_FILE。
2.定义一些make target
3.包含$(BUILD_SYSTEM)/tasks目录下的所有.mk文件。==================================================
3.build/core/pathmap.mk的分析
pathmap.mk 中定义了一个列表pathmap_INCL,列表中每项是"短名:路径"对。命令include-path-for使用这个pathmap_INCL列表,输入短名,得到路径。你可以在这个列表中添加自己的对。使用$(call include-path-for, <短名>)就可以得到路径。 另外,定义了FRAMEWORKS_BASE_JAVA_SRC_DIRS,含有frameworks/base目录下含java文件的所有目录。 4. buildspec.mk的分析
buildspec.mk是用户应当配置的脚本文件,模板可以使用build/buildspec.mk.default,放到$(TOP)下。 在 buildspec.mk中,用户应该配置好主要的参数,例如 TARGET_PRODUCTTARGET_BUILD_VARIANT,CUSTOM_MODULES,  TARGET_SIMULATOR,TARGET_BUILD_TYPE,CUSTOM_LOCALES, 和BUILD_ENV_SEQUENCE_NUMBER等。 如果不使用buildspec.mk配置参数,也可以使用环境变量的形式。若不配置参数,那么android会使用默认的参数。 5.build/core/envsetup.mk的分析
首先包含进version_defaults.mk,定义好一些版本相关的变量。参见version_defaults.mk。
定义CORRECT_BUILD_ENV_SEQUENCE_NUMBER,这个数字用于buildspec.mk更新时的提醒,应该同buildspec.mk中的或环境变量中的BUILD_ENV_SEQUENCE_NUMBER相等。一般不用关注。
随后检查TARGET_PRODUCT,若为空,则置generic。TARGET_PRODUCT应当在buildspec.mk或环境变量中已经定义好。
再检查TARGET_BUILD_VARIANT,若为空,则置eng。TARGET_BUILD_VARIANT应当在buildspec.mk或环境变量中已经定义好。
然后包含进product_config.mk。
接着,检查$(TARGET_BUILD_VARIANT),取值范围是eng user userdebug tests。
随后判定HOST_OS(linux),HOST_ARCH(x86)
接着,确定TARGET_ARCH和TARGET_OS,若没有定义,则取默认值。 TARGET_ARCH := arm TARGET_OS := linux
接着,确定TARGET_BUILD_TYPE,若没有定义,则取默认值。 TARGET_BUILD_TYPE := release
接着,确定OUT_DIR。OUT_DIR是存放中间文件和最终结果的地方。若没有定义,则取默认值。 OUT_DIR := $(TOPDIR)out
随后,定义了一些列的路径变量 DEBUG_OUT_DIR,TARGET_OUT_ROOT_release,TARGET_OUT_ROOT_debug,TARGET_OUT_ROOT,BUILD_OUT,PRODUCT_OUT,TARGET_COMMON_OUT_ROOT,等等。 6. build/core/version_defaults.mk的分析
version_defaults.mk是检查一些跟版本相关的变量是否定义,如果未定义,则使用默认值。这些变量包括 PLATFORM_VERSION,默认AOSP PLATFORM_SDK_VERSION,默认8 PLATFORM_VERSION_CODENAME,默认AOSP DEFAULT_APP_TARGET_SDK,默认AOSP BUILD_ID,默认UNKNOWN BUILD_NUMBER,默认eng.$(USER).$(shell date +%Y%m%d.%H%M%S)的形式。 version_defaults.mk首先包含进build_id.mk。用户应当配置build_id.mk,而不应该改动version_defaults.mk文件。 然后检查上述变量,如未定义则赋值默认值。 7. build/core/build_id.mk的分析
用户可以在build_id.mk中定义这样几个参数, PLATFORM_VERSION PLATFORM_SDK_VERSION PLATFORM_VERSION_CODENAME DEFAULT_APP_TARGET_SDK BUILD_ID BUILD_NUMBER 这些参数最终将出现build.prop中
Froyo的build_id.mk中定义了2个变量, BUILD_ID,通常用于说明分支branch的,默认的是OPENMASTER,用户应该配置这个参数。 DISPLAY_BUILD_NUMBER,在TARGET_BUILD_VARIANT=user的版本中,build.prop中是ro.build.id是显示成$(BUILD_ID).$(BUILD_NUMBER),还是显示成$(BUILD_ID)形式。设成true,则显示前者。
8. build/core/product_config.mk的分析
make PRODUCT-- 
如果使用上述形式的make命令,那么将等同于
TARGET_PRODUCT:= TARGET_BUILD_VARIANT:= goal_name:=PRODUCT-- MAKECMDGOALS:=droid
.PHONY: $(goal_name) $(goal_name): $(MAKECMDGOALS) endif
注意,goal的取值范围是user userdebug eng tests,如果不属于上述范围,则将算入MAKECMDGOALS中,此时, TARGET_BUILD_VARIANT := eng。例如 make PRODUCT-dream-installclean 等同于 TARGET_PRODUCT=dream make installclean
使用make PRODUCT--这种形式,可以方便的指定TARGET_PRODUCT,和TARGET_BUILD_VARIANT。 make APP- 
如果使用上述形式的make命令,那么将等同于 TARGET_BUILD_APPS:= unbundled_goals:=APP- MAKECMDGOALS:=droid
.PHONY: $(unbundled_goals) $(unbundled_goals): $(MAKECMDGOALS)
使用make APP-这种形式,可以方便的指定TARGET_BUILD_APPS。 注意,PRODUCT--和APP-可以一块使用。
处理完PRODUCT--和APP-product_config.mk会包含下面3个文件 node_fns.mk product.mk device.mk
上面的3个mk文件定义了一些命令,用于搜寻product, device对应的目录,生成相应的PRODUCT.XXX,和DEVICE.XXX变量。
接着,使用$(call import-products, $(get-all-product-makefiles))遍历Prodcut相关的AndroidProducts.mk文件,读入PRODCUTS.xxx变量。可以去掉文件中下面两句话的注释符,查看。 #$(dump-products) #$(error done)
随后,使用PRODCUT.xxx和TARGET_PRODUCT,得到INTERNAL_PRODUCT信息,即指定product的路径。
再由INTERNAL_PRODUCT得到TARGET_DEVICE, PRODUCT_LOCALES, PRODUCT_BRAND, PRODUCT_MODEL, PRODUCT_MANUFACTURER, PRODUCT_DEFAULT_WIFI_CHANNELS, PRODUCT_POLICY, PRODUCT_COPY_FILES, PRODUCT_PROPERTY_OVERRIDES, PRODUCT_PACKAGE_OVERLAYS, DEVICE_PACKAGE_OVERLAYS, PRODUCT_TAGS, PRODUCT_OTA_PUBLIC_KEYS。 由PRODUCT_LOCALES导出PRODUCT_AAPT_CONFIG。 ADDITIONAL_BUILD_PROPERTIES中追加PRODUCT_PROPERTY_OVERRIDES中的值。 上面所说的这些值,实际上都是在product的mk文件中定义。 9. node_fns.mk的分析
定义了一些命令。这些命令在product.mk,device.mk,和product_config.mk中会使用。这里重点说明import-nodes
import-nodes需要3个入口参数: $(1)是一个字串,是输出变量的主干名。例如”PRODUCTS"和”DEVICES“。 $(2)是一个makefile文件列表,这些文件中应该含有对$(3)中变量的定义。 $(3)是一个变量列表。
import- nodes会创建这样形式的变量,以$(1)="PRODUCTS", $(2)中含有"build/target/product/core.mk", $(3)中含有"PRODUCT_NAME", 而且core.mk中定义了PRODUCT_NAME:=core为例, PRODUCT.build/target/product/core.mk.PRODUCT_NAME:=core
import- nodes中还考虑了inherit的问题,如果某个PRODUCTS.XXX变量的值中有文件>’标识后面跟着 mk文件名的字串,则会把那个mk文件中相应的变量的属性添加到PRODUCTS.XXX中。文件>'是 inherit-product命令添加的。参见product.mk。
在product_config.mk中会说明$(2)中的mk文件列表是AndroidProducts.mk中的PRODUCT_MAKEFILES定义的。
node_fns.mk的代码真的很杀伤脑细胞... 10. product.mk的分析
product.mk构造了一些命令,供product_config.mk中使用。
_find-android-products-files这个命令会得到device/和vendor/, 包括子目录,以及build/target/product/下的AndroidProducts.mk文件列表。
get-all-product-makefiles这个命令会得到所有$(_find-android-products-files)的AndroidProducts.mk文件中PRODUCT_MAKEFILES变量定义的mk文件。
_product_var_list对应的是import-nodes命令的$(3), 定义了会生成那些PRODUCT属性名的变量。这些变量实际也是在product的mk文件中要考虑定义的。 _product_var_list := \ PRODUCT_NAME \ PRODUCT_MODEL \ PRODUCT_LOCALES \ PRODUCT_PACKAGES \ PRODUCT_DEVICE \ PRODUCT_MANUFACTURER \ PRODUCT_BRAND \ PRODUCT_PROPERTY_OVERRIDES \ PRODUCT_COPY_FILES \ PRODUCT_OTA_PUBLIC_KEYS \ PRODUCT_POLICY \ PRODUCT_PACKAGE_OVERLAYS \ DEVICE_PACKAGE_OVERLAYS \ PRODUCT_CONTRIBUTORS_FILE \ PRODUCT_TAGS \ PRODUCT_SDK_ADDON_NAME \ PRODUCT_SDK_ADDON_COPY_FILES \ PRODUCT_SDK_ADDON_COPY_MODULES \ PRODUCT_SDK_ADDON_DOC_MODULE \ PRODUCT_DEFAULT_WIFI_CHANNELS
import-products会调用import-nodes。product_config.mk中用到。 define import-products $(call import-nodes,PRODUCTS,$(1),$(_product_var_list)) endef
inherit-product命令则将在所有的PRODUCT.xxx变量值中后缀上文件>',当import-nodes处理时,会替换成继承的属性。
check-all-products命令借助$(PRODUCTS)诸变量,会对product进行唯一性检查和PRODUCT_NAME,PRODUCT_BRAND,PRODCUT_COPY_FILES的简单检查。
resolve-short-product-name命令,给定Product的短名,返回对应mk的路径。 11. device.mk的分析
同product.mk类似,device.mk构造了一些命令。有resolve-short-device-name,和import-devices。 =====================================
1. config.mk的分析
首先,包含pathmap.mk, 其次,定义了一些变量,例如通用的编译参数,package的后缀名等。
随后包含buildspec.mk。
接着包含envsetup.mk。envsetup.mk中会遍历所有product相关的路径,载入所有支持的product的信息到变量集 PRODUCT..中,一个product对应一个。最后根据TARGET_PRODUCT的值,定义各种跟product相关的变量,包括 TARGET_DEVICE变量。
然后包含$(board_config_mk)。$(board_config_mk)是位于 build/target/board/$(TARGET_DEVICE)/,device/*/$(TARGET_DEVICE)/,或vendor /*/$(TARGET_DEVICE)/目录下的BoardConfig.mk文件。 $(TARGET_DEVICE)已经在product_config.mk中定义了。在包含$(board_config_mk)之前,会做检查,多个$(board_config_mk)存在则报错。
定义TARGET_DEVICE_DIR,TARGET_BOOTLOADER_BOARD_NAME,TARGET_CPU_ABI等跟board相关的变量。
接着,依次以HOST_和TARGET_条件包含select.mk。这里说明TARGET_的select.mk。先定义combo_os_arch,通常是linux-arm,然后定义各种跟编译链接相关的一些变量,最后再包含进build/core/combo/TARGET_linux- arm.mk。
再包含javac.mk,定义javac的命令和通用参数。
随后,定义一些变量,指向通用工具,其中一些是os提供的,例如YACC;一些是froyo编译生成,放在out/host/linux-x86/bin/下,一些是预定义的脚本和工具,例如MKTARBALL。
最后定义了一些编译链接变量,这里专门列出, HOST_GLOBAL_CFLAGS += $(COMMON_GLOBAL_CFLAGS) HOST_RELEASE_CFLAGS += $(COMMON_RELEASE_CFLAGS)
HOST_GLOBAL_CPPFLAGS += $(COMMON_GLOBAL_CPPFLAGS) HOST_RELEASE_CPPFLAGS += $(COMMON_RELEASE_CPPFLAGS)
TARGET_GLOBAL_CFLAGS += $(COMMON_GLOBAL_CFLAGS) TARGET_RELEASE_CFLAGS += $(COMMON_RELEASE_CFLAGS)
TARGET_GLOBAL_CPPFLAGS += $(COMMON_GLOBAL_CPPFLAGS) TARGET_RELEASE_CPPFLAGS += $(COMMON_RELEASE_CPPFLAGS)
HOST_GLOBAL_LD_DIRS += -L$(HOST_OUT_INTERMEDIATE_LIBRARIES) TARGET_GLOBAL_LD_DIRS += -L$(TARGET_OUT_INTERMEDIATE_LIBRARIES)
HOST_PROJECT_INCLUDES:= $(SRC_HEADERS) $(SRC_HOST_HEADERS) $(HOST_OUT_HEADERS) TARGET_PROJECT_INCLUDES:= $(SRC_HEADERS) $(TARGET_OUT_HEADERS)
ifneq ($(TARGET_SIMULATOR),true) TARGET_GLOBAL_CFLAGS += $(TARGET_ERROR_FLAGS) TARGET_GLOBAL_CPPFLAGS += $(TARGET_ERROR_FLAGS) endif
HOST_GLOBAL_CFLAGS += $(HOST_RELEASE_CFLAGS) HOST_GLOBAL_CPPFLAGS += $(HOST_RELEASE_CPPFLAGS)
TARGET_GLOBAL_CFLAGS += $(TARGET_RELEASE_CFLAGS) TARGET_GLOBAL_CPPFLAGS += $(TARGET_RELEASE_CPPFLAGS)
其中的TARGET_PROJECT_INCLUDES包含了SRC_HEADERS,添加头文件路径的话,可以改动SRC_HEADERS。
最后包含进dumpvar.mk 2. javac.mk的分析
javac.mk中会定义javac的编译命令和通用参数。 CUSTOM_JAVA_COMPILER做为javac.mk的入口参数,可以考虑openjdk,eclipse。不定义时则使用默认的javac。另外定义为openjdk时,因为prebuilt/对应目录下没有相应的工具,所以还不可用。 依次一般忽略定义CUSTOM_JAVA_COMPILER,只要直接配置自己编译环境的path,指向使用的javac就可以了。
javac在linux平台的定义是 javac -J-Xmx512M -target 1.5 -Xmaxerrs 9999999
-J-Xmx512M,传递给vm launcher参数-Xmx512M,告知起始空间设定为512M。 -target 1.5,编译的结果适用1.5版本。 -Xmaxerrs 9999999,最大输出的错误数是9999999。
3. dumpvar.mk的分析
dumpvar.mk 支持两种target: dumpvar-,和dumpvar-abs-。envsetup.sh中的 get_build_var和get_abs_build_var就使用了这些target。
使用方法:假设位于$(TOPDIR)路径,
CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core make -f build/core/config.mk dumpvar- 或 CALLED_FROM_SETUP=true BUILD_SYSTEM=build/core make -f build/core/config.mk dumpvar-abs-
第一种形式,返回varName的值。第二种形式,返回varName的值,前缀上路径。考虑到android脚本中广泛使用':=’的变量定义方法,因此,基本上只能显示dumpvar.mk之前定义的变量值。LOCAL_xxxx的变量也不适用。
4. cleanbuild.mk的分析
main.mk在包含了config.mk后,会包含进cleanbuild.mk。
定义了add-clean-step命令。有一个入口参数 $(1),执行删除操作的具体shell命令。 一般add-clean-step应当在%/cleanspec.mk脚本中使用,命令会为$(1)定义一个变量保存,变量的名字是 INTERNAL_STEP.$(_acs_id),所有的$(_acs_id)保存在INTERNAL_STEPS中。$(_acs_id)的值分成3 个部分构造 第一部分是有cleanspec.mk的路径转化而来,用'_'替代'/','-'替代'.',后缀_acs。第二部分是$(INTERNAL_CLEAN_BUILD_VERSION),默认是4,第三部分是有组成,cleanspec.mk中的第几个add- clean-step就用几个@。 例如,packages/apps/Camera/cleanspec.mk中定义了两个删除动作 $(call add-clean-step, rm -rf $(PRODUCT_OUT)/obj/APPS/Camera*) $(call add-clean-step, rm -rf $(OUT_DIR)/target/common/obj/APPS/Camera*) 那么,对应的有 INTERNAL_STEP.packages_apps_Camera_CleanSpec-mk_acs4@ := rm -rf $(PRODUCT_OUT)/obj/APPS/Camera* INTERNAL_STEP.packages_apps_Camera_CleanSpec-mk_acs4@@ := rm -rf $(OUT_DIR)/target/common/obj/APPS/Camera*
接着,包扩进cleanspec.mk
包含进$(PRODUCT_OUT)/clean_steps.mk,
接下来,检查CURRENT_CLEAN_BUILD_VERSION是否与INTERNAL_CLEAN_BUILD_VERSION相同,默认是4 如果相同, 执行所有在INTERNAL_STEPS中登记的删除操作。 否则, 删除 $(OUT_DIR)
然后,重新生成$(PRODUCT_OUT)/clean_steps.mk,写入"CURRENT_CLEAN_BUILD_VERSION := $(INTERNAL_CLEAN_BUILD_VERSION)"和"CURRENT_CLEAN_STEPS := $(INTERNAL_CLEAN_STEPS)"。
随后,读入$(PRODUCT_OUT)/previous_build_config.mk,看是否与当前的编译选项一致,不一致则标明上次的中间文件不可用,则删除相应的中间目录,或提示用户。接着重新将当前的信息写入$(PRODUCT_OUT)/previous_build_config.mk,格式是, current_build_config := \ $(TARGET_PRODUCT)-$(TARGET_BUILD_VARIANT)$(building_sdk)-{$(locale_list)}
echo "PREVIOUS_BUILD_CONFIG := $(current_build_config)" > \ $(previous_build_config_file)
最后,定义了两个target, installclean和dataclean。 dataclean删除的主要是./$(PRODUCT_OUT)/data/*, installclean的删除包括dataclean。installclean的本意是用于不同build_type编译时删除前次的中间文件。 总结cleanbuild.mk的内容,就3件事,一是载入所有的CleanSpec.mk,二是检查更新clean_steps.mk和 previous_build_config.mk,避免不同编译间的互相干扰。最后是,定义installclean和dataclean。 5. cleanspec.mk的分析
首先定义 INTERNAL_CLEAN_BUILD_VERSION := 4
接着使用findleaves.py遍历所有子目录,找到CleanSpec.mk,并包含进。用户可以在CleanSpec.mk中定义自己需要的删除操作。实际上还可以包含不仅仅是删除的操作。
至此,INTERNAL_STEP.XXXX包含了所有CleanSpec.mk定义的clean动作。 6. version_checked.mk的分析
main.mk 在cleanbuild.mk后,会借助$(OUT_DIR)/version_checked.mk检查版本,如果版本不一致,则重新检查系统文件系统大小写敏感问题,路径上是否含有空格,java和javac的版本,没有问题,则更新version_checked.mk。
version_checked.mk中就定义了 VERSIONS_CHECKED := $(VERSION_CHECK_SEQUENCE_NUMBER)
7. showcommands和checkbuild的说明
checkbuild貌似并未使用。
showcommands必须同其它target一同使用,showcommands会详细打印出执行的具体命令内容。
8. definations.mk的说明
definations.mk中定义了大量的命令,其它的mk文件将使用。这其中包括执行编译链接的命令,通常是transform-XXX-to-XXX的形式,例如,transform-cpp-to-o。
其中的inherit-package命令有待研究... ===================== 1. Makefile的分析
首先定义target, 用于生成$(OUT_DOCS)/index.html
再定义target, 用于生成$(TARGET_ROOT_OUT)/default.prop
再定义target, 用于生成$(TARGET_OUT)/build.prop。build.prop文件记录了一系列属性值。它的内容分成两部分,第一部分是一些关于 product,device,build的一般性属性值,第二部分的属性值源自ADDITIONAL_BUILD_PROPERTIES。 product配置mk文件中定义的PRODUCT_PROPERTY_OVERRIDES会加入到 ADDITIONAL_BUILD_PROPERTIES,建议增加property时,直接修改 PRODUCT_PROPERTY_OVERRIDES。
再定义target, 用于生成$(PRODUCT_OUT)/sdk/sdk-build.prop
再定义target,package-stats,用于生成$(PRODUCT_OUT)/package-stats.txt,这个文件包含了.jar,.apk后缀文件的信息。
再定义target,apkcerts-list,用于生成$(name)-apkcerts-$(FILE_NAME_TAG),描述各module的certificate和private_key文件信息。
接着,如果定义了CREATE_MODULE_INFO_FILE,则生成$(PRODUCT_OUT)/module-info.txt,其中包含了描述所有module的信息。
再定义target,event-log-tags。
接着,处理ramdisk.img
再处理boot.img,如果TARGET_NO_KERNEL不是true,则将kernel和ramdisk.img组装成boot.img。
接着,定影命令combine-notice-files,用于生成target,notice_files。notice_files会抽取生成相应的声明文件。
随后,建立target,otacert,用于将.x509.pem后缀的认证文件打包存放到$(TARGET_OUT_ETC)/security/otacerts.zip。
接着,建立target,recoveryimage,处理recovery img
还有下面的target,
systemimage-nodeps, snod systemtarball-nodeps,stnod boottarball-nodeps,btnod userdataimage-nodeps userdatatarball-nodeps otatools target-files-package otapackage installed-file-list tests-zip-package dalvikfiles updatepackage

本文链接:https://www.it72.com/1548.htm

推荐阅读
最新回复 (0)
返回