建構 Android

請按照本頁的操作說明建構 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_RELEASE-$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
************************************************************

以下是可能原因和解決方法：