Empezar

Esta página describe cómo iniciar una compilación AOSP usando Cuttlefish .

Verificar la disponibilidad de KVM

Cuttlefish es un dispositivo virtual y depende de que la virtualización esté disponible en la máquina host.

En una terminal de su máquina host, asegúrese de que la virtualización con una máquina virtual basada en kernel (KVM) esté disponible:

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

Este comando debería devolver un valor distinto de cero.

Cuando se ejecuta en una máquina ARM, la forma más directa es verificar /dev/kvm :

find /dev -name kvm

Lanzar Sepia

  1. En una ventana de terminal, descargue, cree e instale los paquetes del host Debian:

    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
    

    El reinicio activa la instalación de módulos de kernel adicionales y aplica reglas udev .

  2. Cuttlefish es parte de la plataforma de código abierto de Android (AOSP). Las compilaciones del dispositivo virtual se encuentran en el sitio de integración continua de Android. Para encontrar un índice de todas las compilaciones de Android, vaya al sitio de integración continua de Android en http://ci.android.com/ .

  3. Ingrese un nombre de sucursal. Utilice la rama aosp-main predeterminada o utilice una rama de imagen genérica del sistema (GSI) como aosp-android13-gsi .

  4. Navegue hasta el destino de compilación aosp_cf_x86_64_phone y haga clic en userdebug para obtener la última compilación.

  5. Haga clic en el cuadro verde debajo de userdebug para seleccionar esta compilación. Aparece un panel de Detalles con más información específica de esta compilación. En este panel, haga clic en Artefactos para ver una lista de todos los artefactos adjuntos a esta compilación.

  6. En el panel Artefactos, descargue los artefactos para Cuttlefish.

    1. Haga clic en el artefacto aosp_cf_x86_64_phone-img-xxxxxx.zip , que contiene las imágenes del dispositivo. En el nombre del archivo, "xxxxxx" es el ID de compilación de este dispositivo.

    2. Desplácese hacia abajo en el panel y descargue cvd-host_package.tar.gz . Descargue siempre el paquete de host de la misma compilación que sus imágenes.

  7. En su sistema local, cree una carpeta contenedora y extraiga los paquetes:

    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. Lanzar Sepia:

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

Verifique que Cuttlefish sea visible a través de adb

De manera similar a un dispositivo físico, Cuttlefish es visible a través del Puente de depuración de Android (adb) .

En la misma carpeta donde inició Cuttlefish, ejecute el siguiente comando para ver una lista de todos los dispositivos Android disponibles a través de adb en su máquina host:

./bin/adb devices

Ver e interactuar con el dispositivo virtual en la web.

De forma predeterminada, Cuttlefish se inicia con --start_webrtc , que habilita una vista web a través del puerto 8443 en la máquina host.

Para ver e interactuar con sus dispositivos virtuales, navegue hasta https://localhost:8443 en su navegador web.

Para obtener más información, consulte Sepia: transmisión WebRTC .

Detener la sepia

Detenga el dispositivo virtual dentro del mismo directorio que utilizó para iniciar el dispositivo:

HOME=$PWD ./bin/stop_cvd