Mit Android-Apps interagieren, indem Sie Gesten und Schlüsselereignisse auf UI-Elementen ausführen.
Nutzung
android input [-h] [--device=PARAM]
Optionen
--device=PARAM: Seriennummer des Geräts oder Emulator-ID (wie von „adb devices“ gemeldet).-h,--help: Zeigt die Hilfemeldung für den angegebenen Befehl an.
Optionen für android:
--sdk=PARAM: Pfad zum Android SDK.-v,--verbose: Aktiviert die ausführliche Ausgabe zur Fehlerbehebung.-V,--version– Versionsinformationen ausgeben und beenden.
Unterbefehle
key: Drücken Sie eine Hardwaretaste, eine Navigationstaste oder einen Android-Tastencode.scroll: Scrollt ein Containerelement, optional bis ein Zielelement angezeigt wird.swipe: Von einem UI-Element, das mit einem Selektor übereinstimmt, in eine bestimmte Richtung wischen.tap: Tippen Sie auf ein UI-Element, das einem Selektor entspricht.text: Text in ein UI-Element eingeben, das mit einem Selektor übereinstimmt.
Beschreibung
android input führt Nutzerinteraktionen und Hardwareeingaben auf einem verbundenen Android-Gerät oder Emulator aus.
KI-Agenten und Testskripts können android input in Kombination mit android layout oder android screen verwenden, um UI-Elemente zu finden und über Touch-Gesten oder Tastenanschläge mit ihnen zu interagieren.
UI-Elementselektoren
Die meisten input-Unterbefehle zielen mithilfe eines Selektorausdrucks auf UI-Elemente ab. Ein Selektor ist eine durch Kommas getrennte Liste von key=value- oder key:value-Paaren, die Attribute angeben, die ein Zielelement erfüllen muss. Setzen Sie Selektoren in einfache Anführungszeichen, um zu verhindern, dass die Shell Leerzeichen, Kommas oder Sonderzeichen interpretiert.
Selektoren werden mit der Live-Hierarchie der Bedienungshilfenknoten der App abgeglichen:
- String-Eigenschaften: Werden standardmäßig als Teilstrings ohne Berücksichtigung der Groß-/Kleinschreibung abgeglichen (z. B. stimmt
text=submitmit „Submit order“ überein). Übergeben Sie*, um alle Elemente mit einem nicht leeren Wert für dieses Attribut abzugleichen. Setzen Sie einen Wert in Schrägstriche, um ihn als regulären Ausdruck mit Berücksichtigung der Groß-/Kleinschreibung abzugleichen, der mit einem beliebigen Teil des Werts übereinstimmen kann (z. B.text=/^Submit$/). Fügen Sie das Flaginach dem schließenden Schrägstrich für einen regulären Ausdruck ohne Berücksichtigung der Groß-/Kleinschreibung hinzu (z. B.text=/^submit$/i). Kommas innerhalb eines regulären Ausdrucks teilen den Selektor nicht auf. Wenn Sie Literaltext abgleichen möchten, der mit/beginnt, verwenden Sie einen regulären Ausdruck wietext=/^\/help/.text(Synonym:txt): Der sichtbare Text, der auf dem Element angezeigt wird.id(Synonym:res): Der Name der Ansichtsressourcen-ID (z. B.id=submit_buttonoder der vollständige Ressourcennamecom.example.app:id/submit_button).class(Synonyme:clazz,cls,clz): Der Name der Elementklasse oder der einfache Klassenname (z. B.class=Buttonoderandroid.widget.Button).desc(Synonym:content): Die Beschreibung des Inhalts für die Barrierefreiheit im Internet.
- Interaktionseigenschaften: Werden als boolesche Werte (
trueoderfalse) abgeglichen.clickable(Synonym:click): Gibt an, ob das Element angeklickt werden kann.checkable: Gibt an, ob das Element angeklickt oder umgeschaltet werden kann.scrollable(Synonym:scroll): Gibt an, ob das Element ein scrollbarer Container ist.focusable: Gibt an, ob das Element fokussierbar ist.longclickable(Synonym:longclick): Gibt an, ob das Element langes Klicken unterstützt.
- Zustandseigenschaften: Werden als boolesche Werte (
trueoderfalse) abgeglichen.checked: Gibt an, ob das Element derzeit ausgewählt ist.focused: Gibt an, ob das Element derzeit im Fokus ist.selected: Gibt an, ob das Element derzeit ausgewählt ist.
Abgleichsverhalten (--match)
Wenn ein Selektor mit mehr als einem Element auf dem Bildschirm übereinstimmt:
--match=single(Standard): Schlägt mit einem Fehler fehl und listet alle übereinstimmenden Elemente auf, um sicherzustellen, dass Interaktionen nicht die falsche UI-Komponente auslösen.--match=first: Interagiert mit dem ersten übereinstimmenden Element, das in der UI-Hierarchie gefunden wird.
Verfügbare Touch-Gesten und Sprachbefehle
tap <target>: Klickt auf die Mitte des Zielelements.text <string> <target>: Löscht vorhandenen Text und gibt<string>in das Zielelement ein. Übergeben Sie--submit, um nach der Eingabe ein Enter/OK-Tastenereignis zu senden.scroll <target>: Scrollt ein Containerelement in eine bestimmte Richtung (--dir=up|down|left|right). Verwenden Sie--until=<selector>, um weiter zu scrollen, bis ein übereinstimmendes Element angezeigt wird.swipe <target>: Führt eine Wischgeste aus, die bei<target>in eine Richtung (--dir=up|down|left|right) beginnt, mit optionalem--distance(Bruchteil des Bildschirms) und--speed(Pixel pro Sekunde).key <key>: Sendet ein Hardware-Button- oder Tastaturereignis (z. B.back,home,recents,power,volume-up,volume-down,enter,tab,escoder einen ganzzahligen Android-Tastencode). Unterstützt die Modifikator-Flags--shift,--altund--ctrl.
Zielgerät angeben (--device)
Wenn mehrere Geräte oder Emulatoren verbunden sind, übergib --device=<serial-number> (wie von adb devices gemeldet), um Eingabeereignisse an ein bestimmtes Gerät weiterzuleiten.
Beispiele
Tippen Sie auf eine Schaltfläche, indem Sie den sichtbaren Text nennen:
android input tap 'text=Submit'
Tippen Sie auf ein Element, das mehreren Properties entspricht:
android input tap 'id=submit_btn,class=Button,clickable=true'
Auf das erste übereinstimmende Element tippen, wenn mehrere Übereinstimmungen vorhanden sind:
android input tap --match=first 'class=android.widget.TextView'
Geben Sie Text in ein Eingabefeld ein und senden Sie ihn ab:
android input text 'user@example.com' 'id=email_input' --submit
Scrollen Sie in einem Container nach unten, bis ein Element angezeigt wird:
android input scroll 'id=recycler_view' --dir=down --until='text=Settings'
Wische auf einem Kartenelement nach links:
android input swipe 'id=card_view' --dir=left
Drücken Sie die Zurück-Taste des Geräts:
android input key back