Testare il layout di Compose

Testa l'UI della tua app per verificare che il comportamento del codice Compose sia corretto. In questo modo, puoi rilevare gli errori in anticipo e migliorare la qualità della tua app.

Compose fornisce un insieme di API di test per trovare gli elementi, verificarne gli attributi ed eseguire le azioni dell'utente. Le API includono anche funzionalità avanzate come la manipolazione del tempo. Utilizza queste API per creare test solidi che verifichino il comportamento della tua app.

Visualizzazioni

Se utilizzi le visualizzazioni anziché Compose, consulta la sezione generale Testare le app su Android.

In particolare, un buon punto di partenza è la guida Automatizzare i test dell'UI. Descrive come automatizzare i test eseguiti sul dispositivo, anche quando si utilizzano le visualizzazioni.

Concetti principali

Di seguito sono riportati alcuni concetti chiave per testare il codice Compose:

• Semantica: la semantica dà significato all'UI, consentendo ai test di interagire con elementi specifici.
• API di test: le API di test consentono di trovare gli elementi, verificarne gli attributi ed eseguire le azioni dell'utente.
• Sincronizzazione: la sincronizzazione verifica che i test attendano che la UI sia inattiva prima di eseguire azioni o fare asserzioni.
• Interoperabilità: l'interoperabilità consente ai test di funzionare sia con gli elementi basati su Compose sia con quelli basati su View nella stessa app.

Foglio riassuntivo dei test

Consulta il foglio riassuntivo dei test per una panoramica di tutti gli argomenti chiave che devi conoscere sui test in Compose.

Configurazione

Configura l'app per poter testare il codice Compose.

Innanzitutto, aggiungi le seguenti dipendenze al file build.gradle del modulo contenente i test dell'UI:

// 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")

Questo modulo include un ComposeTestRule e un'implementazione per Android chiamata AndroidComposeTestRule. Tramite questa regola puoi impostare i contenuti di Compose o accedere all'attività. Le regole vengono create utilizzando le funzioni di fabbrica, createComposeRule o, se devi accedere a un'attività, createAndroidComposeRule. Un tipico test dell'UI per Compose è il seguente:

// 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()
    }
}

Risorse aggiuntive

• Testare le app su Android: la pagina di destinazione principale dei test di Android fornisce una visione più ampia dei principi e delle tecniche di test.
• Nozioni di base sui test: scopri di più sui concetti fondamentali alla base dei test di un'app per Android.
• Test locali: puoi eseguire alcuni test localmente, sulla tua workstation.
• Test strumentati: è buona norma eseguire anche test strumentati. Ovvero test eseguiti direttamente sul dispositivo.
• Integrazione continua: L'integrazione continua consente di integrare i test nella pipeline di deployment.
• Testare diverse dimensioni dello schermo: Con così tanti dispositivi a disposizione degli utenti, devi eseguire test per diverse dimensioni dello schermo.
• Espresso: sebbene sia destinato alle UI basate su View, la conoscenza di Espresso può comunque essere utile per alcuni aspetti dei test di Compose.

Codelab

Per saperne di più, prova il codelab Test di Jetpack Compose.

Esempi