Como configurar o AVD para testar apps no Android TV

Atualizado 2026-10-28

Por que o AVD é essencial para desenvolver e testar no Android TV

Desenvolvedores que precisam validar funcionalidades de interface, controle remoto ou integração de serviços antes de enviar a build para a Google Play Store costumam usar o Android Virtual Device (AVD) como ambiente isolado. No caso do Android TV, o problema não é apenas validar o app na tela; é garantir que ele se carregue corretamente quando o usuário acessar o menu de apps da plataforma. Criar um AVD com a configuração certa reduz a chance de surpresas após a publicação, especialmente em dispositivos com resolução menor e navegação orientada por blocos.

O Android TV usa o mesmo framework de emulador do Android Studio, mas exige um set de drivers e configurações específicas para funcionar perfeitamente. O metodo mais confiável para testar apps de TV antes de flutuar a Play Store é configurar um AVD com um layout TV (1920x1080 ou 1280x720, depending on the emulator), e habitualmente com a API level que corresponde ao firmware da TV que você pretende suportar.

Passo a passo: criar o AVD no Android Studio

Abra o Android Studio, selecione Configurações > Dispositivos virtuais e clique em Adicionar um AVD. Em seguida, preencha os campos obrigatórios:

• Nome: algo como “TV Test - AVD”. Use nomes que ajudem a identificar a configuração mais tarde.
• Resolução: escolha uma resolução nativa da TV, no mínimo 1280x720. O Google recomenda 1280x720 ou superior para a maioria dos casos.
• Placa virtual: selecione o emulador que você vai usar para rodar o AVD (generalmente x86_64 para a maioria dos PCs).
• Active AVD: marque para ativar o dispositivo imediatamente.

Na aba Dispositivo, configure o tempo de inicialização do emulador, se necessário, e salve. O Android Studio baixará o system image correspondente — escolha a API level que corresponde ao seu target de TV (geralmente 30 para Android 11, 31 para Android 12, ou a versão mais próxima suportada pelo fabricante da TV).

Se quiser um AVD com uma resolução maior, use o AVD Manager para editar as propriedades do emulador depois de criado. Você pode forçar um frame rate maior, ajustar a memória RAM e desativar recursos desnecessários que ocupam espaço no disco.

Selecionar o sistema de tela e opções de TV no AVD

A escolha do sistema de tela (schema) define os drivers de input que o emulador usa. Para Android TV, selecione tv” schema ou tv-hd quando disponível. Esses schemas trazem compatibilidade com o controle remoto do Pixel Remote ou de controles de terceiros com botões de navegação específicos.

Ative também a opção Usar tela em landscape se o seu emulador não mostrar a resolução HD nativa da TV. Isso evita que o app teste fique invertido ou com proporção errada durante a execução. Se o seu emulador não oferecer schemas de TV, pode ser necessário usar um firmware customizado do Google ou um AVD baseado em Android x86 com suporte a TV.

Outra configuração importante é o input method: no AVD, vá em Configurações > Dispositivo > Input method e escolha o teclado em tela com layout adequado para TV (teclado de tela com botões numéricos e setas é muito útil na prática). Sem isso, o app de teste pode não ser selecionado corretamente quando você pressiona o botão de input.

Como instalar e flutuar o app de teste no AVD

Com o AVD rodando, abra o Google Play Store dentro do emulator. Se a Play Store não estiver disponível no emulador, instale-a manualmente baixando o APK do app de teste da sua conta ou de um site confiável. O processo é semelhante ao que você faria na TV: pesquise por “Test App - UI” ou qualquer app de demonstração que você queira validar, baixe e instale.

Depois que o app estiver instalado, abra-o. Se ele abrir e funcionar sem crashes, o AVD está configurado corretamente. Se o app travar na tela inicial, provavelmente é porque o schema de tela não suporta aquele tipo de interface ou porque o app precisa de recursos de hardware que o emulador não replica.

Quando estiver satisfeito, utilize o comando adb shell am start -n com.example.testcompletion.com/com.example.testapp para flutuar o app na tela do AVD e verificar se o comportamento é o esperado. Para flutuar um app na TV real, você pode usar adb shell am com o pacote do app, mas a experiência de navegação é melhor quando você testa primeiro no emulador.

Dicas práticas e armadilhas comuns ao testar no AVD

• Prefira um AVD com API level correspondente ao firmware da TV que você pretende suportar. Testar um app em API 33 contra um firmware de TV com API 30 pode revelar bugs de renderização que só aparecem em versões mais antigas.
• Desative funcionalidades que você não vai testar. Se o seu app não precisa de Bluetooth, desative-o no AVD; menos recursos significam emuladores mais leves e tempos de build menores.
• Não confie apenas no emulador para testar recursos de TV exclusivos, como a integração com Chromecast, o controle via Voice Access ou o uso do D-pad. Para validação completa, você precisa testar na própria TV.
• Realize testes com o screen mirroring (USB ou Wi-Fi) para confirmar se o app aparece e funciona no ambiente de TV real, e não apenas no emulador.
• Mantenha o AVD sincronizado com o firmware da TV que você pretende lançar. Uma diferença entre a API do AVD e a do firmware pode causar incompatibilidades que só aparecem em produção.

Testar em um AVD bem configurado economiza horas de retrabalho. Ao seguir este guia, você consegue validar apps de TV com confiança, antes de colocar na loja e distribuir para os usuários finais.

Leia também: mais sobre Android TV