Google給出了編譯Android的三步驟,分別是:
- source build/envsetup.sh:設(shè)置環(huán)境
- lunch aosp_arm-eng:選擇目標(biāo)
-
make -j16:執(zhí)行編譯 借助-jN參數(shù)處理并行任務(wù)帮非,N介于編譯時(shí)所用計(jì)算機(jī)核心數(shù)的1-2倍之間
下面具體分析這三個(gè)步驟:
1.source流程(加載命令)
source命令也稱為“點(diǎn)命令”塞椎,也就是一個(gè)點(diǎn)符號(hào)(.)溺森,其使Shell讀入指定的Shell腳本并依次執(zhí)行腳本中的所有語句霍骄。
先來看看build/envsetup.sh腳本的內(nèi)容:
一.加載函數(shù)
- croot:切換到源碼樹的根目錄
- lunch:選擇編譯板型
- m:在源碼樹的根目錄執(zhí)行make
- mm:編譯當(dāng)前目錄下的模塊,不包含依賴
- mmm:編譯指定目錄下的模塊菠隆,不包含依賴
- mma:編譯當(dāng)前目錄下的模塊,包含依賴
- mmma:編譯指定目錄下的模塊狂秘,包含依賴
- cgrep:在所有C/C++文件上執(zhí)行g(shù)rep
- jgrep:在所有Java文件上執(zhí)行g(shù)rep
- resgrep:在所有res/*.xml文件上執(zhí)行g(shù)rep
- printconfig:顯示當(dāng)前Build的配置信息
比如m函數(shù)的定義如下:
#build/envsetup.sh
function m()
{
local T=$(gettop)
local DRV=$(getdriver $T)
if [ "$T" ]; then
$DRV make -C $T -f build/core/main.mk $@
else
echo "Couldn't locate the top of the tree. Try setting TOP."
return 1
fi
}
二.定義3種編譯模式:
#build/envsetup.sh
VARIANT_CHOICES=(user userdebug eng)
user:權(quán)限受限骇径;適用于生產(chǎn)環(huán)境
userdebug:與user類似,但具有root權(quán)限和可調(diào)試性
eng: 具有額外調(diào)試工具的開發(fā)配置
三. 加載默認(rèn)的lunch選項(xiàng)到LUNCH_MENU_CHOICES:
#build/envsetup.sh
#LUNCH_MENU_CHOICES存放lunch變量者春,先清空
unset LUNCH_MENU_CHOICES
add_lunch_combo aosp_arm-eng
add_lunch_combo aosp_arm64-eng
....
#add_lunch_combo主要是向LUNCH_MENU_CHOICES添加lunch變量
function add_lunch_combo()
{
local new_combo=$1
local c
for c in ${LUNCH_MENU_CHOICES[@]} ; do
if [ "$new_combo" = "$c" ] ; then
return
fi
done
LUNCH_MENU_CHOICES=(${LUNCH_MENU_CHOICES[@]} $new_combo)
}
除了默認(rèn)的lunch選項(xiàng)外破衔,在“device/廠商/版型”目錄中的vendorsetup.sh還有add_lunch_combo的調(diào)用,部分摘錄如下:
add_lunch_combo aosp_angler-userdebug
四. 查找所有的vendorsetup.sh腳本并執(zhí)行:
#build/envsetup.sh
#查找的目錄層級(jí)為4層
for f in `test -d device && find -L device -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null | sort` \
`test -d vendor && find -L vendor -maxdepth 4 -name 'vendorsetup.sh' 2> /dev/null | sort`
do
echo "including $f"
. $f
done
unset f
2.lunch流程
由第一步可知钱烟,lunch是build/envsetup.sh腳本中定義的用來選擇對(duì)應(yīng)的編譯項(xiàng)的晰筛,下面看看lunch函數(shù)都做了哪些事情。
一.獲取編譯目標(biāo)保存到answer變量:
if [ "$1" ] ; then
answer=$1
二.根據(jù)answer變量從LUNCH_MENU_CHOICES中獲取值賦給selection:
if [ $answer -le ${#LUNCH_MENU_CHOICES[@]} ]
then
selection=${LUNCH_MENU_CHOICES[$(($answer-1))]}
fi
三.從selection變量獲取product變量
local product=$(echo -n $selection | sed -e "s/-.*$//")
四.從selection變量獲取VARIANT_CHOICES(eng/user/userdebug)
local variant=$(echo -n $selection | sed -e "s/^[^\-]*-//")
五.導(dǎo)出宏變量:
export TARGET_PRODUCT=$product
export TARGET_BUILD_VARIANT=$variant
export TARGET_BUILD_TYPE=release
六.調(diào)用配置/打印函數(shù)
#set_stuff_for_environment主要就是設(shè)置PROMPT_COMMAND拴袭,ANDROID_BUILD_PATHS传惠,JAVA_HOME和BUILD_ENV_SEQUENCE_NUMBER等等環(huán)境變量
set_stuff_for_environment
#printconfig用來打印最終準(zhǔn)備好的環(huán)境變量
printconfig
3.make流程
3.1 編譯入口
在Android源碼根目錄下執(zhí)行make命令,系統(tǒng)會(huì)找到根目錄下的Makefile文件稻扬,里面指向了另外一個(gè)mk文件:
#Makefile
include build/core/main.mk
3.2 導(dǎo)入依賴/確定編譯模式/定義編譯目標(biāo)/編譯
#build/core/main.mk
....
#確定shell
ifdef ANDROID_BUILD_SHELL
SHELL := $(ANDROID_BUILD_SHELL)
else
SHELL := /bin/bash
endif
....
#檢查MAKE版本
ifneq (1,$(strip $(shell expr $(MAKE_VERSION) \>= 3.81)))
.PHONY: droid
DEFAULT_GOAL := droid
$(DEFAULT_GOAL):
....
#設(shè)定默認(rèn)編譯目標(biāo)
.PHONY: droid
DEFAULT_GOAL := droid
$(DEFAULT_GOAL):
....
#導(dǎo)入工具和編譯模塊
include $(BUILD_SYSTEM)/config.mk
#定義target清除編譯文件
include $(BUILD_SYSTEM)/cleanbuild.mk
....
#確定編譯模式 user/userdebug/eng
user_variant := $(filter user userdebug,$(TARGET_BUILD_VARIANT))
enable_target_debugging := true
tags_to_install :=
ifneq (,$(user_variant))
ifeq ($(user_variant),userdebug)
tags_to_install += debug
else
enable_target_debugging :=
endif
....
#查找所有的android.mk
subdir_makefiles := \
$(shell build/tools/findleaves.py $(FIND_LEAVES_EXCLUDES) $(subdirs) Android.mk)
#執(zhí)行編譯
$(foreach mk, $(subdir_makefiles), $(info including $(mk) ...)$(eval include $(mk)))
....
#定義編譯目標(biāo)
.PHONY: ramdisk
ramdisk: $(INSTALLED_RAMDISK_TARGET)
注意:make update-api
谷歌對(duì)于所有的類和API卦方,分為開方和非開放兩種,而開放的類和API泰佳,可以通過“Javadoc”標(biāo)簽與源碼同步生成“開發(fā)文檔”盼砍;
當(dāng)我們修改或者添加一個(gè)新的API時(shí),我們有兩種方案可以避免出現(xiàn)上述錯(cuò)誤.
- 將該接口加上非公開的標(biāo)簽:/*{@hide}/逝她;
- 在修改后執(zhí)行:makeupdate-api浇坐,將修改內(nèi)容與API的doc文件更新到一致。同時(shí)在frameworks/base/api庫下面會(huì)產(chǎn)生“.current.txt”文件的差異黔宛。