Tests unitaires avec Glance

L'API de test unitaire Glance vous permet de tester votre code Glance sans gonfler les vues ni avoir besoin d'un outil d'automatisation de l'UI. Par exemple, l'API de test unitaire vous permet de vérifier des conditions, telles que si des éléments figurent dans une liste ou si des cases ont été cochées, à l'aide d'outils de mise en correspondance tels que hasContentDescriptionEqualTo ou isChecked.

Cette API est légère et nécessite moins de configuration. Vous pouvez donc effectuer un développement piloté par les tests à mesure que vous développez des éléments individuels de votre widget et que vous les organisez pour améliorer la réutilisation du code.

Configurer

Les dépendances requises pour utiliser la bibliothèque de tests unitaires sont présentées dans les exemples suivants:

// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.0'
testImplementation 'androidx.glance:glance-AppWidget-testing:1.1.0'
testImplementation 'org.robolectric:robolectric:4.11.1'
...
// You may include additional dependencies, such as Robolectric, if your test
// needs to set a LocalContext.

Structure du test

Organisez les fonctions composables en dehors de la classe GlanceAppWidget pour permettre la réutilisation du code et les tests unitaires. Réduisez autant que possible la complexité des unités testées.

class MyGlanceComposableTest {
    @Test
    fun myNewsItemComposable_largeSize_hasAuthorAsSubtitle() = runGlanceAppWidgetUnitTest {
        // Prepare inputs and state
        setAppWidgetSize(100.dp, 100.dp)

        // Set the composable under test
        provideComposable {
            MyNewsItemComposable(TEST_NEWS_ITEM)
        }

        // Perform assertions
        onNode(hasTestTag("subTitle"))
            .assertHasText(TEST_NEWS_ITEM.authorName)
    }
}

Définir le contexte et la taille du test

Si votre fonction composable lit le contexte à l'aide de la méthode LocalContext.current(), vous devez définir un contexte à l'aide de la méthode LocalContext.current(). Sinon, cette étape est facultative.

Vous pouvez utiliser n'importe quel framework de tests unitaires Android basé sur JVM, tel que Roboletric, pour fournir le contexte.

Si votre fonction composable accède à LocalSize, définissez la taille souhaitée pour le test avant de fournir un composable dans le test. La taille par défaut est de 349 dp x 455 dp, ce qui équivaut à un widget 5 x 4 affiché sur un appareil Pixel 4 en mode Portrait.

• Si votre AppWidget utilise sizeMode == Single, vous pouvez le définir sur minWidth et minHeight dans le fichier info.xml de votre widget.
• Si votre AppWidget utilise sizeMode == Exact, vous pouvez identifier les tailles à tester de la même manière que vous déterminez une taille pour votre widget et identifiez les tailles paysage et portrait sur lesquelles votre widget peut s'afficher et les tester.
• Si votre AppWidget utilise sizeMode == Responsive, vous pouvez le définir sur l'une des tailles de la liste que vous fournissez lorsque vous spécifiez sizeMode.

La durée par défaut d'un délai avant expiration de test est d'une seconde, mais vous pouvez transmettre une durée personnalisée en tant qu'argument à la méthode runGlanceAppWidgetUnitTest si votre infrastructure de test applique un délai d'expiration différent.

Pour en savoir plus et obtenir des exemples de code, consultez la documentation de référence sur runGlanceAppWidgetUnitTest.