本頁面說明如何使用 Cuttlefish 啟動 Android 開放原始碼計畫版本。
確認 KVM 可用性
Cuttlefish 是一種虛擬裝置,需要在主機機器上使用虛擬化功能。
在主體機器的終端機中,確認可透過核心型虛擬機器 (KVM) 進行虛擬化:
grep -c -w "vmx\|svm" /proc/cpuinfo
這個指令應傳回非零的值。
在 ARM64 機器上執行時,最直接的方法就是檢查 /dev/kvm
:
find /dev -name kvm
啟動 Cuttlefish
在終端機視窗中,下載、建構及安裝主機 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
tools/buildutils/build_packages.sh
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」下方的綠色方塊,即可選取這個版本。「Details」面板隨即顯示,並顯示更多有關此建構作業的詳細資訊。在這個面板中按一下「Artifacts」,即可查看附加至這個版本的所有成果清單。
在「Artifacts」面板中,下載 Cuttlefish 的構件。
按一下 x86_64 的
aosp_cf_x86_64_phone-img-xxxxxx.zip
構件或 ARM64 的aosp_cf_arm64_only_phone-xxxxxx.zip
構件,其中包含裝置映像檔。在檔案名稱中,「xxxxxx」是這部裝置的建構 ID。在面板中向下捲動並下載
cvd-host_package.tar.gz
。請一律從與映像檔相同的版本下載主機套件。
在本機系統上建立容器資料夾並擷取套件:
x86_64 架構:
mkdir cf
cd cf
tar -xvf /path/to/cvd-host_package.tar.gz
unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip
ARM64 架構:
mkdir cf
cd cf
tar -xvf /path/to/cvd-host_package.tar.gz
unzip /path/to/aosp_cf_arm64_only_phone-img-xxxxxx.zip
啟動 Cuttlefish:
HOME=$PWD ./bin/launch_cvd --daemon
確認可透過 ADB 看見 Cuttlefish
與實體裝置類似,則可透過 Android Debug Bridge (ADB) 查看 Cuttlefish。
在您啟動 Cuttlefish 的資料夾中,執行下列指令,查看透過主體機器 ADB 取得的所有 Android 裝置清單:
./bin/adb devices
在網路上查看虛擬裝置並進行互動
根據預設,Cuttlefish 預設使用 --start_webrtc
啟動,可透過主機上的通訊埠 8443 啟用 WebView。
如要查看虛擬裝置並與之互動,請在網路瀏覽器中前往 https://localhost:8443。
詳情請參閱 Cuttlefish:WebRTC 串流。
停止 Cuttlefish
在啟動裝置時使用的目錄中停止虛擬裝置:
HOME=$PWD ./bin/stop_cvd