Uiautomator testen

  
Framework für funktionsübergreifende UI-Tests für Apps
Letzte Aktualisierung Stabile Version Releasekandidat Betarelease Alpha-Release
3. Dezember 2025 2.3.0 - - 2.4.0-alpha07

Abhängigkeiten deklarieren

Für eine Abhängigkeit von „test“ müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

Groovy

dependencies {
    // Use to implement UIAutomator tests
    androidTestImplementation "androidx.test.uiautomator:uiautomator:2.4.0-alpha07"
}

Kotlin

dependencies {
    // Use to implement UIAutomator tests
    androidTestImplementation("androidx.test.uiautomator:uiautomator:2.4.0-alpha07")
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Lassen Sie es uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können für ein vorhandenes Problem stimmen, indem Sie auf den Button mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Testen der Uiautomator-Shell Version 1.0

Version 1.0.0-alpha03

3. Dezember 2025

androidx.test.uiautomator:uiautomator-shell:1.0.0-alpha03 ist veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

Version 1.0.0-alpha02

13. August 2025

androidx.test.uiautomator:uiautomator-shell:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Version 1.0.0-alpha01

18. Juni 2025

androidx.test.uiautomator:uiautomator-shell:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Erste Alphaversion der ui-automator-Shell-Bibliothek zum Ausführen von Shell-Befehlen als Shell-Nutzer. Mit dieser Bibliothek können Sie stdout und stderr lesen und in stdin eines Shell-Prozesses schreiben, der von Shell gestartet wurde. De facto wird UiAutomation#executeShellCommandRwe, das in API 34 eingeführt wurde, zurückportiert.

Version 2.4

Version 2.4.0-alpha07

3. Dezember 2025

androidx.test.uiautomator:uiautomator:2.4.0-alpha07 ist veröffentlicht. Version 2.4.0-alpha07 enthält diese Commits.

API-Änderungen

  • „Changed startActivity wait to wait for new window.“ (startActivity wurde in „wait for new window“ geändert.) Dadurch wird der Start in der Regel synchronisiert und zukünftige Versionen von Macrobenchmark können die Erkennung des Startabschlusses konfigurieren. (I35da6, Id6e6f, b/440021797)
  • Die API ohne expliziten Paketnamen in UiAutomatorTestScope wurde entfernt. (I8c285, b/413417205)

Version 2.4.0-alpha06

13. August 2025

androidx.test.uiautomator:uiautomator:2.4.0-alpha06 ist veröffentlicht. Version 2.4.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Es wurden fensterbasierte APIs für verbesserte Tests mit mehreren Fenstern hinzugefügt. UiDevice#findWindow kann jetzt verwendet werden, um ein bestimmtes UiWindow anhand eines ByWindowSelector zu finden, das mit By.Window-Factory-Methoden erstellt wurde. (I359c4, I40528, I8c963)

Version 2.4.0-alpha05

18. Juni 2025

androidx.test.uiautomator:uiautomator:2.4.0-alpha05 ist veröffentlicht. Version 2.4.0-alpha05 enthält diese Commits.

API-Änderungen

  • UiObject2#waitForStable wurde als Tastenkürzel für UiObject2#accessibilityNodeInfo#waitForStable() hinzugefügt

Version 2.4.0-alpha04

4. Juni 2025

androidx.test.uiautomator:uiautomator:2.4.0-alpha04 ist veröffentlicht. Version 2.4.0-alpha04 enthält diese Commits.

API-Änderungen

  • onView wurde in onElement umbenannt, um zu verdeutlichen, dass es mit Compose funktioniert (I53a3b, b/419006806)

Fehlerkorrekturen

Version 2.4.0-alpha03

20. Mai 2025

androidx.test.uiautomator:uiautomator:2.4.0-alpha03 ist veröffentlicht. Version 2.4.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das waitForStableInActiveWindow in einigen Fällen eine NPE ausgelöst hat. (Ibf50f, b/417046391)

Version 2.4.0-alpha02

7. Mai 2025

androidx.test.uiautomator:uiautomator:2.4.0-alpha02 ist veröffentlicht. Version 2.4.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Erste Version der neuen Uiautomator API. UiAutomatorTestScope kann über die Factory uiAutomator erstellt werden, die Zugriff auf die neuen onView-APIs bietet.
  • Erste Lint-Regeln, um vor der Verwendung von AccessibilityNodeInfo#getText zu warnen und die Verwendung von textAsString vorzuschlagen.

API-Änderungen

  • Configurator#setDefaultDisplayId wurde hinzugefügt, um eine Display-ID festzulegen, auf die alle Suchanfragen beschränkt werden sollen (Icdf17).
  • Searchable (Schnittstelle, die von UiDevice und UiObject2 gemeinsam genutzt wird) wurde aus Gründen der Benutzerfreundlichkeit in „public“ geändert (I67f18).

Fehlerkorrekturen

  • Die Verarbeitung von Meta-Tasten in UiDevice#pressKeyCodes wurde korrigiert. (I73f80).
  • UiDevice#getWindowRoots wurde aktualisiert, um immer Ablagen in Z-Reihenfolge zurückzugeben (I87426).
  • Ein Problem wurde behoben, bei dem bestimmte Gesten unvollständig waren (I60dd3, If4edd).
  • Ein seltener Fall einer Endlosschleife beim Aufrufen von UiDevice#scrollUntil wurde behoben (I39989).

Version 2.4.0-alpha01

26. Juni 2024

androidx.test.uiautomator:uiautomator:2.4.0-alpha01 ist veröffentlicht. Version 2.4.0-alpha01 enthält diese Commits.

API-Änderungen

  • Die Parameter Configurator#getKeyInjectionDelay und setKeyInjectionDelay sind veraltet, da sie nicht mehr verwendet werden. Text wird jetzt immer direkt eingefügt und nicht mehr über Tastendrücke. (I3bcc5).

Fehlerkorrekturen

  • Die Verzögerung zwischen UiObject2-Bewegungsereignissen wurde aktualisiert, um dynamische Aktualisierungsraten (z.B. Smooth Display) zu berücksichtigen (I43f12).
  • Die Instabilität aufgrund veralteter Bedienungshilfenknoten in bestimmten Benutzeroberflächen wurde reduziert, indem der Bedienungshilfencache regelmäßig ungültig gemacht wird (I3be25).
  • Es wurde ein Problem behoben, bei dem StaleObjectException auftraten, wenn toString oder hashCode für ein altes UiObject2 aufgerufen wurde. (I38ea1).
  • Die Leistung von UiWatcher wurde verbessert, indem unnötige waitForIdle-Aufrufe übersprungen werden. (I8c65e).
  • Fehler im Javadoc behoben, insbesondere um zu verdeutlichen, wann die einzelnen Configurator-Parameter verwendet werden. (Ie10b1, I71631)

Version 2.3.0

Version 2.3.0

21. Februar 2024

androidx.test.uiautomator:uiautomator:2.3.0 ist veröffentlicht. Version 2.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 2.2.0

  • Unterstützung für mehrere Displays: Es wurde Unterstützung für das Suchen und Bearbeiten von Objekten auf mehreren Displays sowie UiDevice-Methoden zum Verwalten sekundärer Displays hinzugefügt (Ie6544, I912cd).
  • Neue Selektoren:
    • By.displayId wurde hinzugefügt, um Objekte anhand ihrer Anzeige-ID (I1825b) auszuwählen.
    • Die Funktionen By.hasParent und By.hasAncestor wurden hinzugefügt, um Objekte anhand ihrer übergeordneten Elemente auszuwählen (I93c36).
    • Es wurden By.hint-Methoden hinzugefügt, mit denen Objekte anhand ihres Hinweistextes ausgewählt werden können (Idd345).
  • Benutzerdefinierte Bedingungen: Eine Condition-Schnittstelle zur Unterstützung benutzerdefinierter Wartebedingungen wurde eingeführt und entsprechende UiDevice#wait-, UiObject2#wait- und UiObject2#scrollUntil-Methoden wurden hinzugefügt (27c0ea, 099d6e).
  • Fehlerkorrekturen und Zuverlässigkeit
    • Ein Problem wurde behoben, durch das die Berechnungen der Displaygröße gelegentlich falsch waren und möglicherweise Teile des Bildschirms ignoriert wurden (Ifc016). Koordinaten und Offsets, die in Tests verwendet werden, müssen möglicherweise angepasst werden.
    • Die MotionEvent-Einfügung wurde aktualisiert, um die Genauigkeit zu verbessern (678ca3) und Nutzergesten besser zu emulieren (454450).
    • Die Zuverlässigkeit von Scrollen (I7b059), Drehen (c6cea0), langen Klicks (49572b) und Zupfen (3c619a) wurde verbessert.

Version 2.3.0-rc01

7. Februar 2024

androidx.test.uiautomator:uiautomator:2.3.0-rc01 wird ohne Änderungen veröffentlicht. Version 2.3.0-rc01 enthält diese Commits.

Version 2.3.0-beta01

13. Dezember 2023

androidx.test.uiautomator:uiautomator:2.3.0-beta01 ist veröffentlicht. Version 2.3.0-beta01 enthält diese Commits.

API-Änderungen

  • Die prozentualen Margenmethoden UiObject2 wurden aus Konsistenzgründen in setGestureMarginPercentage und setGestureMarginsPercentage umbenannt (I24435).

Fehlerkorrekturen

  • Der Fehler, der ausgegeben wird, wenn ein sekundäres Display nicht gefunden wird oder nicht darauf zugegriffen werden kann (116b23), wurde verbessert.

Version 2.3.0-alpha05

1. November 2023

androidx.test.uiautomator:uiautomator:2.3.0-alpha05 ist veröffentlicht. Version 2.3.0-alpha05 enthält diese Commits.

API-Änderungen

  • UiObject2#getDrawingOrder wurde hinzugefügt, um Informationen zur Zeichenreihenfolge (Z-Index) verfügbar zu machen. (I5dfa4).
  • Es wurden UiDevice-Methoden zum Abrufen, Festlegen, Einfrieren und Aufheben des Einfrierens der Drehung sekundärer Displays hinzugefügt. (I912cd).

Fehlerkorrekturen

  • Wiederholungsversuch für UiObject2#scrollUntil hinzugefügt, wenn das Ende des Scrollens nicht erkannt werden konnte (Ibac6f).
  • Ein Problem wurde behoben, bei dem UiDevice eine alte Instrumentation-Instanz verwendet hat, wenn sie neu erstellt wurde (I18cae).
  • Mögliche NullPointerException behoben, wenn die Display-ID beim Ausgeben von Knoten nicht ermittelt werden kann (Icafcb).
  • Es wurde eine Warnung hinzugefügt, wenn auf nicht klickbare/scrollbare Objekte geklickt oder gescrollt wird (I4a5d9).
  • Die standardmäßige UiObject2-Scrollgeschwindigkeit wurde reduziert, um die Zuverlässigkeit zu verbessern (I5e071).

Version 2.3.0-alpha04

26. Juli 2023

androidx.test.uiautomator:uiautomator:2.3.0-alpha04 ist veröffentlicht. Version 2.3.0-alpha04 enthält diese Commits.

API-Änderungen

  • By.hasParent und By.hasAncestor wurden hinzugefügt, um das Suchen von Objekten anhand ihrer übergeordneten Elemente zu unterstützen (I93c36).
  • UiObject2#getHint wurde hinzugefügt, um den Hinweistext eines Objekts abzurufen, und By.hint-Methoden, um Objekte anhand ihres Hinweistexts auszuwählen (Idd345).
  • By.displayId wurde hinzugefügt, um die Auswahl von Objekten entsprechend dem Display zu unterstützen, auf dem sie sich befinden (I1825b).
  • Die Methoden UiDevice#getDisplayHeight(int) und UiDevice#getDisplayWidth(int) wurden hinzugefügt, um die Abmessungen eines Displays anhand seiner ID (Ie6544) zu ermitteln.
  • Die Methoden wait(SearchCondition, long) und wait(UiObject2Condition, long) wurden zur Abwärtskompatibilität wieder hinzugefügt (Iebfda).
  • UiDevice#executeShellCommand wurde auf „öffentlich, aber nicht empfohlen“ anstatt auf „ausgeblendet“ geändert (Ic48a1).

Fehlerkorrekturen

  • Die MotionEvent-Injektion wurde aktualisiert, um die Instabilität zu verringern. Dabei wird die Genauigkeit von Gesten gegenüber der Geschwindigkeit priorisiert (678ca3).
  • Tracing für ressourcenintensive Methoden hinzugefügt, um Leistungsengpässe zu erkennen (d17de3).
  • Es wurde ein Wiederholungsmechanismus beim Initiieren einer UiAutomation-Verbindung hinzugefügt (048caf).
  • Ein möglicher NPE-Fehler durch Nullknoten in UiDevice#dumpWindowHierarchy wurde behoben (b725eb).
  • Es wurden unerwartete Fehler beim Abfragen oder Bearbeiten privater Displays behoben (985db6, 7053d4).

Version 2.3.0-alpha03

19. April 2023

androidx.test.uiautomator:uiautomator:2.3.0-alpha03 ist veröffentlicht. Version 2.3.0-alpha03 enthält diese Commits.

API-Änderungen

  • Eine Condition-Schnittstelle wurde bereitgestellt, um benutzerdefinierte Wartebedingungen zu ermöglichen, anstatt sich nur auf die integrierten Funktionen in Until zu verlassen. Die Methoden UiDevice#wait und UiObject2#wait wurden aktualisiert, um diese Schnittstelle zu akzeptieren (27c0ea).
  • UiObject2#scrollUntil wurde hinzugefügt, um das Scrollen bis zum Erfüllen einer Bedingung zu unterstützen und Parität mit UiScrollable zu erreichen (099d6e).
  • UiDevice#setOrientationPortrait und setOrientationLandscape wurden hinzugefügt, um Rotationen über verschiedene Gerätetypen hinweg zu ermöglichen (e13cb7).
  • UiObject2#setGestureMarginPercent wurde hinzugefügt, um das Festlegen von Rändern relativ zur Objektgröße zu unterstützen. (Ib8c77)

Fehlerkorrekturen

  • Die UiScrollable-Methoden haben gelegentlich ungültige Koordinaten für SDKs 18 bis 22 verwendet (b53ece).
  • Es wurde ein Problem behoben, bei dem mit UiObject2#setText und clearText kein Text in SDKs 18 und 19 geändert werden konnte (77e41d).
  • Es wurde ein Fehler behoben, durch den UiWatcher nicht in der richtigen Reihenfolge ausgeführt wurden (c85f92).
  • Ein Problem wurde behoben, durch das die Geräteausrichtung nach einer Änderung der UiDevice-Ausrichtung (c6cea0) möglicherweise noch nicht abgeschlossen war.
  • Die Zuverlässigkeit von Langklicks, Ziehen und Auf- und Zuziehen wurde verbessert (49572b, 3c619a).

Version 2.3.0-alpha02

11. Januar 2023

androidx.test.uiautomator:uiautomator:2.3.0-alpha02 ist veröffentlicht. Version 2.3.0-alpha02 enthält diese Commits.

API-Änderungen

  • Die Protokollierung in der gesamten Bibliothek wurde überarbeitet, um mehr Informationen bereitzustellen, vor möglichen Problemen zu warnen und die Konsistenz zu verbessern.
  • UiDevice#pressKeyCodes wurde hinzugefügt, um das gleichzeitige Drücken mehrerer Tasten zu unterstützen, z.B. das Drücken von POWER und VOLUME_DOWN zum Erstellen eines Screenshots (22e525).
  • UiDevice#setCompressedLayoutHierarchy wurde hinzugefügt und UiDevice#setCompressedLayoutHeirarchy wurde eingestellt, um einen Tippfehler im Methodennamen zu korrigieren (4e2f65).
  • UiAutomatorInstrumentationTestRunner wurde als veraltet markiert, da es veraltete UiAutomatorTestCases verarbeitet und nicht mehr erforderlich ist (be6c85).
  • Die Verzögerung zwischen UiObject2 MotionEvents wurde auf das Doppelte der Display-Aktualisierungsrate aktualisiert, um Nutzergesten besser zu emulieren (454450).
  • Unterstützung für mehrzeiligen Text und den Abgleich von Beschreibungen hinzugefügt (1625e6, b/255787130).

Fehlerkorrekturen

  • Es wurde ein Problem behoben, bei dem gelegentlich StaleObjectException-Fehler beim Abfragen oder Warten auf Objekte ausgegeben wurden (4cbcc0).
  • Die Rückgabewerte von UiScrollable#scrollToBeginning, scrollToEnd, flingToBeginning und flingToEnd geben jetzt an, ob der Anfang oder das Ende erreicht wurde (d33e06).
  • Die Methoden UiScrollable#scrollForward und scrollBackward haben das konfigurierte Zeitlimit ignoriert (29e4f3).
  • Der BySelector-Kopierkonstruktor verarbeitet jetzt auch Tiefenauswahlen (6c7b91).
  • Die Verarbeitung ungültiger Prozentwerte in UiObject#pinchIn und pinchOut wurde korrigiert (01b973).
  • Ein seltenes Problem wurde behoben, bei dem die Unterstützung für mehrere Fenster verloren ging, wenn die zugrunde liegende UiAutomation-Verbindung zurückgesetzt wurde (1bb956).

Version 2.3.0-alpha01

7. September 2022

androidx.test.uiautomator:uiautomator:2.3.0-alpha01 ist veröffentlicht. Version 2.3.0-alpha01 enthält diese Commits.

API-Änderungen

  • Die Nullable-Eigenschaft aller öffentlichen Methoden wurde annotiert.
  • Die MotionEvent-Einfügung wurde auf asynchron mit einer kurzen Verzögerung umgestellt, um UiObject2-Gesten flüssiger zu gestalten.
  • Das Abfrageintervall während des Wartens wurde von 1.000 ms auf 100 ms reduziert.
  • UiDevice#wakeUp und UiDevice#sleep wurden aktualisiert, sodass KEYCODE_WAKEUP und KEYCODE_SLEEP verwendet werden, um Geräte zu unterstützen, die die Ein/Aus-Taste überschreiben.
  • UiObject2#getDisplayId wurde hinzugefügt und es wird unterstützt, Objekte auf mehreren Displays zu finden und zu verwalten.
  • Die Methoden UiObject#click und UiObject2#clickAndWait zum Klicken auf einen Punkt anhand seiner Koordinaten wurden hinzugefügt.

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem die Berechnungen der Displaygröße gelegentlich falsch waren und möglicherweise Teile des Bildschirms ignoriert wurden, insbesondere im Multi-Window-Modus (Ifc016c).
  • Die Skalierung von Screenshots in UiDevice#takeScreenshot wurde korrigiert (Id80ad6).
  • Die Zuverlässigkeit von Until.scrollFinished und UiObject2#scroll wurde verbessert (I7b0595).
  • Es wurden Warnungen im strengen Modus IncorrectContextUseViolation behoben (Iffa6a0).