本頁介紹如何使用Cuttlefish啟動 AOSP 建置。
驗證 KVM 可用性
Cuttlefish 是虛擬設備,依賴主機上可用的虛擬化。
在主機上的終端機中,確保基於核心的虛擬機 (KVM) 的虛擬化可用:
grep -c -w "vmx\|svm" /proc/cpuinfo
該命令應傳回一個非零值。
在 ARM 機器上運作時,最直接的方法是檢查/dev/kvm
:
find /dev -name kvm
發射墨魚
在終端機視窗中,下載、建置並安裝主機 Debian 軟體包:
sudo apt install -y git devscripts equivs config-package-dev debhelper-compat golang curl
git clone https://github.com/google/android-cuttlefish
cd android-cuttlefish
for dir in base frontend; do pushd $dir # Install build dependencies sudo mk-build-deps -i dpkg-buildpackage -uc -us popd done
sudo dpkg -i ./cuttlefish-base_*_*64.deb || sudo apt-get install -f
sudo dpkg -i ./cuttlefish-user_*_*64.deb || sudo apt-get install -f
sudo usermod -aG kvm,cvdnetwork,render $USER
sudo reboot
重新引導會觸發安裝其他核心模組並套用
udev
規則。Cuttlefish 是 Android 開源平台 (AOSP) 的一部分。虛擬設備的建置可以在 Android 持續整合網站上找到。若要尋找所有 Android 版本的索引,請導覽至 Android 持續整合網站: http://ci.android.com/ 。
輸入分支名稱。使用預設的
aosp-main
分支或使用通用系統映像 (GSI) 分支,例如aosp-android13-gsi
。導航至aosp_cf_x86_64_phone建置目標並按一下userdebug以取得最新建置。
點擊userdebug下面的綠色框選擇此建置。將出現“詳細資訊”面板,其中包含特定於此版本的更多資訊。在此面板中,按一下工件可查看附加至此建置的所有工件的清單。
在工件面板中,下載 Cuttlefish 的工件。
按一下
aosp_cf_x86_64_phone-img-xxxxxx.zip
工件,其中包含裝置映像。在檔案名稱中,「xxxxxx」是該裝置的建置 ID。在面板中向下捲動並下載
cvd-host_package.tar.gz
。始終從與映像相同的版本下載主機包。
在本機系統上,建立一個容器資料夾並提取套件:
mkdir cf
cd cf
tar -xvf /path/to/cvd-host_package.tar.gz
unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip
發射墨魚:
HOME=$PWD ./bin/launch_cvd --daemon
透過 adb 驗證 Cuttlefish 是否可見
與實體設備類似,Cuttlefish 透過Android 調試橋 (adb)可見。
在啟動 Cuttlefish 的相同資料夾中,執行以下命令以查看主機上透過 adb 可用的所有 Android 裝置的清單:
./bin/adb devices
在網路中查看虛擬設備並與之交互
預設情況下,Cuttlefish 使用--start_webrtc
啟動,這會透過主機上的連接埠 8443 啟用 Web 視圖。
若要查看虛擬設備並與之交互,請在 Web 瀏覽器中導航至https://localhost:8443 。
有關更多信息,請參閱Cuttlefish:WebRTC 流。
阻止墨魚
在用於啟動設備的相同目錄中停止虛擬設備:
HOME=$PWD ./bin/stop_cvd