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
• O host do app do Google Automotive exceto a imagem da API 28, porque o host só está disponível em dispositivos com a API 29 ou mais recente

28 29 30 32 33 34 x86 ARM Google Play Store Modo de compatibilidade Android Studio estável 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 para fazer o download. Consulte a tabela anterior para mais detalhes.

5. Clique em Apply e, em seguida, clique em OK.

   

Adicionar imagens do sistema de OEMs

Você também pode adicionar imagens de sistema específicas de OEM para a GM, Honda, Polestar, Volvo e outras montadoras. Siga as etapas nos sites para desenvolvedores dos OEM:

Em ordem alfabética (links em inglês):

1. GM
2. Honda
3. Polestar
4. 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 vêm com o Android Studio:

Nome	Resolução	Configurável	Compatibilidade	Disponibilidade
Automotivo (paisagem 1024p)	1024 x 768		Imagens do sistema da API 28-32 com a Google Play Store	Android Studio estável
Automotivo (1080p paisagem)	1080x600	✔	Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Android Studio estável
Automotivo (paisagem 1.408p) Recomendado para uso com as imagens da API 34	1408x792		Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Android Studio estável
Automotive (paisagem 1408p) com o Google Play Recomendado para uso com as imagens da API 34	1408x792		Imagens do sistema da API 33 e mais recentes com a Google Play Store	Android Studio estável
Retrato automotivo	800 x 1.280		Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Android Studio estável
Retrato grande de veículos	1280x1606	✔	Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Android Studio estável
Ultra grande angular automotivo	3904x1320	✔	Imagens do sistema da API 33 ou mais recente sem a Google Play Store	Android Studio estável
Tela distante do Automotive	1080x600		Imagens do sistema de exibição remota da API 32+ sem a Google Play Store	Android Studio estável
Tela distante do Automotive com o Google Play	1080x600		API 32+ imagens do sistema com tela distante com a Google Play Store	Android Studio estável

Criar um perfil de hardware

Se você quiser testar configurações de hardware diferentes daquelas cobertas pelos perfis de hardware agrupados, também poderá criar um perfil de hardware para usar com o emulador do Android Automotive OS. Para fazer 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 dos controles estendidos padrão disponíveis em outros emuladores Android, há alguns controles estendidos feitos especificamente para o emulador Android Automotive OS.

Emular o estado do 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 para veículos são comunicadas pela Camada de abstração de hardware do veículo (VHAL, na sigla em inglês). Essas propriedades são modeladas pela classe VehiclePropertyIds.

Enquanto o emulador está em execução, é possível modificar os valores dessas propriedades no recurso Dados do carro 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 direção, defina a Velocidade do carro como um valor diferente de zero e 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 os seletores na guia Dados do sensor do carro ou modificando as propriedades do 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 controle giratório, que depende das 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 Car rotary nos controles estendidos para testar o suporte do app à entrada rotativa.

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ídia usando intents explícitas e enviando chamadas para o serviço de navegador de mídia.

Para testar o 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 no emulador do Android Automotive OS

Se você encontrar um problema ou quiser sugerir um recurso ao usar o emulador do SO Android Automotive, informe o problema 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 no rastreador. Para mais informações, consulte Como se inscrever em um problema.

Conferir problemas atuais Criar um novo problema