Interagire con le app per Android eseguendo gesti ed eventi chiave sugli elementi UI.
Utilizzo
android input [-h] [--device=PARAM]
Opzioni
--device=PARAM: numero di serie del dispositivo o ID dell'emulatore (come indicato da "adb devices").-h,--help: mostra il messaggio di aiuto per il comando specificato.
Opzioni android:
--sdk=PARAM: percorso dell'SDK Android.-v,--verbose: attiva l'output dettagliato per la risoluzione dei problemi.-V,--version: stampa le informazioni sulla versione ed esce.
Sottocomandi
key: premi un tasto hardware, un tasto di navigazione o un codice tasto Android.scroll: scorri un elemento contenitore, facoltativamente finché non viene visualizzato un elemento target.swipe: scorri da un elemento UI corrispondente a un selettore in una direzione specifica.tap: tocca un elemento UI corrispondente a un selettore.text: digita il testo in un elemento UI corrispondente a un selettore.
Descrizione
android input esegue le interazioni utente e gli input hardware su un dispositivo o un emulatore Android connesso.
Gli agenti AI e gli script di test possono utilizzare android input in combinazione con
android layout o android screen per rilevare gli elementi UI
e interagire con loro utilizzando gesti o tasti.
Selettori di elementi UI
La maggior parte dei sottocomandi input ha come target gli elementi UI utilizzando un'espressione selettore. Un selettore è un elenco separato da virgole di coppie key=value o key:value che specificano le proprietà che un elemento di destinazione deve soddisfare. Racchiudi i selettori tra virgolette singole per evitare che la shell interpreti spazi, virgole o caratteri speciali.
I selettori corrispondono alla gerarchia dei nodi di accessibilità in tempo reale dell'app:
- Proprietà stringa: per impostazione predefinita, vengono abbinate come sottostringhe senza distinzione tra maiuscole e minuscole (ad esempio,
text=submitcorrisponde a "Invia ordine"). Passa*per trovare la corrispondenza con qualsiasi elemento con un valore non vuoto per la proprietà. Racchiudi un valore tra barre per trovare una corrispondenza come espressione regolare sensibile alle maiuscole che può corrispondere a qualsiasi parte del valore (ad esempio,text=/^Submit$/). Aggiungi il flagidopo la barra di chiusura per un'espressione regolare senza distinzione tra maiuscole e minuscole (ad esempio,text=/^submit$/i). Le virgole all'interno di un'espressione regolare non suddividono il selettore. Per trovare corrispondenze con il testo letterale che inizia con/, utilizza un'espressione regolare cometext=/^\/help/.text(sinonimo:txt): il testo visibile visualizzato sull'elemento.id(sinonimo:res): Il nome ID della risorsa della vista (ad esempio,id=submit_buttono il nome completo della risorsacom.example.app:id/submit_button).class(sinonimi:clazz,cls,clz): il nome della classe dell'elemento o il nome della classe semplice (ad esempioclass=Buttonoandroid.widget.Button).desc(sinonimo:content): la descrizione dei contenuti di accessibilità.
- Proprietà di interazione: vengono abbinate come valori booleani (
trueofalse).clickable(sinonimo:click): indica se l'elemento è cliccabile.checkable: indica se l'elemento può essere selezionato o attivato/disattivato.scrollable(sinonimo:scroll): indica se l'elemento è un contenitore scorrevole.focusable: indica se per l'elemento è possibile impostare lo stato attivo.longclickable(sinonimo:longclick): indica se l'elemento supporta i clic prolungati.
- Proprietà di stato: vengono abbinate come valori booleani (
trueofalse).checked: indica se l'elemento è attualmente selezionato.focused: indica se l'elemento ha attualmente lo stato attivo.selected: indica se l'elemento è attualmente selezionato.
Comportamento di corrispondenza (--match)
Quando un selettore corrisponde a più di un elemento sullo schermo:
--match=single(predefinito): non va a buon fine con un errore ed elenca tutti gli elementi corrispondenti, assicurando che le interazioni non attivino il componente UI sbagliato.--match=first: interagisce con il primo elemento corrispondente rilevato nella gerarchia della UI.
Gesti e comandi disponibili
tap <target>: fa clic sul centro dell'elemento target.text <string> <target>: cancella il testo esistente e digita<string>nell'elemento target. Passa--submitper inviare un evento chiave Invio/OK dopo la digitazione.scroll <target>: scorre un elemento contenitore in una direzione specificata (--dir=up|down|left|right). Utilizza--until=<selector>per continuare a scorrere finché non viene visualizzato un elemento corrispondente.swipe <target>: esegue un gesto di scorrimento a partire da<target>in una direzione (--dir=up|down|left|right), con--distance(frazione dello schermo) e--speed(pixel al secondo) facoltativi.key <key>: invia un evento di tasto o pulsante hardware (ad esempioback,home,recents,power,volume-up,volume-down,enter,tab,esco un codice tasto Android intero). Supporta i flag di modifica--shift,--alte--ctrl.
Specifica un dispositivo di destinazione (--device)
Se sono collegati più dispositivi o emulatori, passa --device=<serial-number>
(come riportato da adb devices) per indirizzare gli eventi di input a un dispositivo specifico.
Esempi
Tocca un pulsante in base al testo visibile:
android input tap 'text=Submit'
Tocca un elemento corrispondente a più proprietà:
android input tap 'id=submit_btn,class=Button,clickable=true'
Tocca il primo elemento corrispondente quando esistono più corrispondenze:
android input tap --match=first 'class=android.widget.TextView'
Digita il testo in un campo di immissione e invia:
android input text 'user@example.com' 'id=email_input' --submit
Scorri un contenitore verso il basso finché non viene visualizzato un elemento:
android input scroll 'id=recycler_view' --dir=down --until='text=Settings'
Scorri verso sinistra su un elemento della scheda:
android input swipe 'id=card_view' --dir=left
Premi il pulsante Indietro del dispositivo:
android input key back