Testar o código da plataforma com o atest

O Android Studio para plataforma (ASfP) se integra à ferramenta de linha de comando atest, permitindo que você execute testes no dispositivo ou emulador conectado diretamente do ambiente de desenvolvimento integrado.

Pré-requisitos

  • Abra um projeto ASfP com seu código-fonte do AOSP.
  • Crie e atualize o código em um dispositivo ou emulador.
  • Inicialize seu ambiente de build usando source build/envsetup.sh e lunch.

Executar testes

É possível executar testes usando atest no ASfP de várias maneiras:

  • Ícones de execução da margem:clique no ícone Executar .

    ao lado de uma classe ou método de teste no editor para executar esse teste específico.

  • Menu de clique com o botão direito:clique com o botão direito do mouse em um arquivo de teste, classe ou método na janela Project ou no editor e selecione Run 'atest'.

  • Usando o terminal:abra o terminal integrado no ASfP (View > Tool Windows > Terminal) e execute comandos atest diretamente. Por exemplo: bash atest MyTestModule atest MyTestClass#myTestMethod

Ver os resultados dos testes

Os resultados do teste são exibidos na janela de ferramentas Executar no ASfP. Essa janela mostra o progresso do teste, o status de aprovação ou reprovação e fornece registros e saída para cada teste.

Configurações de teste

Quando você executa um teste no gutter ou no menu de clique com o botão direito do mouse, o ASfP cria automaticamente uma configuração temporária de execução ou depuração. É possível modificar e salvar essas configurações para executar novamente os testes com opções ou flags específicas:

  1. Acesse Run > Edit Configurations.
  2. Encontre a configuração atest que você quer modificar ou crie uma clicando no botão + e selecionando atest.
  3. Especifique o módulo, a classe e o método de teste e adicione as opções de linha de comando atest necessárias.

Dicas para testes

  • Testes segmentados:execute apenas os testes específicos necessários para economizar tempo. Use o formato Module:Class#Method ou outros filtros atest.
  • Use snapshots do emulador:para execuções de teste mais rápidas em emuladores, considere usar snapshots para reverter rapidamente a um estado bom conhecido.
  • Verificar registros:use os registros na janela de ferramentas Executar para diagnosticar falhas de teste.