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 sia disponibile la virtualizzazione con una macchina virtuale (KVM) basata su kernel:

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 passaggi specifici del cloud o del fornitore per abilitare la KVM. Per Google Compute Engine (GCE), consulta Informazioni sulla virtualizzazione nidificata.

In esecuzione su una macchina ARM64, il modo più diretto è cercare /dev/kvm:

find /dev -name kvm

Suggerimento: puoi utilizzare questo comando per confermare il supporto di KVM su 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 moduli kernel aggiuntivi e applica le regole udev.

2. Cuttlefish fa parte di Android Open-Source Platform (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 della build aosp_cf_x86_64_phone e fai clic su userdebug per ottenere l'ultima build.

   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 Artefatti per visualizzare un elenco di tutti gli artefatti collegati a questa build.

6. Nel riquadro Artefatti, scarica gli artefatti di Seppia.

   1. Fai clic sull'artefatto aosp_cf_x86_64_phone-img-xxxxxx.zip per x86_64 o sull'artefatto aosp_cf_arm64_only_phone-xxxxxx.zip per ARM64, che contiene le immagini del dispositivo. Nel nome file, "xxxxxx" è l'ID build di 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 avviato Cuttlefish, esegui questo comando per visualizzare un elenco di tutti i dispositivi Android disponibili tramite adb sulla tua macchina host:

./bin/adb devices

Visualizza e interagisci con il dispositivo virtuale sul 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 maggiori informazioni, consulta Cuttlefish: streaming WebRTC.

Interrompi seppia

Arresta il dispositivo virtuale nella stessa directory che hai utilizzato per avviare il dispositivo:

HOME=$PWD ./bin/stop_cvd