Google is committed to advancing racial equity for Black communities. See how.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Prendre des captures d'écran dans les tests d'instrumentation

Firebase Test Lab comprend une bibliothèque que vous pouvez utiliser pour prendre des captures d'écran lors de l'exécution de tests d'instrumentation, tels que des tests écrits à l'aide du framework de test Espresso . Pour ajouter cette fonctionnalité à votre test, téléchargez la bibliothèque cloudtestingscreenshotter_lib.aar .

La possibilité de prendre des captures d'écran est déjà intégrée à l'APK de test, app-debug-test-unaligned.apk , pour l'exemple d'application NotePad, et des captures d'écran sont également capturées lorsque vous exécutez le test Robo . Les instructions suivantes vous indiquent comment ajouter la bibliothèque de captures d'écran à votre application et comment appeler cette bibliothèque à partir de votre test.

Une fois votre test exécuté, vous pouvez consulter les captures d'écran dans Android Studio ou dans la console Firebase.

Ajoutez la bibliothèque de captures d'écran à votre projet

  1. Dans Android Studio, ouvrez la vue Projet et cliquez avec le bouton droit sur le nom de votre projet. Ensuite, cliquez sur Nouveau > Répertoire .

  2. Dans la boîte de dialogue Nouveau répertoire , saisissez aars . Cela crée un répertoire aars à la racine de votre projet de test (en tant que répertoire homologue dans le dossier de l' application ).

  3. Copiez cloudtestingscreenshotter_lib.aar et collez-le dans le dossier aars .

  4. Dans le fichier build.gradle niveau racine (au niveau du projet) de votre application, ajoutez une référence au dossier aars dans chaque bloc de repositories :

    repositories {
        jcenter()
        flatDir {
            dirs '../aars'
        }
    }
    ...
  5. Dans le répertoire de niveau supérieur de votre module (pour l'exemple d'application build.gradle , il s'agit du répertoire de l' application ), ouvrez le fichier build.gradle et ajoutez une dépendance à cloudtestingscreenshotter_lib.aar au bloc de dependencies niveau supérieur:

    dependencies {
        // Cloud testing
        androidTestCompile (name:'cloudtestingscreenshotter_lib', ext:'aar')
        // Other dependencies go here
        }
    
  6. Dans votre fichier AndroidManifest.xml , spécifiez les autorisations système pour votre application en ajoutant les lignes suivantes dans la <manifest> . Si vous testez sur Android 10 (niveau d'API 29) ou supérieur , omettez l'autorisation WRITE_EXTERNAL_STORAGE (votre application n'a pas besoin de cette autorisation pour lire et écrire des captures d'écran sur l'appareil).

    <manifest ... >
       <!-- WRITE_EXTERNAL_STORAGE is not needed on Android 10 (API level 29) or higher. -->
       <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
       <uses-permission android:name="android.permission.INTERNET"/>
       ...
    </manifest>
    

Prenez une capture d'écran de votre test

A tout moment dans votre test où vous voulez prendre une capture d' écran, appelez la ScreenShotter.takeScreenshot méthode de la bibliothèque cloudtestingscreenshotter_lib, où le premier argument est une étiquette que vous utilisez pour identifier la capture d' écran ( main_screen_2 est utilisé dans l'exemple suivant):

Java

ScreenShotter.takeScreenshot("main_screen_2", this /* activity */);

Kotlin + KTX

ScreenShotter.takeScreenshot("main_screen_2", this /* activity */)

Voir les captures d'écran

Une fois votre test terminé, vous pouvez comparer les captures d'écran prises pendant le test en sélectionnant un élément dans l'arborescence des résultats du test, puis en cliquant sur Afficher les captures d'écran Afficher les captures d'écran option.

Screenshot comparison screen

Vous pouvez sélectionner et comparer des captures d'écran de différentes configurations comme suit:

Tâche action
Basculez entre les exécutions de test. Utilisez le menu déroulant dans le coin supérieur gauche.

menu de cas de test
Basculez entre les captures d'écran au cours d'une exécution de test. Utilisez les flèches dans le coin supérieur droit.

sélecteur de capture d'écran
Ajoutez des panneaux de comparaison de captures d'écran supplémentaires à la vue actuelle. Cliquez sur Comparer .

Comparer
Choisissez une dimension de test différente (type d'appareil, orientation, paramètres régionaux, etc.). Sélectionnez un nouveau membre de dimension dans la liste au bas de la capture d'écran.

L'étape suivante

Téléchargez l'exemple d'application NotePad .