Mulai

Halaman ini menjelaskan cara meluncurkan build AOSP menggunakan Cuttlefish.

Memverifikasi ketersediaan KVM

Cuttlefish adalah perangkat virtual dan bergantung pada virtualisasi yang tersedia di mesin host.

Di terminal pada mesin host, pastikan virtualisasi dengan Kernel-based Virtual Machine (KVM) tersedia:

grep -c -w "vmx\|svm" /proc/cpuinfo

Perintah ini akan menampilkan nilai bukan nol.

Saat berjalan di mesin ARM64, cara paling langsung adalah memeriksa /dev/kvm:

find /dev -name kvm

Meluncurkan Cuttlefish

  1. Di jendela terminal, download, build, dan instal paket Debian host:

    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

    Mulai ulang memicu penginstalan modul kernel tambahan dan menerapkan aturan udev.

  2. Cuttlefish adalah bagian dari Platform Open Source Android (AOSP). Build perangkat virtual dapat ditemukan di situs Android Continuous Integration. Untuk menemukan indeks semua build Android, buka situs Android Continuous Integration di http://ci.android.com/.

  3. Masukkan nama cabang. Gunakan cabang aosp-android-latest-release default atau gunakan cabang generic system image (GSI) seperti aosp-android13-gsi.

  4. Buka target build aosp_cf_x86_64_only_phone, lalu klik userdebug untuk build terbaru.

  5. Klik kotak hijau di bawah userdebug untuk memilih build ini. Panel Details akan muncul dengan informasi selengkapnya khusus build ini. Di panel ini, klik Artefak untuk melihat daftar semua artefak yang dilampirkan ke build ini.

  6. Di panel Artifacts, download artefak untuk Cuttlefish.

    1. Klik artefak aosp_cf_x86_64_phone-img-xxxxxx.zip untuk x86_64 atau artefak aosp_cf_arm64_only_phone-xxxxxx.zip untuk ARM64, yang berisi image perangkat. Dalam nama file, "xxxxxx" adalah ID build untuk perangkat ini.

    2. Scroll ke bawah di panel dan download cvd-host_package.tar.gz. Selalu download paket host dari build yang sama dengan image Anda.

  7. Di sistem lokal, buat folder penampung dan ekstrak paket:

    1. Arsitektur 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

    2. Arsitektur 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

  8. Meluncurkan Cuttlefish:

    HOME=$PWD ./bin/launch_cvd --daemon

Memastikan Cuttlefish terlihat melalui adb

Serupa dengan perangkat fisik, Cuttlefish terlihat melalui Android Debug Bridge (adb).

Di folder yang sama tempat Anda meluncurkan Cuttlefish, jalankan perintah berikut untuk melihat daftar semua perangkat Android yang tersedia melalui adb di komputer host Anda:

./bin/adb devices

Melihat dan berinteraksi dengan perangkat virtual di web

Secara default, Cuttlefish diluncurkan dengan --start_webrtc, yang mengaktifkan webview melalui port 8443 di mesin host.

Untuk melihat dan berinteraksi dengan perangkat virtual, buka https://localhost:8443 di browser web Anda.

Untuk mengetahui informasi selengkapnya, lihat Cuttlefish: Streaming WebRTC.

Menghentikan Cuttlefish

Hentikan perangkat virtual dalam direktori yang sama dengan yang Anda gunakan untuk meluncurkan perangkat:

HOME=$PWD ./bin/stop_cvd