下載、建構及執行

本頁面說明如何在 Cuttlefish 上下載、建構及執行 AAOS SDV。

取得 AAOS SDV 原始碼

請按照「下載 Android 原始碼」中的操作說明進行。

設定建構環境

在目前使用的目錄中,執行 envsetup.sh 指令碼,設定建構環境:

source build/envsetup.sh

這個指令碼會匯入多個指令,讓您使用 Android 原始碼,包括本頁使用的指令。如要查看指令碼的來源,請參閱 platform/build/envsetup.sh。如要查看內建說明,請輸入 hmm。

選擇一個目標

建構 SDV 前,請先找出要建構的目標。如要找出要建構的目標,請使用 lunch 指令,後面加上代表建構目標的字串。舉例來說,使用這個指令建構 Cuttlefish 模擬器的目標:

lunch sdv_core_cf-aosp_current-userdebug

這個指令會選取要建構的產品、版本設定和變數,並將所選項目儲存在環境中。

SDV 的 lunch 目標位於 device/google/sdv 目錄中的獨立 Git 專案。如要查看可用目標的詳細說明,請前往 device/google/sdv/README.md。主要的 Cuttlefish (cf) 目標如下:

  • sdv_core_cf-aosp_current-userdebug - 建構在 Cuttlefish (cf) 上執行的 AAOS SDV Core (sdv_core) 映像檔。
  • sdv_media_cf-aosp_current-userdebug - 使用 virtIO 虛擬化媒體 API (sdv_media) 建構 AAOS SDV Core 映像檔。
  • sdv_media_har_cf-aosp_current-userdebug - 建構映像檔,擴充 AAOS SDV 媒體 (sdv_media_cf) lunch 目標,納入高可用性轉譯器 (HAR)。HAR 會在啟動時自動執行。
  • sdv_ivi_cf-aosp_current-userdebug - 建構車用資訊娛樂系統 (IVI) 映像檔,其中包含 SDV 閘道和 Java 範例應用程式。
  • sdv_ivi_cf_ds-aosp_current-userdebug - 建構映像檔,擴充 AAOS SDV IVI 目標 (sdv_ivi_cf),並納入 Display Safety 的 DriverUI 和儀表板實作。

建構 AAOS SDV

執行下列指令來建構目標。視工作站規格而定,第一次建構作業需要 30 到 60 分鐘。後續建構作業所需的時間會大幅減少。

m

建構作業的輸出內容會顯示在 $OUT_DIR 中。如果您建構不同的目標,每個目標建構都會顯示在 $OUT_DIR 中。

使用 Cuttlefish 測試版本

建構 AAOS SDV 後,請使用 Cuttlefish 測試版本。

  1. 如要使用建構作業啟動 Cuttlefish,請按照下列步驟操作:

    cvd create

    Cuttlefish 會使用您建構的目標 (sdv_core_cf-aosp_current-userdebug) 執行。Cuttlefish 啟動後,系統會顯示以下訊息:

    VIRTUAL_DEVICE_BOOT_COMPLETED
    Virtual device booted successfully
  2. 執行 adb 即可連線至 Cuttlefish。

  3. 執行 adb devices,確認建構作業正在執行。系統會顯示類似下方的結果:

    List of devices attached
    0.0.0.0:6520 device
  4. 執行 cvd stop 關閉裝置。

如要使用不同版本執行多個 Cuttlefish 執行個體,請參閱「Cuttlefish:多用戶群」。

疑難排解

本節說明如何排解下載、建構或執行 AAOS SDV 時可能發生的錯誤。

RBE 錯誤

如果遇到任何遠端建構執行 (RBE) 錯誤,請從 .bashrc 或 .zshrc 中移除 USE_RBE 和 ENABLE_RBE_BOOTSTRAP 的定義

cvd:這部機器不支援 VM 管理工具 crosvm

如果 Cuttlefish 回報您的機器不支援 VM 管理員 crosvm,請執行下列指令安裝 Cuttlefish:

sudo apt install cuttlefish-common

找不到 cvd

如果收到 cvd not found 錯誤:

  1. 再次設定版本。
  2. 繼續執行「選擇目標」一節。

Cuttlefish 反覆異常終止

如果 Cuttlefish 進入當機迴圈:

  1. 如要停止所有 Cuttlefish 執行個體,請執行 cvd stop。
  2. 使用 Cuttlefish 重新測試版本。