Inizia

Questa pagina descrive come avviare una build AOSP utilizzando Cuttlefish .

Verificare la disponibilità KVM

Cuttlefish è un dispositivo virtuale e dipende dalla disponibilità della virtualizzazione sul computer host.

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

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

Questo comando dovrebbe restituire un valore diverso da zero.

Quando si esegue su una macchina ARM, il modo più diretto è verificare la presenza di /dev/kvm :

find /dev -name kvm

Lancia le seppie

  1. In una finestra di 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
    for dir in base frontend; do
      pushd $dir
      # Install build dependencies
      sudo mk-build-deps -i
      dpkg-buildpackage -uc -us
      popd
    done
    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 avvia l'installazione di moduli kernel aggiuntivi e applica le regole udev .

  2. Cuttlefish fa parte della piattaforma Android Open Source (AOSP). Le build del dispositivo virtuale si trovano nel sito Android Continuous Integration. Per trovare un indice di tutte le build Android, accedere al sito Android Continuous Integration all'indirizzo http://ci.android.com/ .

  3. Inserisci il nome di un ramo. Utilizza il ramo aosp-main predefinito oppure utilizza un ramo generico dell'immagine di sistema (GSI) come aosp-android13-gsi .

  4. Passare alla destinazione della build aosp_cf_x86_64_phone e fare clic su userdebug per la build più recente.

  5. Fare clic sulla casella verde sotto userdebug per selezionare questa build. Viene visualizzato un pannello Dettagli con ulteriori informazioni specifiche su questa build. In questo pannello, fai clic su Artefatti per visualizzare un elenco di tutti gli artefatti allegati a questa build.

  6. Nel pannello Artifatti, scarica gli artefatti per Cuttlefish.

    1. Fai clic sull'artefatto aosp_cf_x86_64_phone-img-xxxxxx.zip , che contiene le immagini del dispositivo. Nel nome file, "xxxxxx" è l'ID build di questo dispositivo.

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

  7. Sul tuo sistema locale, crea una cartella contenitore ed estrai i pacchetti:

    mkdir cf
    cd cf
    tar -xvf /path/to/cvd-host_package.tar.gz
    unzip /path/to/aosp_cf_x86_64_phone-img-xxxxxx.zip
    
  8. Lancio Seppie:

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

Verifica che Cuttlefish sia visibile tramite adb

Similmente ad un dispositivo fisico, Cuttlefish è visibile attraverso Android Debug Bridge (adb) .

Nella stessa cartella in cui hai avviato Cuttlefish, esegui il comando seguente per visualizzare un elenco di tutti i dispositivi Android disponibili tramite adb sul tuo computer host:

./bin/adb devices

Visualizza e interagisci con il dispositivo virtuale nel web

Per impostazione predefinita, Cuttlefish si avvia con --start_webrtc , che abilita una visualizzazione web tramite 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, consulta Cuttlefish: streaming WebRTC .

Stop alle seppie

Arresta il dispositivo virtuale nella stessa directory utilizzata per avviare il dispositivo:

HOME=$PWD ./bin/stop_cvd