本頁面說明如何在 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 測試版本。
如要使用建構作業啟動 Cuttlefish,請按照下列步驟操作:
cvd createCuttlefish 會使用您建構的目標 (
sdv_core_cf-aosp_current-userdebug) 執行。Cuttlefish 啟動後,系統會顯示以下訊息:VIRTUAL_DEVICE_BOOT_COMPLETED Virtual device booted successfully執行
adb即可連線至 Cuttlefish。執行
adb devices,確認建構作業正在執行。系統會顯示類似下方的結果:List of devices attached 0.0.0.0:6520 device執行
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 錯誤:
Cuttlefish 反覆異常終止
如果 Cuttlefish 進入當機迴圈:
- 如要停止所有 Cuttlefish 執行個體,請執行
cvd stop。 - 使用 Cuttlefish 重新測試版本。