UiAutomation Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts.
[Android.Runtime.Register("android/app/UiAutomation", DoNotGenerateAcw=true)]
public sealed class UiAutomation : Java.Lang.Object[<Android.Runtime.Register("android/app/UiAutomation", DoNotGenerateAcw=true)>]
type UiAutomation = class
inherit Object- Vererbung
- Attribute
Hinweise
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. Es basiert auf den Plattform-Barrierefreiheits-APIs, um den Bildschirm einzutrospektieren und einige Aktionen für die Remoteansichtsstruktur auszuführen. Es ermöglicht auch das Einfügen beliebiger roher Eingabeereignisse, die die Benutzerinteraktion mit Tastaturen und Touchgeräten simulieren. Man kann sich eine UiAutomation als einen speziellen Typ von AccessibilityService vorstellen, der keine Hooks für den Dienstlebenszyklus bereitstellt und andere APIs verfügbar macht, die für die Benutzeroberflächentestautomatisierung nützlich sind. Die apIs, die von dieser Klasse verfügbar gemacht werden, sind niedrig, um die Flexibilität beim Entwickeln von Benutzeroberflächentestautomatisierungstools und -bibliotheken zu maximieren. Im Allgemeinen sollte ein UiAutomation-Client eine Bibliothek auf höherer Ebene verwenden oder allgemeine Funktionen implementieren. Zum Beispiel erfordert das Ausführen eines Tippens auf dem Bildschirm das Erstellen und Einfügen eines Touchdown- und Up-Ereignisses, die durch einen Aufruf von injectInputEvent(InputEvent,boolean) an das System übermittelt werden müssen.
Die apIs, die von dieser Klasse verfügbar gemacht werden, funktionieren über Anwendungen hinweg, sodass ein Client Tests schreiben kann, die Anwendungsfälle über mehrere Anwendungen hinweg abdecken. Wechseln Sie beispielsweise zur Einstellungsanwendung, um eine Einstellung zu ändern und dann mit einer anderen Anwendung zu interagieren, deren Verhalten von dieser Einstellung abhängt.
Android-Referenz für android.app.UiAutomation.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Felder
| Name | Beschreibung |
|---|---|
| FlagDontSuppressAccessibilityServices |
Veraltet.
UiAutomation unterdrückt standardmäßig Barrierefreiheitsdienste. |
| FlagDontUseAccessibility |
Veraltet.
UiAutomation verwendet standardmäßig das Barrierefreiheitssubsystem. |
| RotationFreeze0 |
Veraltet.
Rotationskonstante: Fixieren der Drehung auf 0 Grad (natürliche Ausrichtung) |
| RotationFreeze180 |
Veraltet.
Drehkonstante: Drehung auf 180 Grad fixieren. |
| RotationFreeze270 |
Veraltet.
Drehkonstante: Drehung auf 270 Grad fixieren. |
| RotationFreeze90 |
Veraltet.
Drehkonstante: Drehung auf 90 Grad fixieren. |
| RotationFreezeCurrent |
Veraltet.
Drehkonstante: Fixieren der Drehung in den aktuellen Zustand. |
| RotationUnfreeze |
Veraltet.
Drehkonstante: Drehung aufheben (Drehen des Geräts ändert den Drehzustand). |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| JniPeerMembers |
Stellt JNI-Bindungsinfrastruktur für Android.App.UiAutomation bereit. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| RootInActiveWindow |
Ruft die Stamm-AccessibilityNodeInfo im aktiven Fenster ab. |
| ServiceInfo |
Ruft die AccessibilityServiceInfo ab, die diese UiAutomation beschreibt. |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
| WindowAnimationFrameStats |
Diese Methode war in API-Ebene 33 veraltet. |
| Windows |
Ruft die Fenster auf dem Bildschirm ab, die dem UiAutomation-Kontext zugeordnet sind (in der Regel die Standardanzeige. |
| WindowsOnAllDisplays |
Ruft die Fenster auf dem Bildschirm aller Anzeigen ab. |
Methoden
| Name | Beschreibung |
|---|---|
| AdoptShellPermissionIdentity() |
Übernehmen Sie die Berechtigungsidentität der Shell-UID für alle Berechtigungen. |
| AdoptShellPermissionIdentity(String[]) |
Übernehmen Sie die Berechtigungsidentität der Shell-UID nur für die bereitgestellten Berechtigungen. |
| ClearCache() |
Löscht den Barrierefreiheitscache. |
| ClearWindowAnimationFrameStats() |
Diese Methode war in API-Ebene 33 veraltet. |
| ClearWindowContentFrameStats(Int32) |
Löscht die Framestatistiken für den Inhalt eines bestimmten Fensters. |
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| DropShellPermissionIdentity() |
Legen Sie die Shell-Berechtigungsidentität ab, die von einem vorherigen Aufruf zur AdoptShellPermissionIdentity() übernommen wurde. |
| Equals(Object) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| ExecuteAndWaitForEvent(IRunnable, UiAutomation+IAccessibilityEventFilter, Int64) |
Führt einen Befehl aus und wartet auf ein bestimmtes Barrierefreiheitsereignis bis zu einem bestimmten Wartezeittimeout. |
| ExecuteShellCommand(String) |
Führt einen Shellbefehl aus. |
| ExecuteShellCommandRw(String) |
Führt einen Shellbefehl aus. |
| ExecuteShellCommandRwe(String) |
Führt einen Shellbefehl aus. |
| FindFocus(NodeFocus) |
Suchen Sie die Ansicht mit dem angegebenen Fokustyp. |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetWindowContentFrameStats(Int32) |
Ruft die Framestatistiken für ein bestimmtes Fenster ab. |
| GrantRuntimePermission(String, String) |
Erteilt einem Paket eine Laufzeitberechtigung. |
| GrantRuntimePermissionAsUser(String, String, UserHandle) |
Gewährt einem Benutzer eine Laufzeitberechtigung für ein Paket. |
| InjectInputEvent(InputEvent, Boolean) |
Eine Methode zum Einfügen eines beliebigen Eingabeereignisses. |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| PerformGlobalAction(GlobalAction) |
Führt eine globale Aktion aus. |
| RevokeRuntimePermission(String, String) |
Widerruft eine Laufzeitberechtigung aus einem Paket. |
| RevokeRuntimePermissionAsUser(String, String, UserHandle) |
Widerruft eine Laufzeitberechtigung aus einem Paket. |
| SetAnimationScale(Single) |
Legt die Systemeinstellungswerte fest, die den Skalierungsfaktor für Animationen steuern. |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetOnAccessibilityEventListener(UiAutomation+IOnAccessibilityEventListener) |
Legt einen Rückruf zum Beobachten des Datenstroms von AccessibilityEvents fest. |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| SetRotation(UiAutomationRotation) |
Legt die Gerätedrehung fest. |
| SetRunAsMonkey(Boolean) |
Legt fest, ob diese UiAutomation im "Affen"-Modus ausgeführt werden soll. |
| TakeScreenshot() |
Erstellt einen Screenshot. |
| TakeScreenshot(Window) |
Wird verwendet, um einen Screenshot eines Fensters zu erfassen. |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| WaitForIdle(Int64, Int64) |
Wartet darauf, dass der Barrierefreiheitsereignisdatenstrom im Leerlauf ist, was kein Barrierefreiheitsereignis innerhalb von idleTimeoutMillis empfangen hat. |
Ereignisse
| Name | Beschreibung |
|---|---|
| AccessibilityEvent |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| IJavaPeerable.Finalized() |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. (Geerbt von JavaObject) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Klasse für die Interaktion mit der Benutzeroberfläche des Geräts durch Simulation von Benutzeraktionen und Introspektion des Bildschirminhalts. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |