Android編譯過程詳解(一):http://www.cnblogs.com/mr-raptor/archive/2012/06/07/2540359.html
Android編譯過程詳解(二):http://www.cnblogs.com/mr-raptor/archive/2012/06/08/2541571.html
Android編譯過程詳解(三):http://www.cnblogs.com/mr-raptor/archive/2012/06/12/2547030.html
前面兩節講解了自定義Android編譯項和創建Product產品配置文件,除了編譯和定義產品相關環境變量外,還需要定義Board相關環境變量。
1. build/core/config.mk
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
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
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文件。
$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,在里面添加上自己的產品編譯項
$mkdir vendor/farsight/ $touch vendor/farsight/vendorsetup.sh $echo "add_lunch_combo fs100-eng" > vendor/farsight/vendorsetup.sh
2. 仿着Android示例代碼,在公司目錄下創建products目錄
$mkdir -p vendor/farsight/products
3. 仿着Android示例代碼,在products目錄下創建兩個mk文件
$touch vendor/farsight/products/AndroidProduct.mk vendor/farsight/products/fs100.mk
在AndroidProduct.mk里添加如下內容:
PRODUCT_MAKEFILES := $(LOCAL_DIR)/fs100.mk
在產品配置文件里添加最基本信息
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,創建對應文件。
$cp build/target/board/generic/AndroidBoard.mk build/target/board/generic/BoardConfig.mk vendor/farsight/fs100/
