Android 編譯命令

一、編譯命令

編譯Android源碼的第一步

# 在源碼根目錄執行
source build/envsetup.sh

其中source命令就是用于運行shell腳本命令，功能等價于”.”，因此該命令也等價于. build/envsetup.sh。在文件envsetup.sh聲明了當前會話終端可用的命令，這里需要注意的是當前會話終端，也就意味著每次新打開一個終端都必須再一次執行這些指令。

source envsetup.sh  #初始化編譯環境，包括后面的lunch和make指令
lunch #指定此次編譯的目標設備以及編譯類型，可以直接跟數字(沒有指定的話，會出現選項)
make  -j12 #開始編譯，默認為編譯整個系統，其中-j12代表的是編譯的job數量為12。

所有的編譯命令都在envsetup.sh文件能找到相對應的function，比如上述的命令lunch，make，在文件一定能找到

function lunch(){
    ...
}

function make(){
    ...
}

source envsetup.sh，需要cd到envsetup.sh文件所在路徑執行，路徑可能在build/envsetup.sh，或者integrate/envsetup.sh，再或者不排除有些廠商會封裝自己的.sh腳本，但核心思路是一致的。

1.1 代碼編譯

編譯指令    #解釋
m   #在源碼樹的根目錄執行編譯
mm  #編譯當前路徑下所有模塊，但不包含依賴
mmm [module_path]   #編譯指定路徑下所有模塊，但不包含依賴
mma             #編譯當前路徑下所有模塊，且包含依賴
mmma [module_path]  #編譯指定路徑下所有模塊，且包含依賴
make [module_name]  #無參數，則表示編譯整個Android代碼

下面列舉部分模塊的編譯指令：

模塊  make命令  mmm命令
init    make init   mmm system/core/init
zygote  make app_process    mmm frameworks/base/cmds/app_process
system_server   make services   mmm frameworks/base/services
java framework  make framework  mmm frameworks/base
framework資源 make framework-res  mmm frameworks/base/core/res
jni framework   make libandroid_runtime mmm frameworks/base/core/jni
binder  make libbinder  mmm frameworks/native/libs/binder

上述mmm命令同樣適用于mm/mma/mmma，編譯系統采用的是增量編譯，只會編譯發生變化的目標文件。當需要重新編譯所有的相關模塊，則需要編譯命令后增加參數-B，比如

make -B [module_name]，
或者 mm -B [module_path]。

對于m、mm、mmm、mma、mmma這些命令的實現都是通過make方式來完成的。
mmm/mm編譯的效率很高，而make/mma/mmma編譯較緩慢；
make/mma/mmma編譯時會把所有的依賴模塊一同編譯，但mmm/mm不會;

• 首次編譯時采用make/mma/mmma編譯；
• 當依賴模塊已經編譯過的情況，則使用mmm/mm編譯。

1.2 代碼搜索

#上述指令用法最終實現方式都是基于grep指令，各個指令用法格式：
xgrep [keyword]  

#搜索所有AndroidManifest.xml文件中的launcher關鍵字所在文件的具體位置，指令
mangrep launcher

#搜索所有Java代碼中包含zygote所在文件
jgrep zygote

#搜索所有system_app的selinux權限信息
sepgrep system_app

1.3 導航指令

導航指令    解釋
croot   切換至Android根目錄
cproj   切換至工程的根目錄
godir [filename]    跳轉到包含某個文件的目錄
Tips: 當每次修改完某個文件后需要編譯時，執行cproj后會跳轉到當前模塊的根目錄，也就是Android.mk文件所在目錄，然后再執行mm指令，即可編譯目標模塊；當進入源碼層級很深后，需要返回到根目錄，使用croot一條指令完成；另外cd - 指令可用于快速切換至上次目錄。

1.4 信息查詢

查詢指令    解釋
hmm 查詢所有的指令help信息
findmakefile    查詢當前目錄所在工程的Android.mk文件路徑
print_lunch_menu    查詢lunch可選的product
printconfig 查詢各項編譯變量值
gettop  查詢Android源碼的根目錄
gettargetarch   獲取TARGET_ARCH值
2.5 其他指令
上述只是列舉比較常用的指令，還有其他指令，而且不同的build編譯系統，支持的指令可能會存在一些差異，當忘記這些編譯指令，可以通過執行hmm，查詢指令的幫助信息。

最后再列舉兩個比較常用的指令：

make clean：執行清理操作，等價于 rm -rf out/
make update-api：更新API，在framework API改動后需執行該指令，Api記錄在目錄frameworks/base/api；

二、編譯系統

Android 編譯系統是Android源碼的一部分，用于編譯Android系統，Android SDK以及相關文檔。該編譯系統是由Make文件、Shell以及Python腳本共同組成，其中最為重要的便是Make文件。

2.1 Makefile分類

整個Build系統的Make文件分為三大類：

• 系統核心的Make文件：定義了Build系統的框架，文件全部位于路徑/build/core，其他Make文件都是基于該框架編寫的；

• 針對產品的Make文件：定義了具體某個型號手機的Make文件，文件路徑位于/device，該目錄下往往又以公司名和產品名劃分兩個子級目錄，比如/device/qcom/msm8916；

• 針對模塊的Make文件：整個系統分為各個獨立的模塊，每個模塊都一個專門的Make文件，名稱統一為"Android.mk"，該文件定義了當前模塊的編譯方式。Build系統會掃描整個源碼樹中名為Android.mk的文件，并執行相應模塊的編譯工作。

2.2 編譯產物

經過make編譯后的產物，都位于/out目錄，該目錄下主要關注下面幾個目錄：

/out/host：#Android開發工具的產物，包含SDK各種工具，比如adb，dex2oat，aapt等。
/out/target/common：#通用的一些編譯產物，包含Java應用代碼和Java庫；
/out/target/product/[product_name]：#針對特定設備的編譯產物以及平臺相關C/C++代碼和二進制文件；

在/out/target/product/[product_name]目錄下，有幾個重量級的鏡像文件：

system.img:#掛載為根分區，主要包含Android OS的系統文件；
ramdisk.img:#主要包含init.rc文件和配置文件等；
userdata.img:#被掛載在/data，主要包含用戶以及應用程序相關的數據；

當然還有boot.img，reocovery.img等鏡像文件，這里就不介紹了。