Mit der Espresso Device API auf Änderungen der Bildschirmkonfiguration testen

Verwenden Sie die Espresso Device API, um Ihre App zu testen, wenn das Gerät häufige Konfigurationsänderungen durchläuft, z. B. Drehung und Entfalten des Displays. Mit der Espresso Device API können Sie diese Konfigurationsänderungen auf einem virtuellen Gerät simulieren und Ihre Tests synchron ausführen. So wird immer nur eine UI-Aktion oder -Bestätigung ausgeführt und Ihre Testergebnisse sind zuverlässiger. Wenn Sie noch keine Erfahrung mit dem Schreiben von UI-Tests mit Espresso haben, lesen Sie die Dokumentation.

Für die Verwendung der Espresso Device API benötigen Sie Folgendes:

• Android Studio Iguana oder höher
• Android Gradle-Plug-in 8.3 oder höher
• Android-Emulator 33.1.10 oder höher
• Ein virtuelles Android-Gerät mit API-Level 24 oder höher

Projekt für die Espresso Device API einrichten

So richten Sie Ihr Projekt so ein, dass es die Espresso Device API unterstützt:

1. Damit die Testbefehle auf dem Testgerät übergeben werden, musst du der Manifestdatei im androidTest-Quellsatz die Berechtigungen INTERNET und ACCESS_NETWORK_STATE hinzufügen:

     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permissions.ACCESS_NETWORK_STATE" />
     

2. Aktivieren Sie das experimentelle Flag enableEmulatorControl in der Datei gradle.properties:

     android.experimental.androidTest.enableEmulatorControl=true
     

3. Aktivieren Sie die Option emulatorControl im Build-Skript auf Modulebene:

   Kotlin

     testOptions {
       emulatorControl {
         enable = true
       }
     }
     

   Groovy

     testOptions {
       emulatorControl {
         enable = true
       }
     }
     

4. Importieren Sie im Build-Skript auf Modulebene die Espresso Device Library in Ihr Projekt:

   Kotlin

     dependencies {
       androidTestImplementation("androidx.test.espresso:espresso-device:1.0.1")
     }
     

   Cool

     dependencies {
       androidTestImplementation 'androidx.test.espresso:espresso-device:1.0.1'
     }
     

Häufige Konfigurationsänderungen testen

Die Espresso Device API bietet mehrere Bildschirmausrichtungen und Zustände für faltbare Geräte, mit denen Sie Änderungen an der Gerätekonfiguration simulieren können.

Test auf Bildschirmdrehung

Hier ein Beispiel dafür, wie Sie testen, was mit Ihrer App passiert, wenn sich das Display des Geräts dreht:

1. Stellen Sie zuerst den Modus des Geräts auf Hochformat ein, damit es immer im selben Startstatus ist:

     import androidx.test.espresso.device.action.ScreenOrientation
     import androidx.test.espresso.device.rules.ScreenOrientationRule
     ...
     @get:Rule
     val screenOrientationRule: ScreenOrientationRule = ScreenOrientationRule(ScreenOrientation.PORTRAIT)
     

2. Erstellen Sie einen Test, bei dem das Gerät während der Testausführung ins Querformat wechselt:

     @Test
     fun myRotationTest() {
       ...
       // Sets the device to landscape orientation during test execution.
       onDevice().setScreenOrientation(ScreenOrientation.LANDSCAPE)
       ...
     }
     

3. Prüfen Sie nach der Bildschirmdrehung, ob sich die Benutzeroberfläche wie erwartet an das neue Layout anpasst.

     @Test
     fun myRotationTest() {
       ...
       // Sets the device to landscape orientation during test execution.
       onDevice().setScreenOrientation(ScreenOrientation.LANDSCAPE)
       composeTestRule.onNodeWithTag("NavRail").assertIsDisplayed()
       composeTestRule.onNodeWithTag("BottomBar").assertDoesNotExist()
     }
     

Test auf Displayentfaltung

Hier ist ein Beispiel dafür, wie Sie testen können, was mit Ihrer App passiert, wenn sie auf einem faltbaren Gerät ausgeführt wird und das Display aufgeklappt wird:

1. Teste zuerst, ob das Gerät zugeklappt ist. Dazu rufst du onDevice().setClosedMode() auf. Achte darauf, dass sich das Layout deiner App an die kompakte Bildschirmbreite anpasst.

     @Test
     fun myUnfoldedTest() {
       onDevice().setClosedMode()
       composeTestRule.onNodeWithTag("BottomBar").assetIsDisplayed()
       composeTestRule.onNodeWithTag("NavRail").assetDoesNotExist()
       ...
     }
     

2. Wenn Sie das Gerät vollständig aufklappen möchten, drücken Sie onDevice().setFlatMode(). Prüfen Sie, ob sich das Layout der App an die erweiterte Größenklasse anpasst.

     @Test
     fun myUnfoldedTest() {
       onDevice().setClosedMode()
       ...
       onDevice().setFlatMode()
       composeTestRule.onNodeWithTag("NavRail").assertIsDisplayed()
       composeTestRule.onNodeWithTag("BottomBar").assetDoesNotExist()
     }
     

Angeben, welche Geräte für Ihre Tests erforderlich sind

Wenn Sie einen Test durchführen, bei dem Faltaktionen auf einem Gerät ausgeführt werden, das nicht faltbar ist, schlägt der Test wahrscheinlich fehl. Wenn Sie nur die Tests ausführen möchten, die für das laufende Gerät relevant sind, verwenden Sie die Anmerkung @RequiresDeviceMode. Der Test-Runner überspringt automatisch die Ausführung von Tests auf Geräten, die die getestete Konfiguration nicht unterstützen. Sie können die Geräteanforderungsregel jedem Test oder einer gesamten Testklasse hinzufügen.

Wenn Sie beispielsweise angeben möchten, dass ein Test nur auf Geräten ausgeführt werden soll, die das Entfalten in eine flache Konfiguration unterstützen, fügen Sie dem Test den folgenden @RequiresDeviceMode-Code hinzu:

@Test
@RequiresDeviceMode(mode = FLAT)
fun myUnfoldedTest() {
  ...
}