Testar usando o emulador do Android Automotive OS

Você pode usar o Android Emulator para testar como seu app é executado no Android Automotive OS.

Adicionar imagens do sistema

Antes de criar dispositivos virtuais do Android Automotive OS, é necessário adicionar imagens do sistema usando o SDK Manager do Android Studio.

Adicionar imagens genéricas do sistema

O Android Studio inclui imagens genéricas do sistema para o Android Automotive OS que podem ser usadas para testar seu app e para fazer capturas de tela do Google Play. Todas essas imagens incluem:

• Google Play Services
• Google Automotive App Host exceto a imagem da API 28, já que o host só está disponível em dispositivos com a API 29 ou mais recente

28 29 30 32 33 34 35 x86 ARM Google Play Store Modo de compatibilidade Áudio ao dirigir Versão estável do Android Studio Prévia do Android Studio Limpar tudo

Siga estas etapas para instalar imagens genéricas do sistema:

1. No Android Studio, selecione Tools > SDK Manager.
2. Clique na guia SDK Platforms.
3. Clique em Show Package Details.
4. Selecione as imagens que você quer baixar. Consulte a tabela anterior para mais detalhes.
5. Clique em Apply e, em seguida, clique em OK.

Adicionar imagens do sistema de OEMs

Também é possível adicionar imagens de sistema específicas de OEM. Siga as etapas nos sites para desenvolvedores dos OEM, em ordem alfabética:

1. General Motors (Chevrolet, Cadillac, GMC, Buick)
2. Honda
3. Mazda
4. Polestar
5. Grupo Renault (Renault, Alpine, Dacia)
6. Volvo

Criar um AVD de carro e executar o emulador

Siga as etapas abaixo para criar um Dispositivo virtual Android (AVD, na sigla em inglês) que represente um veículo com Android Automotive OS e use esse AVD para executar o emulador:

1. No Android Studio, selecione Tools > AVD Manager.
2. Clique em Create Virtual Device.
3. Na caixa de diálogo Select Hardware, selecione Automotive e escolha um perfil de hardware. Clique em Next.
4. Selecione uma imagem do sistema destinada ao Automotive, como Android 12L (Automotive with Play Store), e clique em Next.
5. Crie um nome para seu AVD, selecione outras opções que quiser personalizar e clique em Finish.
6. Na barra da janela de ferramentas, selecione seu AVD do Android Automotive OS como destino de implantação.
7. Clique em Run .

Usar perfis de hardware agrupados

Ao criar um AVD, você pode usar os seguintes perfis de hardware que estão incluídos no Android Studio:

Nome	Resolução	Configurável	Compatibilidade	Disponibilidade
Automotivo (paisagem 1024p)	1024 x 768		Imagens do sistema das APIs 28 a 32 com a Google Play Store	Versão estável do Android Studio
Automotivo (paisagem 1080p)	1080x600	✔	Imagens do sistema da API 33+ sem a Google Play Store	Versão estável do Android Studio
Automotivo (paisagem 1408p) Recomendado para uso com as imagens da API 34	1408x792		Imagens do sistema da API 33+ sem a Google Play Store	Versão estável do Android Studio
Automotive (paisagem 1408p) com Google Play Recomendado para uso com as imagens da API 34	1408x792		Imagens do sistema da API 33 ou mais recente com a Google Play Store	Versão estável do Android Studio
Retrato automotivo	800x1280		Imagens do sistema da API 33+ sem a Google Play Store	Versão estável do Android Studio
Retrato grande automotivo	1280x1606	✔	Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Android Studio estável
Automotivo ultra-wide	3904x1320	✔	Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Versão estável do Android Studio
Tela Distante do Automotive	1080x600		Imagens do sistema de tela distante da API 32+ sem a Google Play Store	Versão estável do Android Studio
Tela distante do Automotive com o Google Play	1080x600		Imagens do sistema de tela distante da API 32+ com a Google Play Store	Android Studio estável

Criar um perfil de hardware

Para testar configurações de hardware diferentes das cobertas pelos perfis de hardware agrupados, crie um perfil de hardware para usar com o emulador do Android Automotive OS. Para isso, selecione Android Automotive como o tipo de dispositivo no fluxo de criação. Os perfis de hardware personalizados são compatíveis apenas com imagens do sistema que não incluem a Google Play Store.

Usar os controles estendidos do emulador

Além de muitos dos controles estendidos padrão disponíveis em outros Android Emulators, há alguns controles estendidos feitos especificamente para o emulador do Android Automotive OS.

Emular estado de hardware

Além de sensores como acelerômetros e giroscópios que podem ser lidos usando as APIs padrão do Android quando disponíveis, outras propriedades de hardware exclusivas dos veículos são comunicadas pela camada de abstração de hardware do veículo (VHAL). Essas propriedades são modeladas pela classe VehiclePropertyIds.

Enquanto o emulador estiver em execução, você poderá modificar os valores dessas propriedades no recurso Car data dos controles estendidos. Por exemplo, para definir a velocidade atual do veículo, encontre a propriedade de velocidade (VehiclePropertyIds.PERF_VEHICLE_SPEED) e mude o valor dela.

Simular a direção

Para simular a condução, defina a Velocidade do carro como um valor diferente de zero e a Marcha como algo diferente de P (Estacionamento). Para simular um estado estacionado, basta definir a Marcha como P (Estacionamento). Isso pode ser feito usando os controles deslizantes e seletores na guia Dados do sensor do carro ou modificando as propriedades da VHAL, conforme descrito na seção anterior.

Testar a entrada por seletor giratório

Além de uma tela touch, alguns veículos com Android Automotive OS vêm equipados com um controlador rotativo, que usa as mesmas APIs de foco da navegação por teclado para permitir que os usuários naveguem pelo app sem tocar na tela. Você pode usar a ferramenta Seletor giratório do carro nos controles estendidos para testar o suporte do app à entrada por seletor giratório.

Editar as configurações de execução para apps de música

Apps de música em apps do SO do Android Automotive são diferentes de outros apps Android. O Android Automotive OS interage com o app de música usando intents explícitas e enviando chamadas para o serviço de navegador de mídia.

Para testar seu app, verifique se não há nenhuma atividade de inicialização no manifesto e evite que o módulo automotivo seja iniciado com uma atividade. Siga estas etapas:

1. No Android Studio, selecione Run > Edit Configurations.

   

2. Selecione seu módulo automotivo na lista de módulos do seu app.

3. Em Launch Options > Launch, selecione Nothing.

4. Clique em Apply e depois clique em OK.

Informar um problema com o emulador do Android Automotive OS

Se você tiver um problema ou uma solicitação de recurso ao usar o emulador do Android Automotive OS, poderá reportá-lo usando o Google Issue Tracker. Preencha todas as informações solicitadas no modelo de problema. Antes de informar um novo problema, verifique se ele já foi comunicado na lista de problemas. Inscreva-se e vote nos problemas clicando na estrela de um deles na lista de problemas. Para mais informações, consulte Inscrever-se em um problema.

Ver problemas Criar um novo problema