Inizia

Questa pagina descrive come avviare una build AOSP utilizzando Seppia.

Verificare la disponibilità delle KVM

La seppia è un dispositivo virtuale e dipende dal fatto che la virtualizzazione sia disponibili sul computer host.

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

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

Questo comando dovrebbe restituire un valore diverso da zero.

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

find /dev -name kvm

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 udev le regole del caso.

  2. Cuttlefish fa parte di Android Open-Source Platform (AOSP). Build di il dispositivo virtuale si trova sul sito Android Continuous Integration. A trovare un indice di tutte le build Android, vai alla Sito di integrazione all'indirizzo http://ci.android.com/.

  3. Inserisci un nome ramo. Utilizza il ramo aosp-main predefinito o un ramo immagine di sistema generica (GSI) ad esempio aosp-android13-gsi.

  4. Vai alla destinazione della build aosp_cf_x86_64_phone e fai clic su userdebug per l'ultima build.

  5. Fai clic sulla casella verde sotto userdebug per selezionare questa build. A Dettagli con ulteriori informazioni specifiche per questa build. In questo riquadro, fai clic su Artefatti per visualizzare un elenco di tutte le 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 oppure l'artefatto aosp_cf_arm64_only_phone-xxxxxx.zip per ARM64, contiene le immagini del dispositivo. Nel nome del file "xxxxxx" è la build ID per questo dispositivo.

    2. Scorri verso il basso nel riquadro e scarica cvd-host_package.tar.gz. Sempre scaricare 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, la seppia è visibile attraverso 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 sul tuo macchina host:

./bin/adb devices

Visualizza e interagisci con il dispositivo virtuale sul web

Per impostazione predefinita, Cuttlefish si avvia con --start_webrtc, che consente una WebView attraverso la porta 8443 sul computer host.

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

Per ulteriori informazioni, vedi Cuttlefish: streaming WebRTC.

Interrompi seppia

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

HOME=$PWD ./bin/stop_cvd