Testar o layout do Compose

Teste a interface do app para verificar se o comportamento do código do Compose está correto. Assim, você detecta erros com antecedência e melhora a qualidade do app.

O Compose oferece um conjunto de APIs de teste para encontrar elementos, verificar atributos e realizar ações do usuário. Elas também incluem recursos avançados, como manipulação de tempo. Use essas APIs para criar testes robustos que verifiquem o comportamento do app.

Importante: para saber mais sobre como testar apps Android em geral, incluindo o teste de elementos View, consulte a seção de teste geral. Um bom ponto de partida é o guia Conceitos básicos para testes de apps Android.

visualizações

Se você está trabalhando com visualizações em vez do Compose, consulte a seção geral Testar apps no Android.

Um bom ponto de partida é especificamente o guia Automatizar testes de interface. Ela descreve como automatizar os testes executados no dispositivo, inclusive ao usar visualizações.

Conceitos principais

Confira abaixo alguns conceitos importantes para testar o código do Compose.

• Semântica: os testes do Compose interagem com a interface usando semântica, que dão significado a partes da interface e são gerados com a hierarquia da interface.
• APIs de teste: o Compose oferece APIs de teste para encontrar elementos, fazer declarações sobre o estado e as propriedades deles e realizar ações para simular interações do usuário.
• Sincronização: por padrão, os testes do Compose são sincronizados automaticamente com a interface, aguardando que ela fique inativa antes de fazer declarações ou realizar ações.
• Interoperabilidade: em apps híbridos, os testes podem interagir perfeitamente com elementos do Compose e com base em visualização, além de se integrar a outros frameworks de teste.

Folha de referência de testes

Consulte a folha de referência de testes para ter uma visão geral dos principais tópicos que você precisa aprender sobre testes no Compose.

Configurar

Configure o app para testar o código do Compose.

Primeiro, adicione as seguintes dependências ao arquivo build.gradle do módulo que contém seus testes de IU:

// Test rules and transitive dependencies:
androidTestImplementation("androidx.compose.ui:ui-test-junit4:$compose_version")
// Needed for createComposeRule(), but not for createAndroidComposeRule<YourActivity>():
debugImplementation("androidx.compose.ui:ui-test-manifest:$compose_version")

Esse módulo inclui uma ComposeTestRule e uma implementação para Android chamada AndroidComposeTestRule. Com essa regra, você pode definir o conteúdo do Compose ou acessar a atividade. Crie as regras usando funções de fábrica, createComposeRule ou, se você precisar de acesso a uma atividade, createAndroidComposeRule. Um teste de interface típico do Compose tem esta aparência:

// file: app/src/androidTest/java/com/package/MyComposeTest.kt

class MyComposeTest {

    @get:Rule val composeTestRule = createComposeRule()
    // use createAndroidComposeRule<YourActivity>() if you need access to
    // an activity

    @Test
    fun myTest() {
        // Start the app
        composeTestRule.setContent {
            MyAppTheme {
                MainScreen(uiState = fakeUiState, /*...*/)
            }
        }

        composeTestRule.onNodeWithText("Continue").performClick()

        composeTestRule.onNodeWithText("Welcome").assertIsDisplayed()
    }
}

Outros recursos

• Testar apps no Android: a página de destino principal de testes do Android oferece uma visão mais ampla dos princípios básicos e das técnicas de teste.
• Conceitos básicos de testes:saiba mais sobre os principais conceitos por trás de testes de apps Android.
• Testes locais: é possível executar alguns testes localmente na sua própria estação de trabalho.
• Testes instrumentados:é uma prática recomendada executar testes instrumentados. Ou seja, testes executados diretamente no dispositivo.
• Integração contínua: a integração contínua permite integrar seus testes ao pipeline de implantação.
• Teste diferentes tamanhos de tela:com alguns dispositivos disponíveis para os usuários, teste diferentes tamanhos de tela.
• Espresso: embora seja destinado a interfaces baseadas em visualização, o conhecimento do Espresso ainda pode ser útil para alguns aspectos dos testes do Compose.

Codelab

Para saber mais, consulte o codelab sobre testes do Jetpack Compose.

Exemplos