Use o Cuttlefish para iniciar uma compilação AOSP

Esta página descreve como iniciar uma compilação AOSP usando o Cuttlefish .

Verifique a disponibilidade do KVM

O Cuttlefish é um dispositivo virtual e depende da virtualização disponível na máquina host.

Em um terminal em sua máquina host, certifique-se de que a virtualização com uma máquina virtual baseada em kernel (KVM) esteja disponível:

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

Este comando deve retornar um valor diferente de zero.

Observação: em uma máquina em nuvem, pode ser necessário seguir etapas específicas da nuvem ou específicas do fornecedor para habilitar o KVM. Para o Google Compute Engine (GCE), consulte Sobre a virtualização aninhada .

Ao executar em uma máquina ARM, a maneira mais direta é verificar /dev/kvm :

find /dev -name kvm

Dica: você pode usar este comando para confirmar o suporte do KVM em qualquer ambiente.

---

Lançar Chocos

1. Em uma janela de terminal, baixe, construa e instale os pacotes host Debian:

   sudo apt install -y git devscripts config-package-dev debhelper-compat golang curl
   git clone https://github.com/google/android-cuttlefish
   cd android-cuttlefish
   for dir in base frontend; do
     cd $dir
     debuild -i -us -uc -b -d
     cd ..
   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
   

   A reinicialização aciona a instalação de módulos adicionais do kernel e aplica as regras do udev .

2. O Cuttlefish faz parte da plataforma de código aberto Android (AOSP). As compilações do dispositivo virtual são encontradas no site Android Continuous Integration. Para encontrar um índice de todas as compilações do Android, navegue até o site Android Continuous Integration em http://ci.android.com/ .

3. Digite um nome de ramificação. Use a aosp-master padrão ou use uma ramificação de imagem de sistema genérica (GSI) , como aosp-android13-gsi .

4. Navegue até o destino de compilação aosp_cf_x86_64_phone e clique em userdebug para obter a compilação mais recente.

   Dica: Para ARM, use a ramificação aosp-master-throttled-copped e o destino do dispositivo aosp_cf_arm64_only_phone-userdebug .

5. Clique na caixa verde abaixo de userdebug para selecionar esta compilação. Um painel Detalhes aparece com mais informações específicas para esta compilação. Neste painel, clique em Artefatos para ver uma lista de todos os artefatos anexados a esta construção.

6. No painel Artefatos, baixe os artefatos para Cuttlefish.

   1. Clique no artefato aosp_cf_x86_64_phone-img-xxxxxx.zip , que contém as imagens do dispositivo. No nome do arquivo, "xxxxxx" é o ID de compilação para este dispositivo.

   2. Role para baixo no painel e baixe cvd-host_package.tar.gz . Sempre baixe o pacote de host da mesma compilação de suas imagens.

7. Em seu sistema local, crie uma pasta container e extraia os pacotes:

   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. Lançamento Choco:

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

Verifique se o Cuttlefish está visível através do adb

Semelhante a um dispositivo físico, o Cuttlefish é visível por meio do Android Debug Bridge (adb) .

Na mesma pasta em que você iniciou o Cuttlefish, execute o seguinte comando para ver uma lista de todos os dispositivos Android disponíveis por meio do adb em sua máquina host:

./bin/adb devices

Visualize e interaja com o dispositivo virtual na web

Por padrão, o Cuttlefish é iniciado com --start_webrtc , que permite uma visualização da Web por meio da porta 8443 na máquina host.

Para visualizar e interagir com seus dispositivos virtuais, navegue até https://localhost:8443 em seu navegador da web.

Para obter mais informações, consulte Cuttlefish: WebRTC Streaming .

Stop Chocos

Pare o dispositivo virtual no mesmo diretório usado para iniciar o dispositivo:

HOME=$PWD ./bin/stop_cvd