Mulai

Halaman ini menjelaskan cara meluncurkan build AOSP menggunakan Cuttlefish.

Memverifikasi ketersediaan KVM

Cuttlefish adalah perangkat virtual dan bergantung pada ketersediaan virtualisasi 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.

Catatan: Di mesin cloud, Anda mungkin perlu mengikuti langkah-langkah khusus cloud atau khusus vendor untuk mengaktifkan KVM. Untuk Google Compute Engine (GCE), lihat Tentang virtualisasi bertingkat.

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

find /dev -name kvm

Tips: Anda dapat menggunakan perintah ini untuk mengonfirmasi dukungan KVM di lingkungan mana pun.

---

Luncurkan Cuttlefish

1. Di jendela terminal, download, bangun, 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 Integrasi Berkelanjutan Android 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 dan klik userdebug untuk build terbaru.

   Tips: Untuk ARM64, gunakan cabang aosp-android-latest-release dan target perangkat aosp_cf_arm64_only_phone-userdebug.

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

6. Di panel Artefak, 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 Anda, buat folder container 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. Luncurkan Cuttlefish:

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

Pastikan Cuttlefish terlihat melalui adb

Mirip dengan perangkat fisik, Cuttlefish dapat dilihat 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 Anda, 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 seperti yang Anda gunakan untuk meluncurkan perangkat:

HOME=$PWD ./bin/stop_cvd