Per iniziare

In questa pagina viene descritto come avviare una build AOSP utilizzando Seppia.

Verificare la disponibilità delle KVM

Seppia è un dispositivo virtuale e dipende dalla disponibilità della virtualizzazione sulla macchina host.

In un terminale sulla macchina host, assicurati che la virtualizzazione con una macchina virtuale basata su kernel (KVM) sia disponibile:

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

Questo comando dovrebbe restituire un valore diverso da zero.

Nota: su una macchina cloud, potrebbe essere necessario seguire procedure specifiche per il cloud o per il fornitore per attivare KVM. Per Google Compute Engine (GCE), consulta Informazioni sulla virtualizzazione nidificata.

Quando viene eseguito su una macchina ARM64, il modo più diretto è verificare la presenza di /dev/kvm:

find /dev -name kvm

Suggerimento: puoi utilizzare questo comando per verificare il supporto di KVM in qualsiasi ambiente.

---

Lancia seppia

1. In una finestra del terminale, scarica, crea e installa i pacchetti 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

   Il riavvio attiva l'installazione di ulteriori moduli del kernel e applica le regole udev.

2. Cuttlefish fa parte della piattaforma open source Android (AOSP). Le build del dispositivo virtuale sono disponibili sul sito di integrazione continua di Android. Per trovare un indice di tutte le build Android, visita il sito di integrazione continua di Android all'indirizzo http://ci.android.com/.

3. Inserisci un nome ramo. Utilizza il ramo aosp-main predefinito oppure un ramo GSI (Generic System Image Image), ad esempio aosp-android13-gsi.

4. Vai al target di build aosp_cf_x86_64_phone e fai clic su userdebug per la build più recente.

   Suggerimento: per ARM64, utilizza il ramo aosp-main-throttled e il dispositivo target aosp_cf_arm64_only_phone-trunk_staging-userdebug.

5. Fai clic sulla casella verde sotto userdebug per selezionare questa build. Viene visualizzato un riquadro Dettagli con ulteriori informazioni specifiche per questa build. In questo riquadro, fai clic su Elementi per visualizzare un elenco di tutti gli elementi associati a questa build.

6. Nel riquadro Artefatti, scarica gli elementi per Cuttlefish.

   1. Fai clic sull'elemento aosp_cf_x86_64_phone-img-xxxxxx.zip per x86_64 o sull'elemento aosp_cf_x86_64_phone-img-xxxxxx.zip per ARM64, che contiene le immagini del dispositivo. Nel nome file, "xxxxxx" è l'ID compilazione per questo dispositivo.

   2. Scorri verso il basso nel riquadro e scarica cvd-host_package.tar.gz. Scarica sempre il pacchetto host dalla stessa build delle immagini.

7. Nel tuo sistema locale, crea una cartella container ed estrai i pacchetti:

   1. architettura 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. Architettura 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. Avvia Seppia:

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

Verifica che la seppia sia visibile tramite ADB

Come un dispositivo fisico, Cuttlefish è visibile tramite Android Debug Bridge (adb).

Nella stessa cartella in cui hai lanciato Cuttlefish, esegui il seguente comando per visualizzare un elenco di tutti i dispositivi Android disponibili tramite adb sulla macchina host:

./bin/adb devices

Visualizzare e interagire con il dispositivo virtuale nel web

Per impostazione predefinita, Cuttlefish viene avviata con --start_webrtc, che attiva una WebView tramite la porta 8443 sulla macchina host.

Per visualizzare e interagire con i tuoi dispositivi virtuali, vai all'indirizzo https://localhost:8443 nel browser web.

Per ulteriori informazioni, consulta Cuttlefish: streaming WebRTC.

Stop Cuttlefish

Interrompi il dispositivo virtuale nella stessa directory utilizzata per avviarlo:

HOME=$PWD ./bin/stop_cvd