Interopérabilité

Compose s'intègre aux frameworks de test courants.

Interopérabilité avec Espresso

Dans une application hybride, vous pouvez trouver des composants Compose dans des hiérarchies de vues et des vues dans des composables Compose (via le composable AndroidView).

Aucune étape particulière n'est requise pour correspondre à chaque type. Vous faites correspondre les vues avec onView d'Espresso et les éléments Compose avec ComposeTestRule.

@Test
fun androidViewInteropTest() {
    // Check the initial state of a TextView that depends on a Compose state.
    Espresso.onView(withText("Hello Views")).check(matches(isDisplayed()))
    // Click on the Compose button that changes the state.
    composeTestRule.onNodeWithText("Click here").performClick()
    // Check the new value.
    Espresso.onView(withText("Hello Compose")).check(matches(isDisplayed()))
}

Ajouter une sémantique à portée de vue pour les tests d'interopérabilité Compose

Limiter les recherches Compose à des vues spécifiques

Lorsque vous migrez des UI complexes vers Compose, vous pouvez rencontrer des éléments Compose identiques imbriqués dans plusieurs vues Android traditionnelles, par exemple dans un RecyclerView ou un ViewPager. Dans ces scénarios, une recherche Compose standard telle que onNodeWithText("Save") peut échouer et générer une erreur "Plusieurs nœuds trouvés".

Au lieu de modifier votre code de production pour injecter des tags de test dynamiques afin de distinguer ces éléments, vous pouvez définir la portée de votre test Compose directement sur une vue Android spécifique.

Utilisez l'API onRootWithViewInteraction sur votre règle de test. Cette fonction accepte un ViewInteraction Espresso, ce qui vous permet d'utiliser Espresso pour isoler une vue de conteneur spécifique et effectuer des interactions Compose exclusivement dans cette hiérarchie délimitée.

Interagir avec un élément de liste

Si vous devez interagir avec un élément Compose à l'intérieur d'une ligne RecyclerView spécifique, utilisez Espresso pour localiser la ligne, puis limitez votre interaction Compose à celle-ci. Les éléments Compose identiques dans toutes les autres lignes sont ignorés.

@Test
fun testComposeButtonInsideRecyclerViewItem() = runComposeUiTest {
    // Scroll to the desired position using Espresso
    Espresso.onView(withId(recyclerViewId))
        .perform(RecyclerViewActions.scrollToPosition<MyViewHolder>(3))

    // Define an Espresso ViewInteraction that uniquely identifies the row
    val rowView = Espresso.onView(
        allOf(
            withId(rootViewId),
            hasDescendant(withText("Item #3"))
        )
    )

    // Scope the Compose search strictly to that specific row View
    onRootWithViewInteraction(rowView)
        .onNode(hasText("Like"))
        .performClick()
}
TestSnippets.kt

Résoudre l'ambiguïté dans les ViewPager

Lorsque plusieurs fragments avec des mises en page Compose identiques sont en mémoire simultanément, vous pouvez limiter la recherche à l'ID de vue racine du fragment spécifique pour éviter toute ambiguïté de correspondance.

@Test
fun testComposeButtonInsideViewPagerItem() = runComposeUiTest {
    // Swipe to the desired page using Espresso
    Espresso.onView(withId(viewPagerViewId)).perform(swipeLeft())

    // Identify the specific container view using Espresso
    val fragmentB = Espresso.onView(withId(fragmentRootViewId))

    // The generic text "Save" is now unique within this view scope
    onRootWithViewInteraction(fragmentB)
        .onNode(hasText("Save"))
        .assertIsDisplayed()
}
TestSnippets.kt

Interopérabilité avec UiAutomator

Par défaut, les composables ne sont accessibles depuis UiAutomator que par leurs descripteurs pratiques (texte affiché, description du contenu, etc.). Si vous souhaitez accéder à un composable qui utilise Modifier.testTag, vous devez activer la propriété sémantique testTagsAsResourceId pour la sous-arborescence du composable en question. Ce comportement est utile pour les composables qui ne possèdent pas d'autre identifiant unique, comme les composables à faire défiler (par exemple, LazyColumn).

Activez la propriété sémantique une seule fois au sommet de la hiérarchie de vos composables afin de vous assurer que tous les composables imbriqués avec Modifier.testTag sont accessibles depuis UiAutomator.

Scaffold(
    // Enables for all composables in the hierarchy.
    modifier = Modifier.semantics {
        testTagsAsResourceId = true
    }
){
    // Modifier.testTag is accessible from UiAutomator for composables nested here.
    LazyColumn(
        modifier = Modifier.testTag("myLazyColumn")
    ){
        // Content
    }
}

Tout composable avec Modifier.testTag(tag) est accessible à l'aide de By.res(resourceName) avec le même tag que resourceName.

val device = UiDevice.getInstance(getInstrumentation())

val lazyColumn: UiObject2 = device.findObject(By.res("myLazyColumn"))
// Some interaction with the lazyColumn.

Autres ressources

• Tester des applications sur Android : la page de destination principale des tests Android offre une vue plus large des principes de base et des techniques de test.
• Principes de base des tests : découvrez les concepts fondamentaux des tests d'applications Android.
• Tests locaux : vous pouvez exécuter certains tests localement, sur votre propre station de travail.
• Tests instrumentés : il est recommandé d'exécuter également des tests instrumentés. Autrement dit, les tests qui s'exécutent directement sur l'appareil.
• Intégration continue : l'intégration continue vous permet d'intégrer vos tests à votre pipeline de déploiement.
• Testez différentes tailles d'écran : les utilisateurs ont accès à de nombreux appareils. Vous devez donc tester différentes tailles d'écran.
• Espresso : bien qu'il soit destiné aux UI basées sur les vues, la connaissance d'Espresso peut toujours être utile pour certains aspects des tests Compose.