Mulai

Halaman ini menjelaskan cara meluncurkan build AOSP menggunakan Cuttlefish.

Memverifikasi ketersediaan KVM

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

Di terminal pada mesin host Anda, pastikan virtualisasi dengan Mesin Virtual (KVM) berbasis Kernel tersedia:

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

Perintah ini akan menampilkan nilai bukan nol.

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

Saat berjalan di mesin ARM64, cara paling langsung adalah dengan 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
   

   Reboot akan memicu penginstalan modul kernel tambahan dan menerapkan aturan udev.

2. Cuttlefish adalah bagian dari Platform Open-Source Android (AOSP). Build perangkat virtual 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-main default atau gunakan cabang Generic System Image (GSI) seperti aosp-android13-gsi.

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

   Tips: Untuk ARM64, gunakan cabang aosp-main-throttled dan target perangkat aosp_cf_arm64_only_phone-trunk_staging-userdebug.

5. Klik kotak hijau di bawah userdebug untuk memilih build ini. Panel Details akan muncul dengan informasi selengkapnya yang spesifik untuk build ini. Di panel ini, klik Artifacts untuk melihat daftar semua artefak yang dilampirkan pada 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 gambar perangkat. Dalam nama file, "xxxxxx" adalah ID build untuk perangkat ini.

   2. Scroll ke bawah di panel, lalu 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
   

Memastikan Cuttlefish terlihat melalui adb

Mirip 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 mesin 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 pada mesin host.

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

Untuk informasi selengkapnya, lihat Cuttlefish: Streaming WebRTC.

Hentikan Sotong

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

HOME=$PWD ./bin/stop_cvd