Se usó la API de Cloud Translation para traducir esta página.

Cómo probar tu diseño de Compose

Prueba la IU de tu app para verificar que el comportamiento del código de Compose sea correcto. Esto te permite detectar errores con anticipación y mejorar la calidad de la app.

Compose proporciona un conjunto de APIs de prueba para encontrar elementos, verificar sus atributos y realizar acciones del usuario. Las APIs también incluyen funciones avanzadas, como la manipulación del tiempo. Usa estas APIs para crear pruebas sólidas que verifiquen el comportamiento de la app.

promedio

Si trabajas con vistas en lugar de Compose, consulta la sección general Cómo probar apps en Android.

En particular, un buen punto de partida es la guía Cómo automatizar pruebas de IU. Se explica cómo puedes automatizar las pruebas que se ejecutan en el dispositivo, incluso cuando se usan vistas.

Conceptos clave

Los siguientes son algunos conceptos clave para probar tu código de Compose.

Semántica: Las pruebas de Compose interactúan con la IU mediante semánticas, que dan significado a las partes de la IU y se generan junto con la jerarquía de la IU.
APIs de prueba: Compose proporciona APIs de prueba para encontrar elementos, realizar aserciones sobre su estado y sus propiedades, y realizar acciones para simular interacciones del usuario.
Sincronización: De forma predeterminada, las pruebas de Compose se sincronizan automáticamente con la IU y esperan a que esté inactiva antes de realizar aserciones o realizar acciones.
Interoperabilidad: En las apps híbridas, las pruebas pueden interactuar sin problemas con elementos basados en Compose y View, además de integrarse a otros frameworks de prueba.

Pruebas de hoja de referencia

Consulta la hoja de referencia para pruebas a fin de obtener una descripción general de todos los temas clave que debes aprender sobre las pruebas en Compose.

Configuración

Configura tu app para que puedas probar el código de Compose.

Primero, agrega las siguientes dependencias al archivo build.gradle del módulo que contiene las pruebas de tu 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")

En este módulo, se incluye un ComposeTestRule y una implementación para Android llamada AndroidComposeTestRule. Mediante esta regla, puedes configurar el contenido de Compose o acceder a la actividad. Puedes crear las reglas con funciones de fábrica, ya sea createComposeRule o, si necesitas acceder a una actividad, createAndroidComposeRule. Una prueba típica de IU para Compose se ve de la siguiente manera:

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

Recursos adicionales

Cómo probar apps en Android: La página de destino principal de pruebas de Android proporciona una vista más amplia de los conceptos básicos y las técnicas de prueba.
Aspectos básicos de las pruebas: Obtén más información sobre los conceptos básicos de las pruebas de apps para Android.
Pruebas locales: Puedes ejecutar algunas pruebas de forma local en tu propia estación de trabajo.
Pruebas instrumentadas: se recomienda ejecutar también pruebas de instrumentación. Es decir, pruebas que se ejecutan directamente en el dispositivo.
Integración continua: La integración continua te permite integrar tus pruebas en la canalización de implementación.
Prueba diferentes tamaños de pantalla: Con algunos dispositivos disponibles para los usuarios, debes probar diferentes tamaños de pantalla.
Espresso: Si bien está diseñado para las IU basadas en View, el conocimiento de Espresso puede ser útil para algunos aspectos de las pruebas de Compose.