Android 编译系统（一、二、三）

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 plaincopyprint?
        1. function help() 　　　　　　　　　　　　　　　　　# 显示帮助信息 
        2. function get_abs_build_var()　　　　　　　　　　　# 获取绝对变量 
        3. function get_build_var()　　　　　　　　　　　　　# 获取绝对变量 
        4. function check_product()　　　　　　　　　　　　　# 检查product 
        5. function check_variant()　　　　　　　　　　　　　# 检查变量 
        6. function setpaths()　　　　　　　　　　　　　　　 # 设置文件路径 
        7. function printconfig()　　　　　　　　　　　　　　# 打印配置 
        8. function set_stuff_for_environment()　　　　　　 # 设置环境变量 
        9. function set_sequence_number()　　　　　　　　 # 设置序号 
        10. function settitle()　　　　　　　　　　　　　　　 # 设置标题 
        11. function choosetype()　　　　　　　　　　　　　　 # 设置type 
        12. function chooseproduct()　　　　　　　　　　　　 # 设置product 
        13. function choosevariant()　　　　　　　　　　　　 # 设置variant 
        14. function tapas()　　　　　　　　　　　　　　　　 # 功能同choosecombo 
        15. function choosecombo()　　　　　　　　　　　　　 # 设置编译参数 
        16. function add_lunch_combo()　　　　　　　　　　　 # 添加lunch项目 
        17. function print_lunch_menu()　　　　　　　　　　　 # 打印lunch列表 
        18. function lunch()　　　　　　　　　　　　　　　　　# 配置lunch 
        19. function m()　　　　　　　　　　　　　　　　　　　# make from top 
        20. function findmakefile()　　　　　　　　　　　　　 # 查找makefile 
        21. function mm()　　　　　　　　　　　　　　　　　　 # make from current directory 
        22. function mmm()　　　　　　　　　　　　　　　　　 # make the supplied directories 
        23. function croot()　　　　　　　　　　　　　　　　　# 回到根目录 
        24. function cproj() 
        25. function pid() 
        26. function systemstack() 
        27. function gdbclient() 
        28. function jgrep()　　　　　　　　　　　　　　　　　# 查找java文件 
        29. function cgrep()　　　　　　　　　　　　　　　　 # 查找c/cpp文件 
        30. function resgrep() 
        31. function tracedmdump() 
        32. function runhat() 
        33. function getbugreports() 
        34. function startviewserver() 
        35. function stopviewserver() 
        36. function isviewserverstarted() 
        37. function smoketest() 
        38. function runtest() 
        39. function godir () 　　　　　　　　　　　　　　　　# 跳到指定目录 
        40. 
        41. 
        42. # 这是系统自动增加了一个默认的编译项 generic-eng 
        43. # add the default one here 
        44. <strong><span style="color:#ff0000;">add_lunch_combo generic-eng</span></strong> 
        45. 
        46. 
        47. # 下面的代码很重要，它要从vendor目录下查找vendorsetup.sh文件，如果查到了，就加载它 
        48. # Execute the contents of any vendorsetup.sh files we can find. 
        49. <strong><span style="color:#ff0000;">for f in `/bin/ls vendor/*/vendorsetup.sh vendor/*/build/vendorsetup.sh 2> /dev/null` 
        50. do 
        51. echo "including $f" 
        52. . $f 
        53. done</span></strong>

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

[plain] view plaincopyprint?
        1. #mkdir vendor/farsight/ 
        2. #touch vendor/farsight/vendorsetup.sh 
        3. #echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh

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

[plain] view plaincopyprint？
        1. including vendor/farsight/vendorsetup.sh 
        2. 按照android官网的步骤，开始执行lunch full-eng

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

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

[plain] view plaincopyprint?
        1. You're building on Linux 
        2. 
        3. generic-eng simulator fs100-eng 
        4. Lunch menu... pick a combo: 
        5. generic-eng 
        6. simulator 
        7. 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 plaincopyprint?
        1. function lunch() 
        2. { 
        3. local answer 
        4. 
        5. if [ "$1" ] ; then 
        6. # lunch后面直接带参数 
        7. answer=$1 
        8. else 
        9. # lunch后面不带参数，则打印处所有的target product和variant菜单提供用户选择 
        10. print_lunch_menu 
        11. echo -n "Which would you like? [generic-eng] " 
        12. read answer 
        13. fi 
        14. 
        15. local selection= 
        16. 
        17. if [ -z "$answer" ] 
        18. then 
        19. # 如果用户在菜单中没有选择，直接回车，则为系统缺省的generic-eng 
        20. selection=generic-eng 
        21. elif [ "$answer" = "simulator" ] 
        22. then 
        23. # 如果是模拟器 
        24. selection=simulator 
        25. elif (echo -n $answer | grep -q -e "^[0-9][0-9]*$") 
        26. then 
        27. # 如果answer是选择菜单的数字，则获取该数字对应的字符串 
        28. if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ] 
        29. then 
        30. selection=${LUNCH_MENU_CHOICES[$(($answer-$_arrayoffset))]} 
        31. fi 
        32. # 如果 answer字符串匹配 *-*模式(*的开头不能为-) 
        33. elif (echo -n $answer | grep -q -e "^[^\-][^\-]*-[^\-][^\-]*$") 
        34. then 
        35. selection=$answer 
        36. fi 
        37. 
        38. if [ -z "$selection" ] 
        39. then 
        40. echo 
        41. echo "Invalid lunch combo: $answer" 
        42. return 1 
        43. fi 
        44. 
        45. # special case the simulator 
        46. if [ "$selection" = "simulator" ] 
        47. then 
        48. # 模拟器模式 
        49. export TARGET_PRODUCT=sim 
        50. export TARGET_BUILD_VARIANT=eng 
        51. export TARGET_SIMULATOR=true 
        52. export TARGET_BUILD_TYPE=debug 
        53. else 
        54. 
        55. # 将 product-variant模式种的product分离出来 
        56. local product=$(echo -n $selection | sed -e "s/-.*$//") 
        57. 
        58. # 检查之，调用关系 check_product()->get_build_var()->build/core/config.mk比较罗嗦，不展开了 
        59. check_product $product 
        60. if [ $? -ne 0 ] 
        61. then 
        62. echo 
        63. echo "** Don't have a product spec for: '$product'" 
        64. echo "** Do you have the right repo manifest?" 
        65. product= 
        66. fi 
        67. 
        68. # 将 product-variant模式种的variant分离出来 
        69. local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//") 
        70. 
        71. # 检查之，看看是否在 (user userdebug eng) 范围内 
        72. check_variant $variant 
        73. if [ $? -ne 0 ] 
        74. then 
        75. echo 
        76. echo "** Invalid variant: '$variant'" 
        77. echo "** Must be one of ${VARIANT_CHOICES[@]}" 
        78. variant= 
        79. fi 
        80. 
        81. if [ -z "$product" -o -z "$variant" ] 
        82. then 
        83. echo 
        84. return 1 
        85. fi 
        86. <span style="white-space:pre"> </span># 导出环境变量，这儿很重要，因为后面的编译系统都是依赖于这里定义的几个变量的 
        87. export TARGET_PRODUCT=$product 
        88. export TARGET_BUILD_VARIANT=$variant 
        89. export TARGET_SIMULATOR=false 
        90. export TARGET_BUILD_TYPE=release 
        91. fi # !simulator 
        92. 
        93. echo 
        94. 
        95. # 设置到环境变量，比较多，不再一一列出，最简单的方法 set >env.txt 可获得 
        96. set_stuff_for_environment 
        97. # 打印一些主要的变量, 调用关系 printconfig()->get_build_var()->build/core/config.mk->build/core/envsetup.mk 比较罗嗦，不展开了 
        98. printconfig 
        99. }

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

[plain] view plaincopyprint?
        1. TARGET_PRODUCT=fs100 
        2. TARGET_BUILD_VARIANT=eng 
        3. TARGET_SIMULATOR=false 
        4. TARGET_BUILD_TYPE=release

1、 make

执行make命令的结果就是去执行当前目录下的Makefile文件，我们来看下它的内容：

1 ### DO NOT EDIT THIS FILE ###
    2 include build/core/main.mk
    3 ### DO NOT EDIT THIS FILE ###

呵呵，看到上面 的内容，我们都会笑，这是我见过最简单的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包含。

定义了以下环境变量：

16 SRC_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
    25 SRC_HOST_HEADERS:=$(TOPDIR)tools/include
    26 SRC_LIBRARIES:= $(TOPDIR)libs
    27 SRC_SERVERS:= $(TOPDIR)servers
    28 SRC_TARGET_DIR := $(TOPDIR)build/target
    29 SRC_API_DIR := $(TOPDIR)frameworks/base/api
    .....然后定义了下面几个重要的编译命令 43 CLEAR_VARS:= $(BUILD_SYSTEM)/clear_vars.mk
    44 BUILD_HOST_STATIC_LIBRARY:= $(BUILD_SYSTEM)/host_static_library.mk
    45 BUILD_HOST_SHARED_LIBRARY:= $(BUILD_SYSTEM)/host_shared_library.mk
    46 BUILD_STATIC_LIBRARY:= $(BUILD_SYSTEM)/static_library.mk
    47 BUILD_RAW_STATIC_LIBRARY := $(BUILD_SYSTEM)/raw_static_library.mk
    48 BUILD_SHARED_LIBRARY:= $(BUILD_SYSTEM)/shared_library.mk
    49 BUILD_EXECUTABLE:= $(BUILD_SYSTEM)/executable.mk
    50 BUILD_RAW_EXECUTABLE:= $(BUILD_SYSTEM)/raw_executable.mk
    51 BUILD_HOST_EXECUTABLE:= $(BUILD_SYSTEM)/host_executable.mk
    52 BUILD_PACKAGE:= $(BUILD_SYSTEM)/package.mk
    53 BUILD_HOST_PREBUILT:= $(BUILD_SYSTEM)/host_prebuilt.mk
    54 BUILD_PREBUILT:= $(BUILD_SYSTEM)/prebuilt.mk
    55 BUILD_MULTI_PREBUILT:= $(BUILD_SYSTEM)/multi_prebuilt.mk
    56 BUILD_JAVA_LIBRARY:= $(BUILD_SYSTEM)/java_library.mk
    57 BUILD_STATIC_JAVA_LIBRARY:= $(BUILD_SYSTEM)/static_java_library.mk
    58 BUILD_HOST_JAVA_LIBRARY:= $(BUILD_SYSTEM)/host_java_library.mk
    59 BUILD_DROIDDOC:= $(BUILD_SYSTEM)/droiddoc.mk
    60 BUILD_COPY_HEADERS := $(BUILD_SYSTEM)/copy_headers.mk
    61 BUILD_KEY_CHAR_MAP := $(BUILD_SYSTEM)/key_char_map.mk 

上述命令变量其实是对应的mk文件名，所有的Android.mk文件里基本上都包含上述命令变量，如：

CLEAR_VARS：用来清除之前定义的环境变量

BUILD_SHARED_LIBRARY：用来指定编译动态库过程

109 # ---------------------------------------------------------------
    110 # Define most of the global variables. These are the ones that
    111 # are specific to the user's build configuration.
    112 include $(BUILD_SYSTEM)/envsetup.mk
    113 
    114 # Boards may be defined under $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)
    115 # or under vendor/*/$(TARGET_DEVICE). Search in both places, but
    116 # make sure only one exists.
    117 # Real boards should always be associated with an OEM vendor.
    118 board_config_mk := \
    119 $(strip $(wildcard \
    120 $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk \
    121 vendor/*/$(TARGET_DEVICE)/BoardConfig.mk \
    122 ))
    123 ifeq ($(board_config_mk),)
    124 $(error No config file found for TARGET_DEVICE $(TARGET_DEVICE))
    125 endif
    126 ifneq ($(words $(board_config_mk)),1)
    127 $(error Multiple board config files for TARGET_DEVICE $(TARGET_DEVICE): $(board_config_mk))
    128 endif
    129 include $(board_config_mk)
    130 TARGET_DEVICE_DIR := $(patsubst %/,%,$(dir $(board_config_mk)))
    131 board_config_mk :=
    112行又包含了另外一个重要的mk文件envsetup.mk，我们来看一下。

3、envsetup.mk

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

第25行，判断TARGET_PRODUCT是否为空，根据上一节分析可知，TARGET_PRODUCT=fs100 
    34 # the variant -- the set of files that are included for a build
    35 ifeq ($(strip $(TARGET_BUILD_VARIANT)),)
     36 TARGET_BUILD_VARIANT := eng
    37 endif
     38 
    39 # Read the product specs so we an get TARGET_DEVICE and other
    40 # variables that we need in order to locate the output files.
    41 include $(BUILD_SYSTEM)/product_config.mk

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

148 # ---------------------------------------------------------------
    149 # figure out the output directories
    150 
    151 ifeq (,$(strip $(OUT_DIR)))
    152 OUT_DIR := $(TOPDIR)out
    153 endif
    154 
    155 DEBUG_OUT_DIR := $(OUT_DIR)/debug
    156 
    157 # Move the host or target under the debug/ directory
    158 # if necessary.
    159 TARGET_OUT_ROOT_release := $(OUT_DIR)/target
    160 TARGET_OUT_ROOT_debug := $(DEBUG_OUT_DIR)/target
    161 TARGET_OUT_ROOT := $(TARGET_OUT_ROOT_$(TARGET_BUILD_TYPE))
    162 
    ...
    184 PRODUCT_OUT := $(TARGET_PRODUCT_OUT_ROOT)/$(TARGET_DEVICE)
    187 
    188 HOST_OUT_EXECUTABLES:= $(HOST_OUT)/bin
    189 HOST_OUT_SHARED_LIBRARIES:= $(HOST_OUT)/lib
    190 HOST_OUT_JAVA_LIBRARIES:= $(HOST_OUT)/framework
    191 HOST_OUT_SDK_ADDON := $(HOST_OUT)/sdk_addon
    ...
    200 TARGET_OUT_INTERMEDIATES := $(PRODUCT_OUT)/obj
    201 TARGET_OUT_HEADERS:= $(TARGET_OUT_INTERMEDIATES)/include
    202 TARGET_OUT_INTERMEDIATE_LIBRARIES := $(TARGET_OUT_INTERMEDIATES)/lib
    203 TARGET_OUT_COMMON_INTERMEDIATES := $(TARGET_COMMON_OUT_ROOT)/obj
    204 
    205 TARGET_OUT := $(PRODUCT_OUT)/system
    206 TARGET_OUT_EXECUTABLES:= $(TARGET_OUT)/bin
    207 TARGET_OUT_OPTIONAL_EXECUTABLES:= $(TARGET_OUT)/xbin
    208 TARGET_OUT_SHARED_LIBRARIES:= $(TARGET_OUT)/lib
    209 TARGET_OUT_JAVA_LIBRARIES:= $(TARGET_OUT)/framework
    210 TARGET_OUT_APPS:= $(TARGET_OUT)/app
    211 TARGET_OUT_KEYLAYOUT := $(TARGET_OUT)/usr/keylayout
    212 TARGET_OUT_KEYCHARS := $(TARGET_OUT)/usr/keychars
    213 TARGET_OUT_ETC := $(TARGET_OUT)/etc
    214 TARGET_OUT_STATIC_LIBRARIES:= $(TARGET_OUT_INTERMEDIATES)/lib
    215 TARGET_OUT_NOTICE_FILES:=$(TARGET_OUT_INTERMEDIATES)/NOTICE_FILES
    216 
    217 TARGET_OUT_DATA := $(PRODUCT_OUT)/data
    218 TARGET_OUT_DATA_EXECUTABLES:= $(TARGET_OUT_EXECUTABLES)
    219 TARGET_OUT_DATA_SHARED_LIBRARIES:= $(TARGET_OUT_SHARED_LIBRARIES)
    220 TARGET_OUT_DATA_JAVA_LIBRARIES:= $(TARGET_OUT_JAVA_LIBRARIES)
    221 TARGET_OUT_DATA_APPS:= $(TARGET_OUT_DATA)/app
    222 TARGET_OUT_DATA_KEYLAYOUT := $(TARGET_OUT_KEYLAYOUT)
    223 TARGET_OUT_DATA_KEYCHARS := $(TARGET_OUT_KEYCHARS)
    224 TARGET_OUT_DATA_ETC := $(TARGET_OUT_ETC)
    225 TARGET_OUT_DATA_STATIC_LIBRARIES:= $(TARGET_OUT_STATIC_LIBRARIES)
    226 
    227 TARGET_OUT_UNSTRIPPED := $(PRODUCT_OUT)/symbols
    228 TARGET_OUT_EXECUTABLES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/bin
    229 TARGET_OUT_SHARED_LIBRARIES_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/system/lib
    230 TARGET_ROOT_OUT_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)
    231 TARGET_ROOT_OUT_SBIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/sbin
    232 TARGET_ROOT_OUT_BIN_UNSTRIPPED := $(TARGET_OUT_UNSTRIPPED)/bin
    233 
    234 TARGET_ROOT_OUT := $(PRODUCT_OUT)/root
    235 TARGET_ROOT_OUT_BIN := $(TARGET_ROOT_OUT)/bin
    236 TARGET_ROOT_OUT_SBIN := $(TARGET_ROOT_OUT)/sbin
    237 TARGET_ROOT_OUT_ETC := $(TARGET_ROOT_OUT)/etc
    238 TARGET_ROOT_OUT_USR := $(TARGET_ROOT_OUT)/usr
    239 
    240 TARGET_RECOVERY_OUT := $(PRODUCT_OUT)/recovery
    241 TARGET_RECOVERY_ROOT_OUT := $(TARGET_RECOVERY_OUT)/root
    242 
    243 TARGET_SYSLOADER_OUT := $(PRODUCT_OUT)/sysloader
    244 TARGET_SYSLOADER_ROOT_OUT := $(TARGET_SYSLOADER_OUT)/root
    245 TARGET_SYSLOADER_SYSTEM_OUT := $(TARGET_SYSLOADER_OUT)/root/system
    246 
    247 TARGET_INSTALLER_OUT := $(PRODUCT_OUT)/installer
    248 TARGET_INSTALLER_DATA_OUT := $(TARGET_INSTALLER_OUT)/data
    249 TARGET_INSTALLER_ROOT_OUT := $(TARGET_INSTALLER_OUT)/root
    250 TARGET_INSTALLER_SYSTEM_OUT := $(TARGET_INSTALLER_OUT)/root/system

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

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

157 include $(BUILD_SYSTEM)/product.mk
    ...
    160 # Read in all of the product definitions specified by the AndroidProducts.mk
    161 # files in the tree.
    162 #
    163 #TODO: when we start allowing direct pointers to product files,
    164 # guarantee that they're in this list.
    165 $(call import-products, $(get-all-product-makefiles))
    166 $(check-all-products)
    ...
    170 # Convert a short name like "sooner" into the path to the product
    171 # file defining that product.
    172 #
    173 INTERNAL_PRODUCT := $(call resolve-short-product-name, $(TARGET_PRODUCT))
    ...
    176 # Find the device that this product maps to.
    177 TARGET_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.mk files 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

17 #
    18 # Functions for including AndroidProducts.mk files
    19 #
    20 
    21 #
    22 # Returns the list of all AndroidProducts.mk files.
    23 # $(call ) isn't necessary.
    24 #
    25 define <strong>_find-android-products-files</strong>
    26 $(shell test -d vendor && find vendor -maxdepth 6 -name AndroidProducts.mk) \
    27 $(SRC_TARGET_DIR)/product/AndroidProducts.mk
    28 endef
    29 
    30 #
    31 # Returns the sorted concatenation of all PRODUCT_MAKEFILES
    32 # variables set in all AndroidProducts.mk files.
    33 # $(call ) isn't necessary.
    34 #
    35 define <strong>get-all-product-makefiles</strong>
    36 $(sort \
    37 $(foreach f,$(_find-android-products-files), \
    38 $(eval PRODUCT_MAKEFILES :=) \
    39 $(eval LOCAL_DIR := $(patsubst %/,%,$(dir $(f)))) \
    40 $(eval include $(f)) \
    41 $(PRODUCT_MAKEFILES) \
    42 ) \
    43 $(eval PRODUCT_MAKEFILES :=) \
    44 $(eval LOCAL_DIR :=) \
    45 )
    46 endef通过注释可知，本文件中主要是一些用来处理AndroidProduct.mk的函数

 _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。其内容如下：

1 #
    2 # This file should set PRODUCT_MAKEFILES to a list of product makefiles
    3 # to expose to the build system. LOCAL_DIR will already be set to
    4 # the directory containing this file. 
    5 #
    6 # This file may not rely on the value of any variable other than
    7 # LOCAL_DIR; do not use any conditionals, and do not look up the
     8 # value of any variable that isn't set in this file or in a file that
    9 # it includes.
    10 #
    11 
     12 PRODUCT_MAKEFILES := \
     13 $(LOCAL_DIR)/sample_addon.mk里面只定义了一个产品配置文件，即当前目录下的sample_addon.mk：
    1 # List of apps and optional libraries (Java and native) to put in the add-on system image.
    2 PRODUCT_PACKAGES := \
    3 PlatformLibraryClient \
    4 com.example.android.platform_library \
    5 libplatform_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里添加如下内容：

PRODUCT_MAKEFILES := $(LOCAL_DIR)/fs100.mk表示只有一个产品fs100，它对应的配置文件在当前目录下的fs100.mk。

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

1 
    2 PRODUCT_PACKAGES := \
    3 IM \
    4 VoiceDialer
    5 
    6 $(call inherit-product, build/target/product/generic.mk) ##从某一默认配置开始派生余下内容参考派生起点
    7 
    8 # Overrides
    9 PRODUCT_MANUFACTURER := farsight
    10 PRODUCT_NAME := fs100
    11 PRODUCT_DEVICE := fs100

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

1、 build/core/config.mk

[plain] view plaincopy

<pre name="code" class="plain">109 # --------------------------------------------------------
    110 # Define most of the global variables. These are the ones that 
    111 # are specific to the user's build configuration. 
    112 include $(BUILD_SYSTEM)/envsetup.mk 
    113 
    114 # Boards may be defined under $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE) 
    115 # or under vendor/*/$(TARGET_DEVICE). Search in both places, but 
    116 # make sure only one exists. 
    117 # Real boards should always be associated with an OEM vendor. 
    118 board_config_mk := \ 
    119 $(strip $(wildcard \ 
    120 $(SRC_TARGET_DIR)/board/$(TARGET_DEVICE)/BoardConfig.mk \ 
    121 vendor/*/$(TARGET_DEVICE)/BoardConfig.mk \ 
    122 )) 
    123 ifeq ($(board_config_mk),) 
    124 $(error No config file found for TARGET_DEVICE $(TARGET_DEVICE)) 
    125 endif 
    126 ifneq ($(words $(board_config_mk)),1) 
    127 $(error Multiple board config files for TARGET_DEVICE $(TARGET_DEVICE): $(board_config_mk)) 
    128 endif 
    129 include $(board_config_mk) 
    130 TARGET_DEVICE_DIR := $(patsubst %/,%,$(dir $(board_config_mk))) 
    131 board_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 plaincopy

141 # Bring in standard build system definitions. 
    142 include $(BUILD_SYSTEM)/definitions.mk 
    ... 
    347 ifeq ($(SDK_ONLY),true) 
    348 
    349 # ----- SDK for Windows ------ 
    350 # These configure the build targets that are available for the SDK under Cygwin. 
    351 # The first section defines all the C/C++ tools that can be compiled under Cygwin, 
    352 # the second section defines all the Java ones (assuming javac is available.) 
    353 
    354 subdirs := \ 
    355 prebuilt \ 
    356 build/libs/host \ 
    357 build/tools/zipalign \ 
    ... 
    382 # The following can only be built if "javac" is available. 
    383 # This check is used when building parts of the SDK under Cygwin. 
    384 ifneq (,$(shell which javac 2>/dev/null)) 
    385 $(warning sdk-only: javac available.) 
    386 subdirs += \ 
    387 build/tools/signapk \ 
    388 dalvik/dx \ 
    389 dalvik/libcore \ 
    ... 
    414 else # !SDK_ONLY 
    415 ifeq ($(BUILD_TINY_ANDROID), true) 
    416 
    417 # TINY_ANDROID is a super-minimal build configuration, handy for board 
    418 # bringup and very low level debugging 
    419 
    420 subdirs := \ 
    421 bionic \ 
    422 system/core \ 
    423 build/libs \ 
    424 build/target \ 
     ... 
    433 else # !BUILD_TINY_ANDROID 
    434 
    435 # 
    436 # Typical build; include any Android.mk files we can find. 
    437 # 
    438 subdirs := $(TOP) 
    439 
    440 FULL_BUILD := true 
    441 
    442 endif # !BUILD_TINY_ANDROID 
    443 
    444 endif # !SDK_ONLY 
    ... 
    464 # 
    465 # Include all of the makefiles in the system 
    466 # 
    467 
    468 # Can't use first-makefiles-under here because 
    469 # --mindepth=2 makes the prunes not work. 
    470 subdir_makefiles := \ 
    471 $(shell build/tools/findleaves.py --prune=out --prune=.repo --prune=.git $(subdirs) Android.mk) 
    472 
    473 include $(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 plaincopy

26 ifeq (,$(wildcard $(TARGET_DEVICE_DIR)/AndroidBoard.mk)) 
    27 ifeq (,$(wildcard $(TARGET_DEVICE_DIR)/Android.mk)) 
    28 $(error Missing "$(TARGET_DEVICE_DIR)/AndroidBoard.mk") 
    29 else 
    30 # TODO: Remove this check after people have had a chance to switch, 
    31 # after April 2009. 
    32 $(error Please rename "$(TARGET_DEVICE_DIR)/Android.mk" to "$(TARGET_DEVICE_DIR)/AndroidBoard.mk") 
    33 endif 
    34 endif 
    35 include $(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 plaincopy

#cp build/target/board/generic/AndroidBoard.mk build/target/board/generic/BoardConfig.mk vendor/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 plaincopy

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

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

[plain] view plaincopy

#mkdir -p vendor/farsight/products

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

[plain] view plaincopy

#touch vendor/farsight/products/AndroidProduct.mk vendor/farsight/products/fs100.mk

在AndroidProduct.mk里添加如下内容：

[sql] view plaincopy

PRODUCT_MAKEFILES := $(LOCAL_DIR)/fs100.mk

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

[plain] view plaincopy

PRODUCT_PACKAGES := \ 
    IM \ 
    VoiceDialer 
    $(call inherit-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 plaincopy

#cp build/target/board/generic/AndroidBoard.mk build/target/board/generic/BoardConfig.mk vendor/farsight/fs100/