Memulai

Halaman ini menjelaskan cara meluncurkan build AOSP menggunakan Sotong.

Memverifikasi ketersediaan KVM

Sotong adalah perangkat virtual dan tergantung pada virtualisasi yang yang tersedia di mesin {i>host<i}.

Dalam terminal pada mesin {i>host<i} Anda, pastikan bahwa virtualisasi dengan Tersedia Virtual Machine (KVM) berbasis Kernel:

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

Perintah ini akan menampilkan nilai bukan nol.

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

find /dev -name kvm

---

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 udev aturan.

2. Cuttlefish adalah bagian dari Platform Open-Source Android (AOSP). Build dari perangkat virtual ditemukan di situs Android Continuous Integration. Kepada temukan indeks dari semua build Android, buka Android Continuous Situs integrasi 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.

5. Klik kotak hijau di bawah userdebug untuk memilih build ini. Detail muncul dengan informasi yang lebih spesifik untuk bangunan ini. Di panel ini, klik Artefak untuk melihat daftar semua yang terpasang 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 image perangkat. Dalam nama file, "xxxxxx" adalah build-nya ID untuk perangkat ini.

   2. Scroll ke bawah di panel, lalu download cvd-host_package.tar.gz. Selalu mengunduh paket {i>host<i} dari {i>build <i} yang sama dengan gambar 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, Sotong 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 pada mesin host:

./bin/adb devices

Melihat dan berinteraksi dengan perangkat virtual di web

Secara default, Cuttlefish diluncurkan dengan --start_webrtc, yang memungkinkan webview melewati porta 8443 pada mesin {i>host<i}.

Untuk melihat dan berinteraksi dengan perangkat virtual Anda, 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