Android-Eingabe

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=submit mit „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 Flag i nach 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 wie text=/^\/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_button oder der vollständige Ressourcenname com.example.app:id/submit_button).
    • class (Synonyme: clazz, cls, clz): Der Name der Elementklasse oder der einfache Klassenname (z. B. class=Button oder android.widget.Button).
    • desc (Synonym: content): Die Beschreibung des Inhalts für die Barrierefreiheit im Internet.
  • Interaktionseigenschaften: Werden als boolesche Werte (true oder false) 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 (true oder false) 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, esc oder einen ganzzahligen Android-Tastencode). Unterstützt die Modifikator-Flags --shift, --alt und --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