Começar

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

Verifique a disponibilidade do KVM

Cuttlefish é um dispositivo virtual e depende da disponibilidade de virtualização na máquina host.

Em um terminal na 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.

Nota: Em uma máquina na nuvem, talvez seja necessário seguir etapas específicas da nuvem ou do fornecedor para ativar o KVM. Para Google Compute Engine (GCE), consulte Sobre 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 Choco

1. Em uma janela de terminal, baixe, construa e instale os pacotes 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
   

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

2. O choco faz parte da plataforma Android Open-Source (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 de integração contínua do Android em http://ci.android.com/ .

3. Insira um nome de filial. Use a ramificação padrão aosp-main ou uma ramificação de imagem genérica do sistema (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 o branch aosp-main-throttled e o destino do dispositivo aosp_cf_arm64_only_phone-trunk_staging-userdebug .

5. Clique na caixa verde abaixo do 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 deste dispositivo.

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

7. No seu sistema local, crie uma pasta contêiner 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çar Choco:

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

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

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

Na mesma pasta onde você iniciou o Cuttlefish, execute o seguinte comando para ver uma lista de todos os dispositivos Android disponíveis através 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 na web através da porta 8443 na máquina host.

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

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

Pare de choco

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

HOME=$PWD ./bin/stop_cvd