Android编译过程详解

分别摘自：

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编译过程详解（一）：http://blog.csdn.net/mr_raptor/article/details/7539978

Android的优势就在于其开源，手机和平板生产商可以根据自己的硬件进行个性定制自己的手机产品，如小米，LePhone，M9等，因此，在我们在对Android的源码进行定制的时候，很有必要了解下，Android的编译过程。

如果你从来没有做过Android代码的编译，那么最官方的编译过程就是查看Android的官方网站：http://source.android.com/source/building.html

但是，这儿只是告诉你了如何去编译一个通用的系统，并没有详细告诉你细节，我们跟着编译过程来了解下。

+--------------------------------------------------------------------------------------------------------------------+

本文使用Android版本为2.1，采用开发板为华清远见研发的FS_S5PC100 A8开发板。

+--------------------------------------------------------------------------------------------------------------------+

1. source build/envsetup.sh

这个命令是用来将envsetup.sh里的所有用到的命令加载到环境变量里去，我们来分析下它。

envsetup.sh里的主要命令如下：

[plain] view plain copy

functionhelp()　　　　　　　　　　　　　　　　　#显示帮助信息
functionget_abs_build_var()　　　　　　　　　　　#获取绝对变量
functionget_build_var()　　　　　　　　　　　　　#获取绝对变量
functioncheck_product()　　　　　　　　　　　　　#检查product
functioncheck_variant()　　　　　　　　　　　　　#检查变量
functionsetpaths()　　　　　　　　　　　　　　　#设置文件路径
functionprintconfig()　　　　　　　　　　　　　　#打印配置
functionset_stuff_for_environment()　　　　　　#设置环境变量
functionset_sequence_number()　　　　　　　　#设置序号
functionsettitle()　　　　　　　　　　　　　　　#设置标题
functionchoosetype()　　　　　　　　　　　　　　#设置type
functionchooseproduct()　　　　　　　　　　　　#设置product
functionchoosevariant()　　　　　　　　　　　　#设置variant
functiontapas()　　　　　　　　　　　　　　　　#功能同choosecombo
functionchoosecombo()　　　　　　　　　　　　　#设置编译参数
functionadd_lunch_combo()　　　　　　　　　　　#添加lunch项目
functionprint_lunch_menu()　　　　　　　　　　　#打印lunch列表
functionlunch()　　　　　　　　　　　　　　　　　#配置lunch
functionm()　　　　　　　　　　　　　　　　　　　#makefromtop
functionfindmakefile()　　　　　　　　　　　　　#查找makefile
functionmm()　　　　　　　　　　　　　　　　　　#makefromcurrentdirectory
functionmmm()　　　　　　　　　　　　　　　　　#makethesupplieddirectories
functioncroot()　　　　　　　　　　　　　　　　　#回到根目录
functioncproj()
functionpid()
functionsystemstack()
functiongdbclient()
functionjgrep()　　　　　　　　　　　　　　　　　#查找java文件
functioncgrep()　　　　　　　　　　　　　　　　#查找c/cpp文件
functionresgrep()
functiontracedmdump()
functionrunhat()
functiongetbugreports()
functionstartviewserver()
functionstopviewserver()
functionisviewserverstarted()
functionsmoketest()
functionruntest()
functiongodir()　　　　　　　　　　　　　　　　#跳到指定目录
#这是系统自动增加了一个默认的编译项generic-eng
#addthedefaultonehere
add_lunch_combogeneric-eng
#下面的代码很重要，它要从vendor目录下查找vendorsetup.sh文件，如果查到了，就加载它
#Executethecontentsofanyvendorsetup.shfileswecanfind.
forfin`/bin/lsvendor/*/vendorsetup.shvendor/*/build/vendorsetup.sh2>/dev/null`
do
echo"including$f"
.$f
done

根据上面的内容，可以推测出，如果要想定义自己的产品编译项，简单的办法是直接在envsetup.sh最后，添加上add_lunch_combo myProduct-eng，当然这么做，不太符合上面代码最后的本意，我们还是老实的在vendor目录下创建自己公司名字，然后在公司目录下创建一个新的vendorsetup.sh，在里面添加上自己的产品编译项

[plain] view plain copy

#mkdirvendor/farsight/
#touchvendor/farsight/vendorsetup.sh
#echo"add_lunch_combofs100-eng">vendor/farsight/vendorsetup.sh

这样，当我们在执行source build/envsetup.sh命令的时候，可以在shell上看到下面的信息：

[plain] view plain copy

includingvendor/farsight/vendorsetup.sh

2. 按照android官网的步骤，开始执行lunch full-eng

当然如果你按上述命令执行，它编译的还是通用的eng版本系统，不是我们个性系统，我们可以执行lunch命令，它会打印出一个选择菜单，列出可用的编译选项

如果你按照第一步中添加了vendorsetup.sh那么，你的选项中会出现：

[plain] view plain copy

You'rebuildingonLinux
generic-engsimulatorfs100-eng
Lunchmenu...pickacombo:
1.generic-eng
2.simulator
3.fs100-eng

其中第3项是我们自己添加的编译项。

lunch命令是envsetup.sh里定义的一个命令，用来让用户选择编译项，来定义Product和编译过程中用到的全局变量。

我们一直没有说明前面的fs100-eng是什么意思，现在来说明下，fs100是我定义的产品的名字，eng是产品的编译类型，除了eng外，还有user, userdebug，分别表示：

eng: 工程机，

user:最终用户机

userdebug:调试测试机

由此可见，除了eng和user外，另外两个一般不能交给最终用户的，记得m8出来的时候，先放出了一部分eng工程机，然后出来了user机之后，可以用工程机换。

好了，我们来分析下lunch命令干了什么？

[plain] view plain copy

functionlunch()
{
localanswer
if["$1"];then
#lunch后面直接带参数
answer=$1
else
#lunch后面不带参数，则打印处所有的targetproduct和variant菜单提供用户选择
print_lunch_menu
echo-n"Whichwouldyoulike?[generic-eng]"
readanswer
fi
localselection=
if[-z"$answer"]
then
#如果用户在菜单中没有选择，直接回车，则为系统缺省的generic-eng
selection=generic-eng
elif["$answer"="simulator"]
then
#如果是模拟器
selection=simulator
elif(echo-n$answer|grep-q-e"^[0-9][0-9]*$")
then
#如果answer是选择菜单的数字，则获取该数字对应的字符串
if[$answer-le${#LUNCH_MENU_CHOICES[@]}]
then
selection=${LUNCH_MENU_CHOICES[$(($answer-$_arrayoffset))]}
fi
#如果answer字符串匹配*-*模式(*的开头不能为-)
elif(echo-n$answer|grep-q-e"^[^\-][^\-]*-[^\-][^\-]*$")
then
selection=$answer
fi
if[-z"$selection"]
then
echo
echo"Invalidlunchcombo:$answer"
return1
fi
#specialcasethesimulator
if["$selection"="simulator"]
then
#模拟器模式
exportTARGET_PRODUCT=sim
exportTARGET_BUILD_VARIANT=eng
exportTARGET_SIMULATOR=true
exportTARGET_BUILD_TYPE=debug
else
#将product-variant模式种的product分离出来
localproduct=$(echo-n$selection|sed-e"s/-.*$//")
#检查之，调用关系check_product()->get_build_var()->build/core/config.mk比较罗嗦，不展开了
check_product$product
if[$?-ne0]
then
echo
echo"**Don'thaveaproductspecfor:'$product'"
echo"**Doyouhavetherightrepomanifest?"
product=
fi
#将product-variant模式种的variant分离出来
localvariant=$(echo-n$selection|sed-e"s/^[^\-]*-//")
#检查之，看看是否在(useruserdebugeng)范围内
check_variant$variant
if[$?-ne0]
then
echo
echo"**Invalidvariant:'$variant'"
echo"**Mustbeoneof${VARIANT_CHOICES[@]}"
variant=
fi
if[-z"$product"-o-z"$variant"]
then
echo
return1
fi
<spanstyle="WHITE-SPACE:pre">#导出环境变量，这儿很重要，因为后面的编译系统都是依赖于这里定义的几个变量的
exportTARGET_PRODUCT=$product
exportTARGET_BUILD_VARIANT=$variant
exportTARGET_SIMULATOR=false
exportTARGET_BUILD_TYPE=release
fi#!simulator
echo
#设置到环境变量，比较多，不再一一列出，最简单的方法set>env.txt可获得
set_stuff_for_environment
#打印一些主要的变量,调用关系printconfig()->get_build_var()->build/core/config.mk->build/core/envsetup.mk比较罗嗦，不展开了
printconfig
}

由上面分析可知，lunch命令可以带参数和不带参数，最终导出一些重要的环境变量，从而影响编译系统的编译结果。导出的变量如下（以实际运行情况为例）

[plain] view plain copy

TARGET_PRODUCT=fs100
TARGET_BUILD_VARIANT=eng
TARGET_SIMULATOR=false
TARGET_BUILD_TYPE=release

执行完上述两个步骤，就该执行：make命令了，下篇来分析。

Android编译过程详解（二）：http://blog.csdn.net/mr_raptor/article/details/7540066

通过上篇文章，我们分析了编译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里，定义了变量TOPDIR，TOP为当前目录，BUILD_SYSTEM为build/core目录。

在49行，包含了build/core/config.mk文件。

后面的代码是check环境变量，所有的Makefile都通过build/core/main.mk这个文件组织在一起，它定义了一个默认goals：droid，当我们在TOP目录下，敲Make实际上就等同于我们执行make droid。当Make include所有的文件，完成对所有make我文件的解析以后就会寻找生成droid的规则，依次生成它的依赖，直到所有满足的模块被编译好，然后使用相应的工具打包成相应的img。这儿不是我们的重点，不再多说。

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

[plain] view plain copy

.....然后定义了下面几个重要的编译命令

[plain] view plain copy

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.
112include$(BUILD_SYSTEM)/envsetup.mk
113
114#Boardsmaybedefinedunder$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)
115#orundervendor/*/$(TARGET_DEVICE).Searchinbothplaces,but
116#makesureonlyoneexists.
117#RealboardsshouldalwaysbeassociatedwithanOEMvendor.
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
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:=

112行又包含了另外一个重要的mk文件envsetup.mk，我们来看一下。

3. envsetup.mk

[plain] view plain copy

25ifeq($(TARGET_PRODUCT),)#判断TARGET_PRODUCT是否为空，
26ifeq($(TARGET_SIMULATOR),true)
27TARGET_PRODUCT:=sim
28else
29TARGET_PRODUCT:=generic
30endif
31endif

第25行，判断 TARGET_PRODUCT是否为空，根据上一节分析可知， TARGET_PRODUCT=fs100
[plain] view plain copy

34#thevariant--thesetoffilesthatareincludedforabuild
35ifeq($(strip$(TARGET_BUILD_VARIANT)),)
36TARGET_BUILD_VARIANT:=eng
37endif
38
39#ReadtheproductspecssoweangetTARGET_DEVICEandother
40#variablesthatweneedinordertolocatetheoutputfiles.
41include$(BUILD_SYSTEM)/product_config.mk

在41行又包含了 product_config.mk 文件，等会我们再分析它，先看下面的

[plain] view plain copy

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
...
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
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:=$(PRODUCT_OUT)/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:=$(PRODUCT_OUT)/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:=$(PRODUCT_OUT)/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:=$(PRODUCT_OUT)/recovery
241TARGET_RECOVERY_ROOT_OUT:=$(TARGET_RECOVERY_OUT)/root
242
243TARGET_SYSLOADER_OUT:=$(PRODUCT_OUT)/sysloader
244TARGET_SYSLOADER_ROOT_OUT:=$(TARGET_SYSLOADER_OUT)/root
245TARGET_SYSLOADER_SYSTEM_OUT:=$(TARGET_SYSLOADER_OUT)/root/system
246
247TARGET_INSTALLER_OUT:=$(PRODUCT_OUT)/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

上面的代码是指定了目标输出代码的位置和主机输出代码的位置，重要的几个如下：

[plain] view plain copy

PRODUCT_OUT=这个的结果要根据product_config.mk文件内容来决定，其实是out/target/product/fs100/
TARGET_OUT=$(PRODUCT_OUT)/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目录。

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)

157行，我靠，又包含了product.mk文件

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.

意思是说：读取指定的目录下所有的AndrodProducts.mk文件中定义的产品信息

其实get-all-product-makefiles返回所有的产品文件xxx.mk

import-products函数去验证这些产品配置文件是否都包含有必须的配置信息，细节后面分析。

173行调用了resolve-short-product-name函数，它将返回TARGET_PRODUCT产品的配置文件目录，并赋给INTERNAL_PRODUCT

也就是说：

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文件，从该文件里取得所有产品的配置文件，然后再根据lunch选择的编译项TARGET_PRODUCT，找到与之对应的配置文件，然后设置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_find-android-products-files
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#
35defineget-all-product-makefiles
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

通过注释可知，本文件中主要是一些用来处理AndroidProduct.mk的函数
_find-android-products-files:

用来获得vendor目录下，所有名字为AndroidProduct.mk的文件列表。
get-all-product-makefiles：

用来获得所有AndroidProduct.mk文件里定义的PRODUCT_MAKEFILES的值（其实是产品文件路径名）。

在vendor目录下，每个公司目录下都会存在一个AndroidProduct.mk文件，这个文件是用来定义这个公司的产品列表，每个产品用<product_name>.mk来表示
如Android给的示例：

[plain] view plain copy

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

里面只定义了一个产品配置文件，即当前目录下的sample_addon.mk：
[plain] view plain copy

1#Listofappsandoptionallibraries(Javaandnative)toputintheadd-onsystemimage.
2PRODUCT_PACKAGES:=\
3PlatformLibraryClient\
4com.example.android.platform_library\
5libplatform_library_jni

上述文件里定义了产品相关个性化信息，如，PRODUCT_PACKAGES表示要在当前产品里添加一些安装包。
由此可见，get-all-product-makefiles函数，其实就是返回了当前公司里全部的产品对应的mk文件列表。

总结：

如果用户想个性定制自己的产品，应该有以下流程，包含上一节内容：

1.创建公司目录

#mkdir vendor/farsight

2. 创建一个vendorsetup.sh文件，将当前产品编译项添加到lunch里，让lunch能找到用户个性定制编译项

#echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh

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里添加如下内容：

[plain] view plain copy

PRODUCT_MAKEFILES:=$(LOCAL_DIR)/fs100.mk

表示只有一个产品fs100，它对应的配置文件在当前目录下的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

Android编译过程详解（三）：http://blog.csdn.net/mr_raptor/article/details/7540730

前面两节讲解了自定义Android编译项和创建Product产品配置文件，除了编译和定义产品相关环境变量外，还需要定义Board相关环境变量。

1.build/core/config.mk

[plain] view plain copy

<prename="code"class="plain">109#---------------------------------------------------------------
110#Definemostoftheglobalvariables.Thesearetheonesthat
111#arespecifictotheuser'sbuildconfiguration.
112include$(BUILD_SYSTEM)/envsetup.mk
113
114#Boardsmaybedefinedunder$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)
115#orundervendor/*/$(TARGET_DEVICE).Searchinbothplaces,but
116#makesureonlyoneexists.
117#RealboardsshouldalwaysbeassociatedwithanOEMvendor.
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
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:=

上述代码在上一节已经见到过，只是分析了112行的envsetup.mk，根据上一节内容可知， envsetup.mk设置了很多OUT变量，最终在build/core/product_config.mk文件里，设置了TARGET_DEVICE = fs100。

我们从114行继续分析。

从114~117行解释大意可知：

Board相关配置文件会存在于$(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/或vendor/*/$(TARGET_DEVICE)/目录中，一个Vendor厂商只能有一个对应的Board配置文件。

118行定义board_config_mk变量：

$(wildcard xxx)函数就是找到与xxx的匹配项放到空格列表里，前面定义TARGET_DEVICE变量 =fs100，所以$(SRC_TARGET_DIR)/board/fs100/BoardConfig.mk不存在，必须要存在vendor/*/fs100/BoardConfig.mk文件来定义开发板配置信息。

129行，通过include将vendor/*/fs100/BoardConfig.mk包含进来，

130行，TARGET_DEVICE_DIR为board_config_mk的路径，即：vendor/*/fs100

总结：

一个vendor厂商必须要有一个对应的Board配置文件，即：vendor/*/fs100/BoardConfig.mk

定义了TARGET_DEVICE_DIR变量，为board_config_mk的路径，即：vendor/*/fs100

指定board 相关特性,一定要包含:
TARGET_CPU_ABI := armeabi/...
其他属性参见其他board样例.(build/target/board/XXX

2.build/core/main.mk

[plain] view plain copy

141#Bringinstandardbuildsystemdefinitions.
142include$(BUILD_SYSTEM)/definitions.mk
...
347ifeq($(SDK_ONLY),true)
348
349#-----SDKforWindows------
350#TheseconfigurethebuildtargetsthatareavailablefortheSDKunderCygwin.
351#ThefirstsectiondefinesalltheC/C++toolsthatcanbecompiledunderCygwin,
352#thesecondsectiondefinesalltheJavaones(assumingjavacisavailable.)
353
354subdirs:=\
355prebuilt\
356build/libs/host\
357build/tools/zipalign\
...
382#Thefollowingcanonlybebuiltif"javac"isavailable.
383#ThischeckisusedwhenbuildingpartsoftheSDKunderCygwin.
384ifneq(,$(shellwhichjavac2>/dev/null))
385$(warningsdk-only:javacavailable.)
386subdirs+=\
387build/tools/signapk\
388dalvik/dx\
389dalvik/libcore\
...
414else#!SDK_ONLY
415ifeq($(BUILD_TINY_ANDROID),true)
416
417#TINY_ANDROIDisasuper-minimalbuildconfiguration,handyforboard
418#bringupandverylowleveldebugging
419
420subdirs:=\
421bionic\
422system/core\
423build/libs\
424build/target\
...
433else#!BUILD_TINY_ANDROID
434
435#
436#Typicalbuild;includeanyAndroid.mkfileswecanfind.
437#
438subdirs:=$(TOP)
439
440FULL_BUILD:=true
441
442endif#!BUILD_TINY_ANDROID
443
444endif#!SDK_ONLY
...
464#
465#Includeallofthemakefilesinthesystem
466#
467
468#Can'tusefirst-makefiles-underherebecause
469#--mindepth=2makestheprunesnotwork.
470subdir_makefiles:=\
471$(shellbuild/tools/findleaves.py--prune=out--prune=.repo--prune=.git$(subdirs)Android.mk)
472
473include$(subdir_makefiles)

上一节只是讲了main.mk第49行中包含了config.mk，我们继续分析。

142行包含了：build/core/definitions.mk，该文件定义了很多全局变量与函数。

如下列常见函数：

my-dir：返回当前路径

all-java-files-under：获得指定目录及子目录一所有java文件

all-subdir-c-files：获得当前目录下及子目录下所有c文件

354~444行，定义了subdirs变量，依据不同的用户编译条件，而包含Android源码中不同的目录。

470行，定义了subdir_makefile变量，其值为subdirs定义的目录中的Android.mk文件。

473行，将所有编译目录中的Android.mk文件包含进来。

3. build/target/board/Android.mk

[plain] view plain copy

26ifeq(,$(wildcard$(TARGET_DEVICE_DIR)/AndroidBoard.mk))
27ifeq(,$(wildcard$(TARGET_DEVICE_DIR)/Android.mk))
28$(errorMissing"$(TARGET_DEVICE_DIR)/AndroidBoard.mk")
29else
30#TODO:Removethischeckafterpeoplehavehadachancetoswitch,
31#afterApril2009.
32$(errorPleaserename"$(TARGET_DEVICE_DIR)/Android.mk"to"$(TARGET_DEVICE_DIR)/AndroidBoard.mk")
33endif
34endif
35include$(TARGET_DEVICE_DIR)/AndroidBoard.mk

由于将所有目录中Android.mk文件include进来，build/target/board/Android.mk自然被包含进来，根据前面分析，TARGET_DEVICE_DIR = vendor/*/ fs100，其中26~35行用来判断对应的产品目录下是否存在AndrodiBoard.mk，如果不存在，提示出错退出，如果存在，将其包含到编译脚本中。

由此可见：我们必须要在产品目录下创建AndrodiBoard.mk文件，来描述开发板相关配置项，我们可以借鉴：build/target/board/generic/AndroidBoard.mk内容，同时根据前面所分析，还要创建BoardConfig.mk文件。

[plain] view plain copy

#cpbuild/target/board/generic/AndroidBoard.mkbuild/target/board/generic/BoardConfig.mkvendor/farsight/fs100/

至此，自定义Android编译选项基本步骤已经分部分析完，细节还需要针对不同开发板具体分析。

总结：

build/core/main.mk包含了config.mk，它主要定义了编译全部代码的依赖关系

build/core/config.mk 定义了大量的编译脚本命令，编译时用到的环境变量，引入了envsetup.mk 文件，加载board相关配置文件。
build/core/envsetup.mk 定义了编译时用到的大量OUT输出目录，加载product_config.mk文件
build/core/product_config.mk 定义了Vendor目录下Product相关配置文件解析脚本，读取AndrodProducts.mk生成TARGET_DEVICE变量
build/target/product product config
build/target/board board config
build/core/combo build flags config

这里解释下这里的board和product。borad主要是设计到硬件芯片的配置，比如是否提供硬件的某些功能，比如说GPU等等，或者芯片支持浮点运算等等。product是指针对当前的芯片配置定义你将要生产产品的个性配置，主要是指APK方面的配置，哪些APK会包含在哪个product中，哪些APK在当前product中是不提供的。
config.mk是一个总括性的东西，它里面定义了各种module编译所需要使用的HOST工具以及如何来编译各种模块，比如说 BUILT_PREBUILT就定义了如何来编译预编译模块。envsetup.mk主要会读取由envsetup.sh写入环境变量中的一些变量来配置编译过程中的输出目录，combo里面主要定义了各种Host和Target结合的编译器和编译选项。

1. 在vendor目录下创建自己公司目录，然后在公司目录下创建一个新的vendorsetup.sh，在里面添加上自己的产品编译项

[plain] view plain copy

#mkdirvendor/farsight/
#touchvendor/farsight/vendorsetup.sh
#echo"add_lunch_combofs100-eng">vendor/farsight/vendorsetup.sh

2. 仿着Android示例代码，在公司目录下创建products目录

[plain] view plain copy

#mkdir-pvendor/farsight/products

3. 仿着Android示例代码，在products目录下创建两个mk文件

[plain] view plain copy

#touchvendor/farsight/products/AndroidProduct.mkvendor/farsight/products/fs100.mk

在AndroidProduct.mk里添加如下内容：
[sql] view plain copy

PRODUCT_MAKEFILES:=$(LOCAL_DIR)/fs100.mk

在产品配置文件里添加最基本信息

[plain] view plain copy

PRODUCT_PACKAGES:=\
IM\
VoiceDialer
$(callinherit-product,build/target/product/generic.mk)
#Overrides
PRODUCT_MANUFACTURER:=farsight
PRODUCT_NAME:=fs100
PRODUCT_DEVICE:=fs100

4. 借鉴build/target/board/generic/AndroidBoard.mk和BoardConfig.mk，创建对应文件。

[plain] view plain copy

#cpbuild/target/board/generic/AndroidBoard.mkbuild/target/board/generic/BoardConfig.mkvendor/farsight/fs100/

更多相关文章

随机推荐