請按照本頁的操作說明建構 Android。
設定建構環境
在工作目錄中取得 envsetup.sh
指令碼,以設定建構環境:
source build/envsetup.sh
這個指令碼會匯入多個指令,方便您使用 Android 原始碼,包括本頁中使用的指令。如要查看指令碼的來源,請參閱 platform/build/envsetup.sh
。如要查看內建說明,請輸入 hmm
。
選擇目標
在建構 Android 之前,您必須找出要建構的目標。目標反映您要建構的目標平台。如要找出要建構的目標,請使用 lunch
指令,後面加上代表目標的字串。舉例來說:
lunch aosp_cf_x86_64_phone-trunk_staging-userdebug
查看目前的目標
如要查看目前的午餐設定,請執行:
$ echo "$TARGET_PRODUCT-$TARGET_BUILD_VARIANT"
代表目標的字串具有以下格式:
lunch product_name-release-build_variant
此字串的元件如下:
product_name 是您要建構的產品名稱,例如
aosp_cf_x86_64_phone
或aosp_husky
。特定 product_name 可以採用您裝置專屬的格式,但 Google 針對裝置採用的格式具有下列元件:aosp
是指 Android 開放原始碼平台。- (選用) 如果目標要在 Cuttlefish 模擬器中執行,請加入
cf
。 - 架構和硬體 (產品代號),例如
x86_64_phone
或husky
,即 Pixel 8 Pro 的代號。如需 Google 裝置的代號清單,請參閱「裝置產品代號」。
release 已設為
trunk_staging
。字串的 build_variant 部分可以是下表三個值的其中一個:
build_variant 說明 user
這個建構變數提供的安全性存取權有限,適用於正式版。 userdebug
此建構變數可協助裝置開發人員瞭解開發中版本的效能和功能。使用 userdebug
版本進行開發時,請遵循 userdebug 指南。eng 這個建構變化版本的建構時間較短,如果您不在意效能和效能,則非常適合日常開發作業。
如果執行 lunch
時沒有任何引數,系統會提供常見目標的清單。您也可以在「裝置代號」上結合目標字串的元素,以及代表特定 Google 硬體的代號,藉此建立自己的目標字串。
建構程式碼
執行下列指令來建構目標。視工作站的規格而定,首次建構可能需要不到 1 小時,最多需要數小時的時間。後續建構所需的時間會大幅減少。
$ m
您應該看到的第一個輸出內容是目標和建構環境的概要:
============================================
PLATFORM_VERSION_CODENAME=VanillaIceCream
PLATFORM_VERSION=VanillaIceCream
PRODUCT_INCLUDE_TAGS=com.android.mainline
TARGET_PRODUCT=aosp_arm
TARGET_BUILD_VARIANT=eng
TARGET_ARCH=arm
TARGET_ARCH_VARIANT=armv7-a-neon
TARGET_CPU_VARIANT=generic
HOST_OS=linux
HOST_OS_EXTRA=Linux-6.5.13-1rodete2-amd64-x86_64-Debian-GNU/Linux-rodete
HOST_CROSS_OS=windows
BUILD_ID=AOSP.MAIN
OUT_DIR=out
============================================
建構作業的輸出內容會顯示在 $OUT_DIR
中。如果您要建構不同的目標,每個目標版本都會顯示在 $OUT_DIR
中。
m
指令是從樹狀結構頂端建構,因此您可以在子目錄中執行 m
。如果您已設定 TOP
環境變數,m
指令會使用該變數。如果未設定 TOP
,m
指令會在目前的目錄中查詢樹狀結構,嘗試尋找樹狀結構的頂部。
m
指令可以透過 -jN
引數處理平行工作。如未提供 -j
引數,建構系統會自動選取系統認為最適合您系統的平行工作數量。
您可以在 m
指令列中列出模組名稱,藉此建構特定模組,而非完整裝置映像檔。此外,m
指令提供了一些稱為「目標」的虛擬目標。例如,m nothing
不會建構任何內容,但會剖析並驗證建構結構。如需有效目標的清單,請輸入 m help
。
排解建構錯誤 (8.0 以下版本)
如果您是建構 Android 開放原始碼計畫 8 以下版本,則 m
發生 Java 版本問題時,可能會取消。例如,您可能會收到以下訊息:
************************************************************
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
************************************************************
以下是可能原因和解決方法:
- 您未依照「設定 Android 開放原始碼計畫開發作業 (2.3 - 8.0) 」一文中 JDK 一節指定的正確 JDK 安裝。
- 您的路徑中會出現另一個先前安裝的 JDK。請在路徑開頭加上正確的 JDK,或移除有問題的 JDK。