Per iniziare

Questa pagina descrive come avviare una build AOSP utilizzando Cuttlefish.

Verifica la disponibilità del KVM

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

In un terminal 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 deve restituire un valore diverso da zero.

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

find /dev -name kvm

Avvia Cuttlefish

1. In una finestra del terminale, scarica, compila e installa i pacchetti Debian dell'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 di Android, vai al sito di integrazione continua di Android all'indirizzo http://ci.android.com/.

3. Inserisci un nome per il ramo. Utilizza il ramo predefinito aosp-android-latest-release o un ramo dell'immagine di sistema generica (GSI) come aosp-android13-gsi.

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

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.aosp_cf_arm64_only_phone-xxxxxx.zip 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. Sul sistema locale, crea una cartella del contenitore 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 Cuttlefish:

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

Verificare che Cuttlefish 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 si avvia con --start_webrtc, che attiva una visualizzazione web 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.

Interrompi seppia

Interrompi il dispositivo virtuale nella stessa directory utilizzata per avviarlo:

HOME=$PWD ./bin/stop_cvd