Testar o código da plataforma com o atest
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 play_circle.
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:
- Acesse Run > Edit Configurations.
- Encontre a configuração
atest que você quer modificar ou crie uma clicando no botão + e selecionando atest.
- 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.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-09-05 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[],[],null,["Android Studio for Platform (ASfP) integrates with the `atest` command-line\ntool, letting you run tests on your connected device or emulator directly from\nthe IDE.\n\nPrerequisites\n\n- Open an ASfP project with your AOSP source code.\n- Successfully build and flash your code to a device or emulator.\n- Initialize your build environment using `source build/envsetup.sh` and `lunch`.\n\nRun tests\n\nYou can run tests using `atest` in ASfP in several ways:\n\n- **Gutter run icons:** Click the **Run** icon play_circle\n\n next to a test class or method in the editor to run that specific test.\n- **Right-click menu:** Right-click on a test file, class, or method in the\n Project window or editor and select **Run 'atest'**.\n\n- **Using the terminal:** Open the integrated terminal in ASfP (**View \\\u003e Tool\n Windows \\\u003e Terminal** ) and run `atest` commands directly. For example: `bash\n atest MyTestModule\n atest MyTestClass#myTestMethod`\n\nView test results\n\nTest results are displayed in the **Run** tool window within ASfP. This window\nshows the test progress, pass or fail status, and provides logs and output for\neach test.\n\nTest configurations\n\nWhen you run a test from the gutter or right-click menu, ASfP automatically\ncreates a temporary run or debug configuration. You can modify and save these\nconfigurations to quickly re-run tests with specific options or flags:\n\n1. Go to **Run \\\u003e Edit Configurations**.\n2. Find the `atest` configuration you want to modify or create a new one by clicking the **+** button and selecting **atest**.\n3. Specify the test module, class, method, and add any necessary `atest` command-line options.\n\nTips for testing\n\n- **Targeted testing:** Run only the specific tests you need to save time. Use the format `Module:Class#Method` or other `atest` filters.\n- **Use emulator snapshots:** For faster test runs on emulators, consider using snapshots to quickly revert to a known good state.\n- **Check logs:** Use the logs in the **Run** tool window to diagnose any test failures."]]
