Android编译系统详解 配置文件
++++++++++++++++++++++++++++++++++++++++++
本文系本站原创,欢迎转载! 转载请注明出处:
http://blog.csdn.net/mr_raptor/article/details/7540066
++++++++++++++++++++++++++++++++++++++++++
Android编译系统详解（一）：http://blog.csdn.net/mr_raptor/article/details/7539978
Android编译系统详解（二）：http://blog.csdn.net/mr_raptor/article/details/7540066
Android编译系统详解（三）：http://blog.csdn.net/mr_raptor/article/details/7540730
通过上篇文章，我们分析了编译android时source build/envsetup.sh和lunch命令，在执行完上述两个命令后， 我们就可以进行编译android了。
1. make
执行make命令的结果就是去执行当前目录下的Makefile文件，我们来看下它的内容：
[html] view plain copy- 1###DONOTEDITTHISFILE###
- 2includebuild/core/main.mk
- 3###DONOTEDITTHISFILE###
呵呵，看到上面 的内容，我们都会笑，这是我见过最简单的Makefile了，我们再看下build/core/main.mk
main.mk文件里虽然脚本不多，但是却定义了整个Android的编译关系，它主要引入了下列几个重要的mk文件：
49 include $(BUILD_SYSTEM)/config.mk
55 include $(BUILD_SYSTEM)/cleanbuild.mk
142 include $(BUILD_SYSTEM)/definitions.mk
当然每个mk文件都有自己独特的意义，我一并将主线流程通过下面这个图各表现出来，先有个整体的概念，然后再细化了解。
所有的Makefile都通过build/core/main.mk这个文件组织在一起，它定义了一个默认goals：droid，当我们在TOP目录下，敲Make实际上就等同于我们执行make droid。
当Make include所有的文件，完成对所有make我文件的解析以后就会寻找生成droid的规则，依次生成它的依赖，直到所有满足的模块被编译好，然后使用相应的工具打包成相应的img。其中，config.mk，envsetup.mk，product_config.mk文件是编译用户指定平台系统的关键文件。上图中红色部分是用户指定平台产品的编译主线，我们先来看下config.mk的主要作用。
2.build/core/config.mk
该文件被main.mk包含。
定义了以下环境变量：
[plain] view plain copy- 16SRC_HEADERS:=\
- 17$(TOPDIR)system/core/include\
- 18$(TOPDIR)hardware/libhardware/include\
- 19$(TOPDIR)hardware/libhardware_legacy/include\
- 20$(TOPDIR)hardware/ril/include\
- 21$(TOPDIR)dalvik/libnativehelper/include\
- 22$(TOPDIR)frameworks/base/include\
- 23$(TOPDIR)frameworks/base/opengl/include\
- 24$(TOPDIR)external/skia/include
- 25SRC_HOST_HEADERS:=$(TOPDIR)tools/include
- 26SRC_LIBRARIES:=$(TOPDIR)libs
- 27SRC_SERVERS:=$(TOPDIR)servers
- 28SRC_TARGET_DIR:=$(TOPDIR)build/target
- 29SRC_API_DIR:=$(TOPDIR)frameworks/base/api
- .....然后定义了下面的重要的编译命令
- 43CLEAR_VARS:=$(BUILD_SYSTEM)/clear_vars.mk
- 44BUILD_HOST_STATIC_LIBRARY:=$(BUILD_SYSTEM)/host_static_library.mk
- 45BUILD_HOST_SHARED_LIBRARY:=$(BUILD_SYSTEM)/host_shared_library.mk
- 46BUILD_STATIC_LIBRARY:=$(BUILD_SYSTEM)/static_library.mk
- 47BUILD_RAW_STATIC_LIBRARY:=$(BUILD_SYSTEM)/raw_static_library.mk
- 48BUILD_SHARED_LIBRARY:=$(BUILD_SYSTEM)/shared_library.mk
- 49BUILD_EXECUTABLE:=$(BUILD_SYSTEM)/executable.mk
- 50BUILD_RAW_EXECUTABLE:=$(BUILD_SYSTEM)/raw_executable.mk
- 51BUILD_HOST_EXECUTABLE:=$(BUILD_SYSTEM)/host_executable.mk
- 52BUILD_PACKAGE:=$(BUILD_SYSTEM)/package.mk
- 53BUILD_HOST_PREBUILT:=$(BUILD_SYSTEM)/host_prebuilt.mk
- 54BUILD_PREBUILT:=$(BUILD_SYSTEM)/prebuilt.mk
- 55BUILD_MULTI_PREBUILT:=$(BUILD_SYSTEM)/multi_prebuilt.mk
- 56BUILD_JAVA_LIBRARY:=$(BUILD_SYSTEM)/java_library.mk
- 57BUILD_STATIC_JAVA_LIBRARY:=$(BUILD_SYSTEM)/static_java_library.mk
- 58BUILD_HOST_JAVA_LIBRARY:=$(BUILD_SYSTEM)/host_java_library.mk
- 59BUILD_DROIDDOC:=$(BUILD_SYSTEM)/droiddoc.mk
- 60BUILD_COPY_HEADERS:=$(BUILD_SYSTEM)/copy_headers.mk
- 61BUILD_KEY_CHAR_MAP:=$(BUILD_SYSTEM)/key_char_map.mk
上述命令变量其实是对应的mk文件名，几乎所有的Android.mk文件里基本上都包含上述命令变量，如：
CLEAR_VARS：用来清除之前定义的环境变量
BUILD_SHARED_LIBRARY：用来指定编译动态库过程
[plain] view plain copy- 109#---------------------------------------------------------------
- 110#Definemostoftheglobalvariables.Thesearetheonesthat
- 111#arespecifictotheuser'sbuildconfiguration.
- ###evnsetup.mk文件里定义了大部分的全局变量，用户使用这些变量来编译系统
- 112include$(BUILD_SYSTEM)/envsetup.mk
- 113
- 114#Boardsmaybedefinedunder$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)
- 115#orundervendor/*/$(TARGET_DEVICE).Searchinbothplaces,but
- 116#makesureonlyoneexists.
- 117#RealboardsshouldalwaysbeassociatedwithanOEMvendor.
- ###板级配置信息通常定义在$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)或vendor/*/$(TARGET_DEVICE)下面，从这两个地方搜索，但是只能有一个地方存在板级配置信息（TARGET_DEVICE变量在上面的envsetup.mk里定义）
- ###wildcard命令用于在某个目录下查找匹配的文件，将找到的文件列表返回
- 118board_config_mk:=\
- 119$(strip$(wildcard\
- 120$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk\
- 121vendor/*/$(TARGET_DEVICE)/BoardConfig.mk\
- 122))
- ###如果没有找到，提示出错
- 123ifeq($(board_config_mk),)
- 124$(errorNoconfigfilefoundforTARGET_DEVICE$(TARGET_DEVICE))
- 125endif
- ###如果找到了1个以上时，提示出错
- 126ifneq($(words$(board_config_mk)),1)
- 127$(errorMultipleboardconfigfilesforTARGET_DEVICE$(TARGET_DEVICE):$(board_config_mk))
- 128endif
- 129include$(board_config_mk)#将板级配置信息包含进来
- 130TARGET_DEVICE_DIR:=$(patsubst%/,%,$(dir$(board_config_mk)))
- 131board_config_mk:=
3. envsetup.mk
[plain] view plain copy- 25ifeq($(TARGET_PRODUCT),)#如果TARGET_PRODUCT为空
- 26ifeq($(TARGET_SIMULATOR),true)#编译为模拟器
- 27TARGET_PRODUCT:=sim
- 28else
- 29TARGET_PRODUCT:=generic#默认产品名字为generic
- 30endif
- 31endif
[plain] view plain copy
- 34#thevariant--thesetoffilesthatareincludedforabuild
- 35ifeq($(strip$(TARGET_BUILD_VARIANT)),)#如果编译版本型号变量为空
- 36TARGET_BUILD_VARIANT:=eng
- 37endif
- 38
- 39#ReadtheproductspecssoweangetTARGET_DEVICEandother
- 40#variablesthatweneedinordertolocatetheoutputfiles.
- ##product_config.mk文件，读取产品配置信息，从而得到目标设备，将其导出到TARGET_DEVICE变量里，后面的定义的OUT变量的值，也依赖于目标设备TARGET_DEVICE，用于指定目标代码的输出目录
- 41include$(BUILD_SYSTEM)/product_config.mk
- 148#---------------------------------------------------------------
- 149#figureouttheoutputdirectories
- 150
- 151ifeq(,$(strip$(OUT_DIR)))
- 152OUT_DIR:=$(TOPDIR)out
- 153endif
- 154
- 155DEBUG_OUT_DIR:=$(OUT_DIR)/debug
- 156
- 157#Movethehostortargetunderthedebug/directory
- 158#ifnecessary.
- 159TARGET_OUT_ROOT_release:=$(OUT_DIR)/target
- 160TARGET_OUT_ROOT_debug:=$(DEBUG_OUT_DIR)/target
- 161TARGET_OUT_ROOT:=$(TARGET_OUT_ROOT_$(TARGET_BUILD_TYPE))
- 162
- ...
- ###这个重要的OUT变量，依赖于目标设备名TARGET_DEVICE
- 184PRODUCT_OUT:=$(TARGET_PRODUCT_OUT_ROOT)/$(TARGET_DEVICE)
- 187
- 188HOST_OUT_EXECUTABLES:=$(HOST_OUT)/bin
- 189HOST_OUT_SHARED_LIBRARIES:=$(HOST_OUT)/lib
- 190HOST_OUT_JAVA_LIBRARIES:=$(HOST_OUT)/framework
- 191HOST_OUT_SDK_ADDON:=$(HOST_OUT)/sdk_addon
- ...
- 200TARGET_OUT_INTERMEDIATES:=$(PRODUCT_OUT)/obj
- 201TARGET_OUT_HEADERS:=$(TARGET_OUT_INTERMEDIATES)/include
- 202TARGET_OUT_INTERMEDIATE_LIBRARIES:=$(TARGET_OUT_INTERMEDIATES)/lib
- 203TARGET_OUT_COMMON_INTERMEDIATES:=$(TARGET_COMMON_OUT_ROOT)/obj
- 204
- ###后面的OUT变量都要间接依赖于TARGET_DEVICE
- 205TARGET_OUT:=PRODUCT_OUT)/system
- 206TARGET_OUT_EXECUTABLES:=$(TARGET_OUT)/bin
- 207TARGET_OUT_OPTIONAL_EXECUTABLES:=$(TARGET_OUT)/xbin
- 208TARGET_OUT_SHARED_LIBRARIES:=$(TARGET_OUT)/lib
- 209TARGET_OUT_JAVA_LIBRARIES:=$(TARGET_OUT)/framework
- 210TARGET_OUT_APPS:=$(TARGET_OUT)/app
- 211TARGET_OUT_KEYLAYOUT:=$(TARGET_OUT)/usr/keylayout
- 212TARGET_OUT_KEYCHARS:=$(TARGET_OUT)/usr/keychars
- 213TARGET_OUT_ETC:=$(TARGET_OUT)/etc
- 214TARGET_OUT_STATIC_LIBRARIES:=$(TARGET_OUT_INTERMEDIATES)/lib
- 215TARGET_OUT_NOTICE_FILES:=$(TARGET_OUT_INTERMEDIATES)/NOTICE_FILES
- 216
- 217TARGET_OUT_DATA:=$(<strong>PRODUCT_OUT</strong>)/data
- 218TARGET_OUT_DATA_EXECUTABLES:=$(TARGET_OUT_EXECUTABLES)
- 219TARGET_OUT_DATA_SHARED_LIBRARIES:=$(TARGET_OUT_SHARED_LIBRARIES)
- 220TARGET_OUT_DATA_JAVA_LIBRARIES:=$(TARGET_OUT_JAVA_LIBRARIES)
- 221TARGET_OUT_DATA_APPS:=$(TARGET_OUT_DATA)/app
- 222TARGET_OUT_DATA_KEYLAYOUT:=$(TARGET_OUT_KEYLAYOUT)
- 223TARGET_OUT_DATA_KEYCHARS:=$(TARGET_OUT_KEYCHARS)
- 224TARGET_OUT_DATA_ETC:=$(TARGET_OUT_ETC)
- 225TARGET_OUT_DATA_STATIC_LIBRARIES:=$(TARGET_OUT_STATIC_LIBRARIES)
- 226
- 227TARGET_OUT_UNSTRIPPED:=$(<strong>PRODUCT_OUT</strong>)/symbols
- 228TARGET_OUT_EXECUTABLES_UNSTRIPPED:=$(TARGET_OUT_UNSTRIPPED)/system/bin
- 229TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED:=$(TARGET_OUT_UNSTRIPPED)/system/lib
- 230TARGET_ROOT_OUT_UNSTRIPPED:=$(TARGET_OUT_UNSTRIPPED)
- 231TARGET_ROOT_OUT_SBIN_UNSTRIPPED:=$(TARGET_OUT_UNSTRIPPED)/sbin
- 232TARGET_ROOT_OUT_BIN_UNSTRIPPED:=$(TARGET_OUT_UNSTRIPPED)/bin
- 233
- 234TARGET_ROOT_OUT:=$(<strong>PRODUCT_OUT</strong>)/root
- 235TARGET_ROOT_OUT_BIN:=$(TARGET_ROOT_OUT)/bin
- 236TARGET_ROOT_OUT_SBIN:=$(TARGET_ROOT_OUT)/sbin
- 237TARGET_ROOT_OUT_ETC:=$(TARGET_ROOT_OUT)/etc
- 238TARGET_ROOT_OUT_USR:=$(TARGET_ROOT_OUT)/usr
- 239
- 240TARGET_RECOVERY_OUT:=$(<strong>PRODUCT_OUT</strong>)/recovery
- 241TARGET_RECOVERY_ROOT_OUT:=$(TARGET_RECOVERY_OUT)/root
- 242
- 243TARGET_SYSLOADER_OUT:=$(<strong>PRODUCT_OUT</strong>)/sysloader
- 244TARGET_SYSLOADER_ROOT_OUT:=$(TARGET_SYSLOADER_OUT)/root
- 245TARGET_SYSLOADER_SYSTEM_OUT:=$(TARGET_SYSLOADER_OUT)/root/system
- 246
- 247TARGET_INSTALLER_OUT:=$(<strong>PRODUCT_OUT</strong>)/installer
- 248TARGET_INSTALLER_DATA_OUT:=$(TARGET_INSTALLER_OUT)/data
- 249TARGET_INSTALLER_ROOT_OUT:=$(TARGET_INSTALLER_OUT)/root
- 250TARGET_INSTALLER_SYSTEM_OUT:=$(TARGET_INSTALLER_OUT)/root/system
- TARGET_OUT=$(<strong>PRODUCT_OUT</strong>)/system
- TARGET_OUT_EXECUTABLES=$(PRODUCT_OUT)/system/bin
- TARGET_OUT_SHARED_LIBRARIES=$(PRODUCT_OUT)/system/lib
- TARGET_OUT_JAVA_LIBRARIES=$(PRODUCT_OUT)/system/framework
- TARGET_OUT_APPS=$(PRODUCT_OUT)/system/app
- TARGET_OUT_ETC=$(PRODUCT_OUT)/system/etc
- TARGET_OUT_STATIC_LIBRARIES=$(PRODUCT_OUT)/obj/lib
- TARGET_OUT_DATA=$(PRODUCT_OUT)/data
- TARGET_OUT_DATA_APPS=$(PRODUCT_OUT)/data/app
- TARGET_ROOT_OUT=$(PRODUCT_OUT)/root
- TARGET_ROOT_OUT_BIN=$(PRODUCT_OUT)/bin
- TARGET_ROOT_OUT_SBIN=$(PRODUCT_OUT)/system/sbin
- TARGET_ROOT_OUT_ETC=$(PRODUCT_OUT)/system/etc
- TARGET_ROOT_OUT_USR=$(PRODUCT_OUT)/system/usr
总结下：
envsetup.mk文件主要包含了product_config.mk文件，然后指定了编译时要输出的所有文件的OUT目录，这些OUT目录变量依赖于TARGET_DEVICE变量。
4. build/core/product_config.mk [plain] view plain copy
- 157include$(BUILD_SYSTEM)/product.mk
- ...
- 160#ReadinalloftheproductdefinitionsspecifiedbytheAndroidProducts.mk
- 161#filesinthetree.
- 162#
- 163#TODO:whenwestartallowingdirectpointerstoproductfiles,
- 164#guaranteethatthey'reinthislist.
- 165$(callimport-products,$(get-all-product-makefiles))
- 166$(check-all-products)
- ...
- 170#Convertashortnamelike"sooner"intothepathtotheproduct
- 171#filedefiningthatproduct.
- 172#
- 173INTERNAL_PRODUCT:=$(callresolve-short-product-name,$(TARGET_PRODUCT))
- ...
- 176#Findthedevicethatthisproductmapsto.
- 177TARGET_DEVICE:=$(PRODUCTS.$(INTERNAL_PRODUCT).PRODUCT_DEVICE)
165行，调用函数import-products, $(get-all-product-makefiles)，这儿我们看上面的注释：
Read in all of the product definitions specified by the AndroidProducts.mkfiles in the tree.
TODO: when we start allowing direct pointers to product files,guarantee that they're in this list.
意思是说：读取厂商目录下（vendor/*/products/AndroidProducts.mk）所有的AndrodProducts.mk文件中定义的产品信息
其实get-all-product-makefiles返回厂商全部产品文件xxx.mk
import-products函数去验证这些产品配置文件是否都包含有必须的配置信息，细节后面分析。
173行调用了resolve-short-product-name函数，它将根据产品TARGET_PRODUCT，返回该产品配置文件的完整路径，并赋给INTERNAL_PRODUCT
例如TARGET_PRODUCT=fs100，则：
INTERNAL_PRODUCT =vendor/farsight/products/fs100.mk
TARGET_DEVICE = fs100
如果调试看其结果，可以在167行，将#$(dump-product)取消注释
然后在175行添加： $(info $(INTERNAL_PRODUCT))
在178行添加：$(info $(TARGET_DEVICE))，查看调试结果。
总结一下：
接合前面的图，product_config.mk主要读取vendor目录下不同厂商自己定义的AndrodProducts.mk文件(vendor/*/products/AndroidProducts.mk)，从该文件里取得所有产品的配置文件，然后再根据lunch选择的编译项TARGET_PRODUCT，找到与之对应的配置文件，然后读取产品配置文件，找到里面的PRODUCT_DEVICE的值，设置给TARGET_DEVICE变量，用于后续编译。
5.build/core/product.mk
[plain] view plain copy- 17#
- 18#FunctionsforincludingAndroidProducts.mkfiles
- 19#
- 20
- 21#
- 22#ReturnsthelistofallAndroidProducts.mkfiles.
- 23#$(call)isn'tnecessary.
- 24#
- 25define<strong>_find-android-products-files</strong>
- 26$(shelltest-dvendor&&findvendor-maxdepth6-nameAndroidProducts.mk)\
- 27$(SRC_TARGET_DIR)/product/AndroidProducts.mk
- 28endef
- 29
- 30#
- 31#ReturnsthesortedconcatenationofallPRODUCT_MAKEFILES
- 32#variablessetinallAndroidProducts.mkfiles.
- 33#$(call)isn'tnecessary.
- 34#
- 35define<strong>get-all-product-makefiles</strong>
- 36$(sort\
- 37$(foreachf,$(_find-android-products-files),\
- 38$(evalPRODUCT_MAKEFILES:=)\
- 39$(evalLOCAL_DIR:=$(patsubst%/,%,$(dir$(f))))\
- 40$(evalinclude$(f))\
- 41$(PRODUCT_MAKEFILES)\
- 42)\
- 43$(evalPRODUCT_MAKEFILES:=)\
- 44$(evalLOCAL_DIR:=)\
- 45)
- 46endef
_find-android-products-files:
用来获得vendor目录下，所有名字为AndroidProduct.mk的文件列表。
get-all-product-makefiles：
用来获得所有AndroidProduct.mk文件里定义的PRODUCT_MAKEFILES的值（其实是产品文件路径名）。
在vendor目录下，每个厂商子目录下都会存在一个AndroidProduct.mk文件，这个文件是用来定义这个厂商的产品列表，每个产品用<product_name>.mk来表示
如Android给的示例：
- vendor/sample/products/AndroidProduct.mk
[plain] view plain copy
- 1#
- 2#ThisfileshouldsetPRODUCT_MAKEFILEStoalistofproductmakefiles
- 3#toexposetothebuildsystem.LOCAL_DIRwillalreadybesetto
- 4#thedirectorycontainingthisfile.
- 5#
- 6#Thisfilemaynotrelyonthevalueofanyvariableotherthan
- 7#LOCAL_DIR;donotuseanyconditionals,anddonotlookupthe
- 8#valueofanyvariablethatisn'tsetinthisfileorinafilethat
- 9#itincludes.
- 10#
- 11
- 12PRODUCT_MAKEFILES:=\
- 13$(LOCAL_DIR)/sample_addon.mk
[plain] view plain copy
- 1#Listofappsandoptionallibraries(Javaandnative)toputintheadd-onsystemimage.
- 2PRODUCT_PACKAGES:=\
- 3PlatformLibraryClient\
- 4com.example.android.platform_library\
- 5libplatform_library_jni
由此可见，get-all-product-makefiles函数，其实就是返回了当前公司里全部的产品对应的mk文件列表。
总结：
如果用户想个性定制自己的产品，应该有以下流程，包含上一节内容：
注：#表示shell提示符
1.创建厂商目录
#mkdir vendor/farsight
2. 创建一个vendorsetup.sh文件，将当前产品编译项添加到lunch里，让lunch能找到用户产品编译项
#echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh
注：我们增加一个用户产品编译项，fs100-eng
3. 仿着Android示例代码，在厂商目录下创建products目录
#mkdir -p vendor/farsight/products
4.仿着Android示例代码，在products目录下创建两个mk文件
#touch vendor/farsight/products/AndroidProduct.mk vendor/farsight/products/fs100.mk
注：其中AndroidProduct.mk是当前厂商产品列表文件，fs100.mk表示当前厂商的一款产品配置文件
在AndroidProduct.mk里添加如下内容：
[plain] view plain copy- PRODUCT_MAKEFILES:=$(LOCAL_DIR)/fs100.mk
5. 在产品配置文件里添加最基本信息
[plain] view plain copy- 1
- 2PRODUCT_PACKAGES:=\
- 3IM\
- 4VoiceDialer
- 5
- 6$(callinherit-product,build/target/product/generic.mk)##从某一默认配置开始派生余下内容参考派生起点
- 7
- 8#Overrides
- 9PRODUCT_MANUFACTURER:=farsight
- 10PRODUCT_NAME:=fs100
- 11PRODUCT_DEVICE:=fs100
一定要注意：
PRODUCT_NAME：表示产品名字，它要和最终出现的编译项产品名一致，也就是说fs100-eng
PRODUCT_DEVICE：表示设备名字，它要和将来创建的设备目录名字一致。
更多相关文章
- Android中手机文件储存路径
- Android: R cannot be resolved to a variable
- [android]system.img文件的打包和解包
- Android中遇到问题：file.delete()不能删除文件
- android 2.3.3编译 安装 Settings应用
- Android(安卓)zip文件压缩
- android打开文件及打开方式（打开程序列表）
- AndroidManifest.xml文件详解（supports-screens）
- NPM 和webpack 的基础使用