Android Make脚本的简记(1)
内容提要
文档简要整理Android的make脚本的内容。以供备忘和参考。
1. Build Layers
Build Layers描述的是产品的硬件配置情况&＃xff0c;据此make时选择不同的配置和模块。按照从上到下的顺序&＃xff0c;Build Layer分成4层。
Layer sample Note
Arch arm, x86 处理器的种类
Board &＃xff0d; 板子类型的代号
Device &＃xff0d; device配置的类型代号
Product &＃xff0d; 具体产品的代号
2. 添加应用
2.1 一个例子
以calculator为例&＃xff0c;app代码可以放到packages/apps/目录下边&＃xff0c;一个app对应一个目录&＃xff0c;此例&＃xff0c;pakcages/apps/Calculator/。创建Android.mk&＃xff0c;已去除多余的注释行。
LOCAL_PATH :&＃61; $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE_TAGS :&＃61; optional
LOCAL_STATIC_JAVA_LIBRARIES :&＃61; libarity
LOCAL_SRC_FILES :&＃61; $(call all-java-files-under, src)
LOCAL_SDK_VERSION :&＃61; current
LOCAL_PACKAGE_NAME :&＃61; Calculator
include $(BUILD_PACKAGE)
include $(CLEAR_VARS)
LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES :&＃61; 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))
至少有一个子目录&＃xff0c;src下放源码。
Android.mk中需要赋值的几个LOCAL_XXX变量&＃xff0c;
LOCAL_PATH&＃xff0c;调用my-dir&＃xff08;在defination.mk中定义&＃xff09;&＃xff0c;得到当前路径&＃xff0c;即&＃xff0c;
LOCAL_MODULE_TAGS&＃xff0c;&＃xff0c;取值范围debug eng tests optional samples shell_ash shell_mksh。注意不能取值user&＃xff0c;如果要预装&＃xff0c;则应定义core.mk。
LOCAL_SRC_FILES&＃xff0c;app的所有源码&＃xff0c;可以调用all-java-files-under得到&＃xff0c;如果是java源码的话。
LOCAL_PACKAGE_NAME&＃xff0c;package的名字&＃xff0c;这个名字在脚本中将标识这个app或package。
$(CLEAR_VARS)指的是clear_vars.mk&＃xff0c;脚本会清空所有LOCAL_xxx的变量&＃xff0c;不影响后面这些变量的使用。
$(BUILD_PACKAGE)指的是package.mk
最后一句all-makefiles-under将会包含当前目录下所有的mk脚本文件。
2.2 LOCAL_XXX的列表
说明&＃xff1a;
必须定义, 在app或package的Android.mk中必须给定值。
可选定义&＃xff0c;在app或package的Android.mk中可以也可以不给定值。
不用定义&＃xff0c;在app或package的Android.mk中不要给定值&＃xff0c;脚本自动指定值。
LOCAL_PATH&＃xff0c; 当前路径&＃xff0c;必须定义。
LOCAL_PACKAGE_NAME&＃xff0c; 必须定义&＃xff0c;package的名字&＃xff0c;这个名字在脚本中将标识app或package。
LOCAL_MODULE_SUFFIX&＃xff0c; 不用定义&＃xff0c;module的后缀&＃xff0c;&＃61;.apk。
LOCAL_MODULE&＃xff0c; 不用定义&＃xff0c;&＃61;$(LOCAL_PACKAGE_NAME)。
LOCAL_JAVA_RESOURCE_DIRS&＃xff0c; 不用定义。
LOCAL_JAVA_RESOURCE_FILES&＃xff0c; 不用定义。
LOCAL_MODULE_CLASS&＃xff0c; 不用定义。
LOCAL_MODULE_TAGS&＃xff0c; 可选定义。默认optional。取值范围user debug eng tests optional samples shell_ash shell_mksh。
LOCAL_ASSET_DIR&＃xff0c; 可选定义&＃xff0c;推荐不定义。默认$(LOCAL_PATH)/assets
LOCAL_RESOURCE_DIR&＃xff0c; 可选定义&＃xff0c;推荐不定义。默认product package和device package相应的res路径和$(LOCAL_PATH)/res。
LOCAL_PROGUARD_ENABLED&＃xff0c; 可选定义&＃xff0c;默认为full&＃xff0c;如果是user或userdebug。取值full, disabled, custom。
full_android_manifest&＃xff0c; 不用定义&＃xff0c;&＃61;$(LOCAL_PATH)/AndroidManifest.xml。
LOCAL_EXPORT_PACKAGE_RESOURCES&＃xff0c; 可选定义&＃xff0c;默认null。如果允许app的资源被其它模块使用&＃xff0c;则设置true。
LOCAL_CERTIFICATE&＃xff0c; 可选定义&＃xff0c;默认为testkey。最终
private_key :&＃61; $(LOCAL_CERTIFICATE).pk8
certificate :&＃61; $(LOCAL_CERTIFICATE).x509.pem
2.3 mm创建apk时的package.mk中变量分析
以Calculator为例&＃xff0c;
由LOCAL_PATH&＃xff0c;LOCAL_PACKAGE_NAME导出变量LOCAL_MODULE&＃xff0c;all_assets&＃xff0c;all_assets&＃xff0c;all_resources。
设置LOCAL_MODULE_CLASS&＃61;APPS&＃xff0c;此值local-intermediates-dir会用到。
设置中间生成目录路径&＃xff0c;中间路径将放置R.stamp文件。
package_expected_intermediates_COMMON :&＃61; $(call local-intermediates-dir,COMMON)
这里COMMON是null&＃xff0c;而LOCAL_MODULE_CLASS&＃61;APPS&＃xff0c;所以
package_expected_intermediates_COMMON&＃61;out/target/common/obj/$(LOCAL_MODULE_CLASS)/$(LOCAL_MODULE)_intermediates
即
package_expected_intermediates_COMMON&＃61;out/target/common/obj/APPS/Calculator_intermediates
设置
LOCAL_BUILT_MODULE_STEM :&＃61; package.apk
而
LOCAL_BUILT_MODULE :&＃61; $(built_module_path)/$(LOCAL_BUILT_MODULE_STEM) &＃64;base_rules.mk
built_module_path :&＃61; $(intermediates) &＃64;base_rules.mk
intermediates :&＃61; $(call local-intermediates-dir) &＃64;java.mk
最终
LOCAL_BUILT_MODULE&＃61;out/target/product/
即
LOCAL_BUILT_MODULE&＃61;out/target/product/generic/obj/APPS/Calculator_intermediates/package.apk
由LOCAL_CERTIFICATE导出
private_key :&＃61; $(SRC_TARGET_DIR)/product/security/$(LOCAL_CERTIFICATE).pk8
certificate :&＃61; $(SRC_TARGET_DIR)/product/security/$(LOCAL_CERTIFICATE).x509.pem
LOCAL_CERTIFICATE默认为testkey。
2.4 package.mk中定义的几个PACKAGE.xxx变量
PACKAGES.$(LOCAL_PACKAGE_NAME).PRIVATE_KEY :&＃61; $(private_key)
PACKAGES.$(LOCAL_PACKAGE_NAME).CERTIFICATE :&＃61; $(certificate)
PACKAGES.$(LOCAL_PACKAGE_NAME).OVERRIDES :&＃61; $(strip $(LOCAL_OVERRIDES_PACKAGES))
PACKAGES.$(LOCAL_PACKAGE_NAME).RESOURCE_FILES :&＃61; $(all_resources)
PACKAGES :&＃61; $(PACKAGES) $(LOCAL_PACKAGE_NAME)
全编译时&＃xff0c;PACKAGES变量将会记录遍历到的packages。
Android Make脚本的简记(2)
内容提要
文档简要整理Android的make脚本的内容。以供备忘和参考。
1. java.mk分析
选取APPS场景&＃xff0c;以Calculator为例说明。
LOCAL_JAVA_LIBRARIES&＃61;true时&＃xff0c;Android.mk中不能定义LOCAL_SDK_VERSION。
当LOCAL_SDK_VERSION&＃61;current时&＃xff0c;LOCAL_JAVA_LIBRARIES&＃61;android_stubs_current。
package.mk中定义LOCAL_BUILT_MODULE_STEM&＃61;package.apk。
两个中间目录的路径&＃xff0c;即对应的obj目录下APPS/
intermediates&＃61;out/target/product/generic/obj/APPS/Calculator_intermediates
intermediates.COMMON&＃61;out/target/common/obj/APPS/Calculator_intermediates
LOCAL_INTERMEDIATE_TARGETS先前package.mk中已经定义了R.stamp&＃xff0c;java.mk有增添了7个。
LOCAL_INTERMEDIATE_TARGETS &＃43;&＃61; /
$(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)
此例中&＃xff0c;具体值是
LOCAL_INTERMEDIATE_TARGETS&＃61;
out/target/common/obj/APPS/Calculator_intermediates/src/R.stamp &＃64;defined in package.mk
out/target/common/obj/APPS/Calculator_intermediates/classes.jar &＃64;full_classes_jar
out/target/common/obj/APPS/Calculator_intermediates/classes-full-debug.jar &＃64;full_classes_compiled_jar
out/target/common/obj/APPS/Calculator_intermediates/emma_out/lib/classes-full-debug.jar &＃64;full_classes_emma_jar
out/target/common/obj/APPS/Calculator_intermediates/classes-full-names.jar &＃64;full_classes_full_names_jar
out/target/common/obj/APPS/Calculator_intermediates/stubs.jar &＃64;full_classes_stubs_jar
out/target/common/obj/APPS/Calculator_intermediates/classes-jarjar.jar &＃64;full_classes_jarjar_jar
out/target/common/obj/APPS/Calculator_intermediates/classes.dex &＃64;built_dex
java.mk随后include base_rules.mk
后面处理了EMMA,PROGUARD在enable/disable情况下的动作
最后定义的target, $(LOCAL_MODULE)-findbugs因为prebuilt/common下还没有findbugs&＃xff0c;目前不可用。
java.mk还定义了几个特别的变量&＃xff0c;
ALL_MODULES.$(LOCAL_MODULE).PROGUARD_ENABLED:&＃61;$(LOCAL_PROGUARD_ENABLED)
ALL_MODULES.$(LOCAL_MODULE).CHECKED :&＃61; $(full_classes_compiled_jar)
ALL_MODULES.$(LOCAL_MODULE).STUBS :&＃61; $(full_classes_stubs_jar)
2. base_rules.mk的分析
续1的场景。
提取变量my_prefix:&＃61;TARGET_
LOCAL_MODULE_TAGS在Android.mk或package.mk中已经设定&＃xff0c;默认是optional。
确认LOCAL_MODULE_PATH&＃xff0c;默认$($(my_prefix)OUT$(use_data)_$(LOCAL_MODULE_CLASS))&＃xff0c;此例中是out/target/product/generic/system/app
设定module_id :&＃61; MODULE.$(TARGET).$(LOCAL_MODULE_CLASS).$(LOCAL_MODULE)&＃xff0c;此例MODULE.TARGET.APPS.Calculator。
设定中间目录路径intermediates&＃xff0c;intermediates.COMMON&＃xff0c;参见1.
设定LOCAL_MODULE_STEM&＃61;$(LOCAL_MODULE)&＃xff0c;此例,Calculator。LOCAL_INSTALLED_MODULE_STEM&＃xff1d;Calculator.apk。
LOCAL_INTERMEDIATE_TARGETS追加上package.apk&＃xff0c;参见1.
处理aidl&＃xff0c;转为java&＃xff0c;放在intermediates.COMMON下的目录中。
处理logtag&＃xff0c;转为java&＃xff0c;放在intermediates.COMMON下的目录中。
确定java_sources&＃xff0c;这包括android.mk中包含的&＃xff0c;aidl和logtag生成的。
处理java_resource_files
处理了java lib相关
定义clean-$(LOCAL_MODULE) target, 可以删除app/package的生成文件&＃xff0c;包 括$(PRIVATE_CLEAN_FILES)&＃xff0c;$(LOCAL_BUILT_MODULE)&＃xff0c;$(LOCAL_INSTALLED_MODULE)&＃xff0c;$(intermediates)&＃xff0c;$(intermediates.COMMON)
还定义了$(LOCAL_MODULE) target, 几个变量的值
LOCAL_MODULE&＃61;Calculator
LOCAL_BUILT_MODULE&＃61;out/target/product/generic/obj/APPS/Calculator_intermediates/package.apk
LOCAL_INSTALLED_MODULE&＃61;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&＃xff0c;对几种明确的prebuilt library完成需要的copy操作。
multi_prebuilt.mk定义了命令auto-prebuilt-boilerplate。入口有6个参数
# $(1): file list&＃xff0c; "
# $(2): IS_HOST_MODULE
# $(3): MODULE_CLASS
# $(4): OVERRIDE_BUILT_MODULE_PATH
# $(5): UNINSTALLABLE_MODULE
# $(6): BUILT_MODULE_STEM
根据这6个参数&＃xff0c;命令确定
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 :&＃61; $(filter %.a,$(LOCAL_PREBUILT_LIBS))
prebuilt_shared_libs :&＃61; $(filter-out %.a,$(LOCAL_PREBUILT_LIBS))
prebuilt_executables :&＃61; $(LOCAL_PREBUILT_EXECUTABLES)
prebuilt_java_libraries :&＃61; $(LOCAL_PREBUILT_JAVA_LIBRARIES)
prebuilt_static_java_libraries :&＃61; $(LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES)
4. prebuilt.mk的分析
续1的场景。
首先&＃xff0c;include base_rules.mk
定义
PACKAGES.$(LOCAL_MODULE).OVERRIDES
第二步&＃xff0c;如果是APPS类型&＃xff0c;则zipalign&＃xff0c;并拷贝到中间路径$(intermediates)。不是APPS&＃xff0c;则不做zipalign。
本例是JAVA_LIBRARY类型&＃xff0c;目的路径out/target/common/obj/JAVA_LIBRARIES/libarity_intermediates/javalib.jar&＃xff0c;注意其中的libarity和javalib.jar。
最后检查 signed情况。
Android101110: Android Make脚本的简记(3)
内容提要
文档简要整理Android的make脚本的内容。以供备忘和参考。
1. findleaves.py的分析
main.mk中调用了findleaves.py&＃xff0c;得到所有子目录下Android.mk文件的路径。
subdir_makefiles :&＃61; /
$(shell build/tools/findleaves.py --prune&＃61;out --prune&＃61;.repo --prune&＃61;.git $(subdirs) Android.mk)
$(subdirs)一般编译中取值$(TOP)。
使用方法&＃xff0c;
Usage: %(progName)s [
Options:
--mindepth&＃61;
Both behave in the same way as their find(1) equivalents.
--prune&＃61;
Avoids returning results from inside any directory called
(e.g., "*/out/*"). May be used multiple times.
程序首先依次选取dirlist中的目录&＃xff0c;然后遍历所有子目录查找Android.mk文件&＃xff0c;如果有&＃xff0c;则加入到返回列表中。
2. pathmap.mk的分析
pathmap.mk 中定义了一个列表pathmap_INCL&＃xff0c;列表中每项是"短名:路径"对。命令include-path-for使用这个pathmap_INCL列 表&＃xff0c;输入短名&＃xff0c;得到路径。你可以在这个列表中添加自己的对。使用$(call include-path-for, <短名>)就可以得到路径。
另外&＃xff0c;定义了FRAMEWORKS_BASE_JAVA_SRC_DIRS&＃xff0c;含有frameworks/base目录下含java文件的所有目录。
3. config.mk的分析
首先&＃xff0c;包含pathmap.mk&＃xff0c; 其次&＃xff0c;定义了一些变量&＃xff0c;例如通用的编译参数&＃xff0c;package的后缀名等。
随后包含buildspec.mk。
接着包含envsetup.mk。
然后包含$(board_config_mk)。$(board_config_mk)是位于build/target/board /$(TARGET_DEVICE)/&＃xff0c;device/*/$(TARGET_DEVICE)/&＃xff0c;或vendor/*/$(TARGET_DEVICE) /目录下的BoardConfig.mk文件。
-------TODO
4. buildspec.mk的分析
buildspec.mk是用户应当配置的脚本文件&＃xff0c;模板可以使用buildspec.mk.default&＃xff0c;放到$(TOP)下。
在 buildspec.mk中&＃xff0c;用户应该配置好主要的参数&＃xff0c;例如 TARGET_PRODUCT&＃xff0c; TARGET_BUILD_VARIANT&＃xff0c; CUSTOM_MODULES&＃xff0c; TARGET_SIMULATOR&＃xff0c; TARGET_BUILD_TYPE&＃xff0c; CUSTOM_LOCALES&＃xff0c; 和BUILD_ENV_SEQUENCE_NUMBER等。
如果不使用buildspec.mk配置参数&＃xff0c;也可以使用环境变量的形式。若不配置参数&＃xff0c;那么android会使用默认的参数。
5. envsetup.mk的分析
首先包含进version_defaults.mk&＃xff0c;定义好一些版本相关的变量。参见version_defaults.mk。
定义CORRECT_BUILD_ENV_SEQUENCE_NUMBER&＃xff0c;这个数字用于buildspec.mk更新时的提醒&＃xff0c;应该同buildspec.mk中的或环境变量中的BUILD_ENV_SEQUENCE_NUMBER相等。一般不用关注。
随后检查TARGET_PRODUCT&＃xff0c;若为空&＃xff0c;则置generic。TARGET_PRODUCT应当在buildspec.mk或环境变量中已经定义好。
再检查TARGET_BUILD_VARIANT&＃xff0c;若为空&＃xff0c;则置eng。TARGET_BUILD_VARIANT应当在buildspec.mk或环境变量中已经定义好。
然后包含进product_config.mk。
接着&＃xff0c;检查$(TARGET_BUILD_VARIANT),取值范围是eng user userdebug tests。
随后判定HOST_OS(linux)&＃xff0c;HOST_ARCH(x86)
接着&＃xff0c;确定TARGET_ARCH和TARGET_OS&＃xff0c;若没有定义&＃xff0c;则取默认值。
TARGET_ARCH :&＃61; arm
TARGET_OS :&＃61; linux
接着&＃xff0c;确定TARGET_BUILD_TYPE&＃xff0c;若没有定义&＃xff0c;则取默认值。
TARGET_BUILD_TYPE :&＃61; release
接着&＃xff0c;确定OUT_DIR。OUT_DIR是存放中间文件和最终结果的地方。若没有定义&＃xff0c;则取默认值。
OUT_DIR :&＃61; $(TOPDIR)out
随后&＃xff0c;定义了一些列的路径变量
DEBUG_OUT_DIR&＃xff0c;TARGET_OUT_ROOT_release&＃xff0c;TARGET_OUT_ROOT_debug&＃xff0c;TARGET_OUT_ROOT&＃xff0c;BUILD_OUT&＃xff0c;PRODUCT_OUT&＃xff0c;TARGET_COMMON_OUT_ROOT&＃xff0c;等等。
6. version_defaults.mk的分析
version_defaults.mk是检查一些跟版本相关的变量是否定义&＃xff0c;如果未定义&＃xff0c;则使用默认值。这些变量包括
PLATFORM_VERSION&＃xff0c;默认AOSP
PLATFORM_SDK_VERSION&＃xff0c;默认8
PLATFORM_VERSION_CODENAME&＃xff0c;默认AOSP
DEFAULT_APP_TARGET_SDK&＃xff0c;默认AOSP
BUILD_ID&＃xff0c;默认UNKNOWN
BUILD_NUMBER&＃xff0c;默认eng.$(USER).$(shell date &＃43;%Y%m%d.%H%M%S)的形式。
version_defaults.mk首先包含进build_id.mk。用户应当配置build_id.mk&＃xff0c;而不应该改动version_defaults.mk文件。
然后检查上述变量&＃xff0c;如未定义则赋值默认值。
7. build_id.mk的分析
用户可以在build_id.mk中定义这样几个参数&＃xff0c;
PLATFORM_VERSION
PLATFORM_SDK_VERSION
PLATFORM_VERSION_CODENAME
DEFAULT_APP_TARGET_SDK
BUILD_ID
BUILD_NUMBER
这些参数最终将出现build.prop中。
Froyo的build_id.mk中定义了2个变量&＃xff0c;
BUILD_ID&＃xff0c;通常用于说明分支branch的&＃xff0c;默认的是OPENMASTER&＃xff0c;用户应该配置这个参数。
DISPLAY_BUILD_NUMBER&＃xff0c;在TARGET_BUILD_VARIANT&＃61;user的版本中&＃xff0c;build.prop中是 ro.build.id是显示成$(BUILD_ID).$(BUILD_NUMBER)&＃xff0c;还是显示成$(BUILD_ID)形式。设成true&＃xff0c;则显示 前者。
8. product_config.mk的分析
make PRODUCT-
如果使用上述形式的make命令&＃xff0c;那么将等同于
TARGET_PRODUCT:&＃61;
TARGET_BUILD_VARIANT:&＃61;
goal_name:&＃61;PRODUCT-
MAKECMDGOALS:&＃61;droid
.PHONY: $(goal_name)
$(goal_name): $(MAKECMDGOALS)
endif
注意,goal的取值范围是user userdebug eng tests&＃xff0c;如果不属于上述范围&＃xff0c;则将算入MAKECMDGOALS中&＃xff0c;此时, TARGET_BUILD_VARIANT :&＃61; eng。例如
make PRODUCT-dream-installclean
等同于
TARGET_PRODUCT&＃61;dream make installclean
使用make PRODUCT-
make APP-
如果使用上述形式的make命令&＃xff0c;那么将等同于
TARGET_BUILD_APPS:&＃61;
unbundled_goals:&＃61;APP-
MAKECMDGOALS:&＃61;droid
.PHONY: $(unbundled_goals)
$(unbundled_goals): $(MAKECMDGOALS)
使用make APP-
注意&＃xff0c;PRODUCT-
处理完PRODUCT-
node_fns.mk
product.mk
device.mk
上面的3个mk文件定义了一些命令&＃xff0c;用于搜寻product, device对应的目录&＃xff0c;生成相应的PRODUCT.XXX,和DEVICE.XXX变量。
接着&＃xff0c;使用$(call import-products, $(get-all-product-makefiles))遍历Prodcut相关的AndroidProducts.mk文件&＃xff0c;读入PRODCUTS.xxx变量。可以去掉文件中下面两句话的注释符&＃xff0c;查看。
#$(dump-products)
#$(error done)
随后&＃xff0c;使用PRODCUT.xxx和TARGET_PRODUCT&＃xff0c;得到INTERNAL_PRODUCT信息&＃xff0c;即指定product的路径。
再由INTERNAL_PRODUCT得到TARGET_DEVICE&＃xff0c; PRODUCT_LOCALES&＃xff0c; PRODUCT_BRAND&＃xff0c; PRODUCT_MODEL&＃xff0c; PRODUCT_MANUFACTURER&＃xff0c; PRODUCT_DEFAULT_WIFI_CHANNELS&＃xff0c; PRODUCT_POLICY&＃xff0c; PRODUCT_COPY_FILES&＃xff0c; PRODUCT_PROPERTY_OVERRIDES&＃xff0c; PRODUCT_PACKAGE_OVERLAYS&＃xff0c; DEVICE_PACKAGE_OVERLAYS&＃xff0c; PRODUCT_TAGS&＃xff0c; PRODUCT_OTA_PUBLIC_KEYS。
由PRODUCT_LOCALES导出PRODUCT_AAPT_CONFIG。
ADDITIONAL_BUILD_PROPERTIES中追加PRODUCT_PROPERTY_OVERRIDES中的值。
上面所说的这些值&＃xff0c;实际上都是在product的mk文件中定义。
9. node_fns.mk的分析
定义了一些命令。这些命令在product.mk&＃xff0c;device.mk&＃xff0c;和product_config.mk中会使用。这里重点说明import-nodes。
import-nodes需要3个入口参数&＃xff1a;
$(1)是一个字串&＃xff0c;是输出变量的主干名。例如”PRODUCTS"和”DEVICES“。
$(2)是一个makefile文件列表&＃xff0c;这些文件中应该含有对$(3)中变量的定义。
$(3)是一个变量列表。
import- nodes会创建这样形式的变量&＃xff0c;以$(1)&＃61;"PRODUCTS", $(2)中含有"build/target/product/core.mk", $(3)中含有"PRODUCT_NAME", 而且core.mk中定义了PRODUCT_NAME:&＃61;core为例&＃xff0c;
PRODUCT.build/target/product/core.mk.PRODUCT_NAME:&＃61;core
import- nodes中还考虑了inherit的问题&＃xff0c;如果某个PRODUCTS.XXX变量的值中有‘&＃64;inherit:
在product_config.mk中会说明$(2)中的mk文件列表是AndroidProducts.mk中的PRODUCT_MAKEFILES定义的。
node_fns.mk的代码真的很杀伤脑细胞...
10. product.mk的分析
product.mk构造了一些命令&＃xff0c;供product_config.mk中使用。
_find-android-products-files这个命令会得到device/和vendor/, 包括子目录&＃xff0c;以及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 :&＃61; /
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变量值中后缀上&＃39;&＃64;inherit:
check-all-products命令借助$(PRODUCTS)诸变量&＃xff0c;会对product进行唯一性检查和PRODUCT_NAME,PRODUCT_BRAND,PRODCUT_COPY_FILES的简单检查。
resolve-short-product-name命令&＃xff0c;给定Product的短名&＃xff0c;返回对应mk的路径。
11. device.mk的分析
同product.mk类似&＃xff0c;device.mk构造了一些命令。有resolve-short-device-name&＃xff0c;和import-devices。
Android Make脚本的简记(4)
内容提要
文档简要整理Android的make脚本的内容。以供备忘和参考。
1. config.mk的分析
首先&＃xff0c;包含pathmap.mk&＃xff0c; 其次&＃xff0c;定义了一些变量&＃xff0c;例如通用的编译参数&＃xff0c;package的后缀名等。
随后包含buildspec.mk。
接着包含envsetup.mk。envsetup.mk中会遍历所有product相关的路径&＃xff0c;载入所有支持的product的信息到变量集 PRODUCT.
然后包含$(board_config_mk)。$(board_config_mk)是位于 build/target/board/$(TARGET_DEVICE)/&＃xff0c;device/*/$(TARGET_DEVICE)/&＃xff0c;或vendor /*/$(TARGET_DEVICE)/目录下的BoardConfig.mk文件。 $(TARGET_DEVICE)已经在product_config.mk中定义了。在包含$(board_config_mk)之前&＃xff0c;会做检查&＃xff0c;多 个$(board_config_mk)存在则报错。
定义TARGET_DEVICE_DIR&＃xff0c;TARGET_BOOTLOADER_BOARD_NAME&＃xff0c;TARGET_CPU_ABI等跟board相关的变量。
接着&＃xff0c;依次以HOST_和TARGET_条件包含select.mk。这里说明TARGET_的select.mk。先定义combo_os_arch&＃xff0c; 通常是linux-arm&＃xff0c;然后定义各种跟编译链接相关的一些变量&＃xff0c;最后再包含进build/core/combo/TARGET_linux- arm.mk。
再包含javac.mk&＃xff0c;定义javac的命令和通用参数。
随后&＃xff0c;定义一些变量&＃xff0c;指向通用工具&＃xff0c;其中一些是os提供的&＃xff0c;例如YACC&＃xff1b;一些是froyo编译生成&＃xff0c;放在out/host/linux-x86/bin/下&＃xff0c;一些是预定义的脚本和工具&＃xff0c;例如MKTARBALL。
最后定义了一些编译链接变量&＃xff0c;这里专门列出&＃xff0c;
HOST_GLOBAL_CFLAGS &＃43;&＃61; $(COMMON_GLOBAL_CFLAGS)
HOST_RELEASE_CFLAGS &＃43;&＃61; $(COMMON_RELEASE_CFLAGS)
HOST_GLOBAL_CPPFLAGS &＃43;&＃61; $(COMMON_GLOBAL_CPPFLAGS)
HOST_RELEASE_CPPFLAGS &＃43;&＃61; $(COMMON_RELEASE_CPPFLAGS)
TARGET_GLOBAL_CFLAGS &＃43;&＃61; $(COMMON_GLOBAL_CFLAGS)
TARGET_RELEASE_CFLAGS &＃43;&＃61; $(COMMON_RELEASE_CFLAGS)
TARGET_GLOBAL_CPPFLAGS &＃43;&＃61; $(COMMON_GLOBAL_CPPFLAGS)
TARGET_RELEASE_CPPFLAGS &＃43;&＃61; $(COMMON_RELEASE_CPPFLAGS)
HOST_GLOBAL_LD_DIRS &＃43;&＃61; -L$(HOST_OUT_INTERMEDIATE_LIBRARIES)
TARGET_GLOBAL_LD_DIRS &＃43;&＃61; -L$(TARGET_OUT_INTERMEDIATE_LIBRARIES)
HOST_PROJECT_INCLUDES:&＃61; $(SRC_HEADERS) $(SRC_HOST_HEADERS) $(HOST_OUT_HEADERS)
TARGET_PROJECT_INCLUDES:&＃61; $(SRC_HEADERS) $(TARGET_OUT_HEADERS)
ifneq ($(TARGET_SIMULATOR),true)
TARGET_GLOBAL_CFLAGS &＃43;&＃61; $(TARGET_ERROR_FLAGS)
TARGET_GLOBAL_CPPFLAGS &＃43;&＃61; $(TARGET_ERROR_FLAGS)
endif
HOST_GLOBAL_CFLAGS &＃43;&＃61; $(HOST_RELEASE_CFLAGS)
HOST_GLOBAL_CPPFLAGS &＃43;&＃61; $(HOST_RELEASE_CPPFLAGS)
TARGET_GLOBAL_CFLAGS &＃43;&＃61; $(TARGET_RELEASE_CFLAGS)
TARGET_GLOBAL_CPPFLAGS &＃43;&＃61; $(TARGET_RELEASE_CPPFLAGS)
其中的TARGET_PROJECT_INCLUDES包含了SRC_HEADERS&＃xff0c;添加头文件路径的话&＃xff0c;可以改动SRC_HEADERS。
最后包含进dumpvar.mk
2. javac.mk的分析
javac.mk中会定义javac的编译命令和通用参数。
CUSTOM_JAVA_COMPILER做为javac.mk的入口参数&＃xff0c;可以考虑openjdk&＃xff0c;eclipse。不定义时则使用默认的javac。另外定义为openjdk时&＃xff0c;因为prebuilt/对应目录下没有相应的工具&＃xff0c;所以还不可用。
依次一般忽略定义CUSTOM_JAVA_COMPILER&＃xff0c;只要直接配置自己编译环境的path&＃xff0c;指向使用的javac就可以了。
javac在linux平台的定义是
javac -J-Xmx512M -target 1.5 -Xmaxerrs 9999999
-J-Xmx512M&＃xff0c;传递给vm launcher参数-Xmx512M&＃xff0c;告知起始空间设定为512M。
-target 1.5&＃xff0c;编译的结果适用1.5版本。
-Xmaxerrs 9999999&＃xff0c;最大输出的错误数是9999999。
3. dumpvar.mk的分析
dumpvar.mk 支持两种target: dumpvar-
使用方法&＃xff1a;假设位于$(TOPDIR)路径&＃xff0c;
CALLED_FROM_SETUP&＃61;true BUILD_SYSTEM&＃61;build/core make -f build/core/config.mk dumpvar-
或
CALLED_FROM_SETUP&＃61;true BUILD_SYSTEM&＃61;build/core make -f build/core/config.mk dumpvar-abs-
第一种形式&＃xff0c;返回varName的值。第二种形式&＃xff0c;返回varName的值&＃xff0c;前缀上路径。考虑到android脚本中广泛使用&＃39;:&＃61;’的变量定义方法&＃xff0c;因此&＃xff0c;基本上只能显示dumpvar.mk之前定义的变量值。LOCAL_xxxx的变量也不适用。
4. cleanbuild.mk的分析
main.mk在包含了config.mk后&＃xff0c;会包含进cleanbuild.mk。
定义了add-clean-step命令。有一个入口参数
$(1)&＃xff0c;执行删除操作的具体shell命令。
一般add-clean-step应当在%/cleanspec.mk脚本中使用&＃xff0c;命令会为$(1)定义一个变量保存&＃xff0c;变量的名字是 INTERNAL_STEP.$(_acs_id)&＃xff0c;所有的$(_acs_id)保存在INTERNAL_STEPS中。$(_acs_id)的值分成3 个部分构造
第一部分是有cleanspec.mk的路径转化而来&＃xff0c;用&＃39;_&＃39;替代&＃39;/&＃39;&＃xff0c;&＃39;-&＃39;替代&＃39;.&＃39;&＃xff0c;后缀_acs。第二部分 是$(INTERNAL_CLEAN_BUILD_VERSION)&＃xff0c;默认是4&＃xff0c;第三部分是有&＃39;&＃64;&＃39;组成&＃xff0c;cleanspec.mk中的第几个add- clean-step就用几个&＃64;。
例如&＃xff0c;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*)
那么&＃xff0c;对应的有
INTERNAL_STEP.packages_apps_Camera_CleanSpec-mk_acs4&＃64; :&＃61; rm -rf $(PRODUCT_OUT)/obj/APPS/Camera*
INTERNAL_STEP.packages_apps_Camera_CleanSpec-mk_acs4&＃64;&＃64; :&＃61; rm -rf $(OUT_DIR)/target/common/obj/APPS/Camera*
接着&＃xff0c;包扩进cleanspec.mk
包含进$(PRODUCT_OUT)/clean_steps.mk&＃xff0c;
接下来&＃xff0c;检查CURRENT_CLEAN_BUILD_VERSION是否与INTERNAL_CLEAN_BUILD_VERSION相同&＃xff0c;默认是4
如果相同&＃xff0c;
执行所有在INTERNAL_STEPS中登记的删除操作。
否则&＃xff0c;
删除 $(OUT_DIR)
然后&＃xff0c;重新生成$(PRODUCT_OUT)/clean_steps.mk&＃xff0c;写入"CURRENT_CLEAN_BUILD_VERSION :&＃61; $(INTERNAL_CLEAN_BUILD_VERSION)"和"CURRENT_CLEAN_STEPS :&＃61; $(INTERNAL_CLEAN_STEPS)"。
随后&＃xff0c;读入$(PRODUCT_OUT)/previous_build_config.mk&＃xff0c;看是否与当前的编译选项一致&＃xff0c;不一致则标明上次的中间文件 不可用&＃xff0c;则删除相应的中间目录&＃xff0c;或提示用户。接着重新将当前的信息写 入$(PRODUCT_OUT)/previous_build_config.mk&＃xff0c;格式是&＃xff0c;
current_build_config :&＃61; /
$(TARGET_PRODUCT)-$(TARGET_BUILD_VARIANT)$(building_sdk)-{$(locale_list)}
echo "PREVIOUS_BUILD_CONFIG :&＃61; $(current_build_config)" > /
$(previous_build_config_file)
最后&＃xff0c;定义了两个target&＃xff0c; installclean和dataclean。
dataclean删除的主要是./$(PRODUCT_OUT)/data/*&＃xff0c;
installclean的删除包括dataclean。installclean的本意是用于不同build_type编译时删除前次的中间文件。
总结cleanbuild.mk的内容&＃xff0c;就3件事&＃xff0c;一是载入所有的CleanSpec.mk&＃xff0c;二是检查更新clean_steps.mk和 previous_build_config.mk&＃xff0c;避免不同编译间的互相干扰。最后是&＃xff0c;定义installclean和dataclean。
5. cleanspec.mk的分析
首先定义
INTERNAL_CLEAN_BUILD_VERSION :&＃61; 4
接着使用findleaves.py遍历所有子目录&＃xff0c;找到CleanSpec.mk&＃xff0c;并包含进。用户可以在CleanSpec.mk中定义自己需要的删除操作。实际上还可以包含不仅仅是删除的操作。
至此&＃xff0c;INTERNAL_STEP.XXXX包含了所有CleanSpec.mk定义的clean动作。
6. version_checked.mk的分析
main.mk 在cleanbuild.mk后&＃xff0c;会借助$(OUT_DIR)/version_checked.mk检查版本&＃xff0c;如果版本不一致&＃xff0c;则重新检查系统文件系统 大小写敏感问题&＃xff0c;路径上是否含有空格&＃xff0c;java和javac的版本&＃xff0c;没有问题&＃xff0c;则更新version_checked.mk。
version_checked.mk中就定义了
VERSIONS_CHECKED :&＃61; $(VERSION_CHECK_SEQUENCE_NUMBER)
7. showcommands和checkbuild的说明
checkbuild貌似并未使用。
showcommands必须同其它target一同使用&＃xff0c;showcommands会详细打印出执行的具体命令内容。
8. definations.mk的说明
definations.mk中定义了大量的命令&＃xff0c;其它的mk文件将使用。这其中包括执行编译链接的命令&＃xff0c;通常是transform-XXX-to-XXX的形式&＃xff0c;例如&＃xff0c;transform-cpp-to-o。
其中的inherit-package命令有待研究...
Android101112: Android Make脚本的简记(5)
内容提要
文档简要整理Android的make脚本的内容。以供备忘和参考。
声明
仅限学习交流&＃xff0c;禁止商业用途。转载需注明出处。
1. Makefile的分析
首先定义target&＃xff0c; 用于生成$(OUT_DOCS)/index.html
再定义target&＃xff0c; 用于生成$(TARGET_ROOT_OUT)/default.prop
再定义target&＃xff0c; 用于生成$(TARGET_OUT)/build.prop。build.prop文件记录了一系列属性值。它的内容分成两部分&＃xff0c;第一部分是一些关于 product,device,build的一般性属性值&＃xff0c;第二部分的属性值源自ADDITIONAL_BUILD_PROPERTIES。 product配置mk文件中定义的PRODUCT_PROPERTY_OVERRIDES会加入到 ADDITIONAL_BUILD_PROPERTIES&＃xff0c;建议增加property时&＃xff0c;直接修改 PRODUCT_PROPERTY_OVERRIDES。
再定义target&＃xff0c; 用于生成$(PRODUCT_OUT)/sdk/sdk-build.prop
再定义target&＃xff0c;package-stats&＃xff0c;用于生成$(PRODUCT_OUT)/package-stats.txt&＃xff0c;这个文件包含了.jar,.apk后缀文件的信息。
再定义target&＃xff0c;apkcerts-list&＃xff0c;用于生成$(name)-apkcerts-$(FILE_NAME_TAG)&＃xff0c;描述各module的certificate和private_key文件信息。
接着&＃xff0c;如果定义了CREATE_MODULE_INFO_FILE&＃xff0c;则生成$(PRODUCT_OUT)/module-info.txt&＃xff0c;其中包含了描述所有module的信息。
再定义target&＃xff0c;event-log-tags。
接着&＃xff0c;处理ramdisk.img
再处理boot.img&＃xff0c;如果TARGET_NO_KERNEL不是true&＃xff0c;则将kernel和ramdisk.img组装成boot.img。
接着&＃xff0c;定影命令combine-notice-files&＃xff0c;用于生成target&＃xff0c;notice_files。notice_files会抽取生成相应的声明文件。
随后&＃xff0c;建立target&＃xff0c;otacert&＃xff0c;用于将.x509.pem后缀的认证文件打包存放到$(TARGET_OUT_ETC)/security/otacerts.zip。
接着&＃xff0c;建立target&＃xff0c;recoveryimage&＃xff0c;处理recovery img
还有下面的target,
systemimage-nodeps&＃xff0c; snod
systemtarball-nodeps&＃xff0c;stnod
boottarball-nodeps&＃xff0c;btnod
userdataimage-nodeps
userdatatarball-nodeps
otatools
target-files-package
otapackage
installed-file-list
tests-zip-package
dalvikfiles
updatepackage
最后包含进 build/core/task/下的mk文件。
京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有 