請按照以下說明開始構建 Android。
設置環境
使用envsetup.sh
腳本初始化環境:
source build/envsetup.sh
或者
. build/envsetup.sh
有關相關命令的說明,請參閱platform/build/envsetup.sh中的腳本,包括用於選擇設備目標的午餐和用於構建非捆綁應用程序(例如參考電視應用程序)的小吃。
您需要在每次repo sync
後重新發出此命令,以獲取對該腳本的任何更改。請注意,將source
替換為.
(一個點)可以節省一些字符,縮寫形式在文檔中更常用。
envsetup.sh
腳本導入多個命令,使您能夠使用 Android 源代碼,包括本練習中使用的命令。
要查看可用命令的完整列表,請運行:
hmm
選擇目標
午餐
選擇lunch
時要製定的目標。 lunch product_name - build_variant
選擇product_name作為要構建的產品,選擇build_variant作為要構建的變體,並將這些選擇存儲在環境中,以便後續調用m
和其他類似命令時讀取。
確切的配置可以作為參數傳遞。例如,以下命令指的是模擬器的完整構建,並啟用了所有調試:
lunch aosp_arm-eng
如果不帶參數運行, lunch
會提示您從菜單中選擇一個目標,但請注意,菜單並不包含所有可能性。請參閱選擇設備版本以獲取 AOSP 支持的所有設備的構建配置,或者與您團隊中的人員討論適合您正在使用的設備的正確午餐。
所有構建目標均採用BUILD-BUILDTYPE
形式,其中BUILD
是指代特定功能組合的代號。 BUILDTYPE
是以下之一。
構建類型 | 使用 |
---|---|
用戶 | 訪問權限有限;適合生產 |
用戶調試 | 與用戶類似,但具有 root 訪問權限和調試能力;非常接近生產性能 |
英語 | 具有更快構建時間的開發配置;最適合日常開發 |
userdebug
構建的行為應與user
構建相同,並且能夠啟用通常違反平台安全模型的額外調試。這使得userdebug
構建有利於了解該版本所使用的性能和功能。使用userdebug
版本進行開發時,請遵循userdebug 指南。
eng
構建優先考慮在平台上工作的工程師的工程生產力。 eng
構建關閉了用於最大化運行時性能的各種優化。除此之外, eng
構建與user
和userdebug
構建非常相似,以便設備開發人員可以了解代碼在這些環境中的行為方式。
要查看當前的午餐設置,請運行以下命令:
echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"
有關在實際硬件上構建和運行的更多信息,請參閱閃爍設備。
小吃
tapas
命令配置非捆綁應用程序的構建。它選擇由 Android 構建系統構建的各個應用程序。與lunch
不同, tapas
不要求為設備構建圖像。
運行tapas help
以獲取有關該命令的更多信息。
構建代碼
本節是一個快速摘要,以確保設置完成。
用m
構建一切。 m
可以使用-jN
參數處理並行任務。如果您不提供-j
參數,構建系統會自動選擇它認為最適合您的系統的並行任務計數。
m
如上所述,您可以通過在m
命令行中列出特定模塊的名稱來構建特定模塊,而不是完整的設備映像。此外, m
還提供了一些用於特殊目的的偽目標。一些例子是:
-
droid
-m droid
是正常版本。該目標位於此處是因為默認目標需要名稱。 -
all
-m all
構建m droid
所做的所有內容,以及沒有droid
標籤的所有內容。構建服務器運行此命令以確保樹中包含Android.mk
文件的所有內容均已構建。 -
m
- 從樹的頂部運行構建。這很有用,因為您可以從子目錄中運行make
。如果您設置了TOP
環境變量,它將使用它。如果沒有,它會從當前目錄查找樹,嘗試找到樹的頂部。您可以通過運行不帶參數的m
來構建整個源代碼樹,也可以通過指定目標名稱來構建特定目標。 -
mma
- 構建當前目錄中的所有模塊及其依賴項。 -
mmma
- 構建提供的目錄中的所有模塊及其依賴項。 -
croot
-cd
到樹的頂部。 -
clean
-m clean
刪除此配置的所有輸出和中間文件。這與rm -rf out/
相同。
運行m help
查看m
提供的其他偽目標。
運行構建
您可以在模擬器上運行您的構建,也可以在設備上刷新它。因為您已經通過lunch
選擇了構建目標,所以它不太可能在與構建目標不同的目標上運行。
使用 fastboot 進行閃爍
要刷新設備,請使用fastboot
,成功構建後它應該包含在您的路徑中。有關說明,請參閱閃爍設備。
模擬 Android 設備
模擬器會通過構建過程自動添加到您的路徑中。要運行模擬器,請鍵入:
emulator
了解構建指紋
要跟踪和報告與特定 Android 構建相關的問題,了解構建指紋非常重要。版本指紋是一個唯一的、人類可讀的字符串,其中包含發布給每個版本的製造商信息。有關精確語法,請參閱 Android 兼容性定義文檔 (CDD) 的構建參數部分中的FINGERPRINT描述。
構建指紋代表特定的 Android 實現和修訂。這個獨特的密鑰允許應用程序開發人員和其他人報告特定固件版本的問題。請參閱報告 Android 問題報告流程的錯誤。
構建指紋封裝了所有 Android 實現細節:
- API:Android 和本機,以及軟 API 行為
- 核心API和一些系統UI行為
- CDD 中定義的兼容性和安全要求
- 應用程序用於滿足預期要求的目標設備的產品規格和使用功能設置
- 硬件和軟件組件的實現
有關完整詳細信息,請參閱CDD ;有關創建全新 Android 設備的說明,請參閱添加新設備。
排除常見構建錯誤
Java 版本錯誤
如果您嘗試構建與您的 Java 版本不一致的 Android 版本, make
如下消息中止:
************************************************************ You are attempting to build with the incorrect version of java. Your version is: WRONG_VERSION. The correct version is: RIGHT_VERSION. Please follow the machine setup instructions at https://source.android.com/source/initializing.html ************************************************************
以下是可能的原因和解決方案:
- 未能按照JDK 要求中指定的方式安裝正確的 JDK。確保您已按照設置環境和選擇目標中的步驟進行操作。
- 先前安裝的另一個 JDK 出現在您的路徑中。將正確的 JDK 添加到路徑的開頭或刪除有問題的 JDK。
沒有USB權限
默認情況下,在大多數 Linux 系統上,非特權用戶無法訪問 USB 端口。如果您看到權限被拒絕錯誤,請按照配置 USB 訪問中的說明進行操作。
如果ADB已經在運行並且在設置這些規則後無法連接到設備,您可以使用adb kill-server
終止它。該命令會導致 ADB 使用新配置重新啟動。