Interactuar con apps para Android realizando gestos y eventos de teclas en los elementos de la IU
Uso
android input [-h] [--device=PARAM]
Opciones
--device=PARAM: Es el número de serie del dispositivo o el ID del emulador (como lo informa "adb devices").-h,--help: Muestra el mensaje de ayuda para el comando especificado.
Opciones de android:
--sdk=PARAM: Es la ruta de acceso al SDK de Android.-v,--verbose: Habilita el resultado detallado para solucionar problemas.-V,--version: Imprime la información de la versión y se cierra.
Subcomandos
key: Presiona un botón de hardware, una tecla de navegación o un código de tecla de Android.scroll: Desplaza un elemento contenedor, de manera opcional, hasta que aparezca un elemento de destino.swipe: Desliza el dedo desde un elemento de la IU que coincida con un selector en una dirección determinada.tap: Presiona un elemento de la IU que coincida con un selector.text: Escribe texto en un elemento de la IU que coincida con un selector.
Descripción
android input realiza interacciones del usuario y entradas de hardware en un dispositivo o emulador con Android conectado.
Los agentes de IA y las secuencias de comandos de prueba pueden usar android input en combinación con
android layout o android screen para descubrir elementos de la IU
y, luego, interactuar con ellos a través de gestos o pulsaciones de teclas.
Selectores de elementos de la IU
La mayoría de los subcomandos de input se orientan a elementos de la IU con una expresión de selector. Un
selector es una lista separada por comas de pares key=value o key:value
que especifican las propiedades que debe cumplir un elemento de destino. Encierra los selectores entre
comillas simples para evitar que la shell interprete espacios, comas o caracteres
especiales.
Los selectores coinciden con la jerarquía de nodos de accesibilidad en vivo de la app:
- Propiedades de cadena: Se asocian como substrings que no distinguen mayúsculas de minúsculas de forma predeterminada (por ejemplo,
text=submitcoincide con "Enviar pedido"). Pasa*para que coincida con cualquier elemento que tenga un valor no vacío para esa propiedad. Une un valor entre barras para que coincida como una expresión regular que distingue mayúsculas de minúsculas y que puede coincidir con cualquier parte del valor (por ejemplo,text=/^Submit$/). Agrega la marcaidespués de la barra de cierre para una expresión regular que no distingue mayúsculas de minúsculas (por ejemplo,text=/^submit$/i). Las comas dentro de una expresión regular no dividen el selector. Para que coincida con el texto literal que comienza con/, usa una expresión regular comotext=/^\/help/.text(sinónimo:txt): Es el texto visible que se muestra en el elemento.id(sinónimo:res): Es el nombre del ID del recurso de vista (por ejemplo,id=submit_buttono el nombre completo del recursocom.example.app:id/submit_button).class(sinónimos:clazz,cls,clz): Es el nombre de la clase del elemento o el nombre de la clase simple (comoclass=Buttonoandroid.widget.Button).desc(sinónimo:content): Es la descripción del contenido de accesibilidad.
- Propiedades de interacción: Se asocian como valores booleanos (
trueofalse).clickable(sinónimo:click): Indica si se puede hacer clic en el elemento.checkable: Indica si el elemento se puede marcar o activar o desactivar.scrollable(sinónimo:scroll): Indica si el elemento es un contenedor desplazable.focusable: Indica si el elemento puede recibir enfoque.longclickable(sinónimo:longclick): Indica si el elemento admite clics largos.
- Propiedades de estado: Se asocian como valores booleanos (
trueofalse).checked: Indica si el elemento está marcado actualmente.focused: Indica si el elemento está enfocado actualmente.selected: Indica si el elemento está seleccionado actualmente.
Comportamiento de coincidencia (--match)
Cuando un selector coincide con más de un elemento en la pantalla, ocurre lo siguiente:
--match=single(predeterminado): Falla con un error y enumera todos los elementos coincidentes, lo que garantiza que las interacciones no activen el componente de IU incorrecto.--match=first: Interactúa con el primer elemento coincidente que se encuentra en la jerarquía de la IU.
Gestos y comandos disponibles
tap <target>: Hace clic en el centro del elemento de destino.text <string> <target>: Borra el texto existente y escribe<string>en el elemento de destino. Pasa--submitpara enviar un evento de tecla Intro/Aceptar después de escribir.scroll <target>: Desplaza un elemento contenedor en una dirección especificada (--dir=up|down|left|right). Usa--until=<selector>para seguir desplazándote hasta que aparezca un elemento coincidente.swipe <target>: Realiza un gesto de deslizamiento que comienza desde<target>en una dirección (--dir=up|down|left|right), con--distance(fracción de pantalla) y--speed(píxeles por segundo) opcionales.key <key>: Envía un botón de hardware o un evento de tecla (comoback,home,recents,power,volume-up,volume-down,enter,tab,esco un código de tecla de Android de número entero). Admite las marcas modificadoras--shift,--alty--ctrl.
Especifica un dispositivo de destino (--device)
Si hay varios dispositivos o emuladores conectados, pasa --device=<serial-number> (como lo informa adb devices) para dirigir los eventos de entrada a un dispositivo específico.
Ejemplos
Presiona un botón por su texto visible:
android input tap 'text=Submit'
Presiona un elemento que coincida con varias propiedades:
android input tap 'id=submit_btn,class=Button,clickable=true'
Presiona el primer elemento coincidente cuando haya varias coincidencias:
android input tap --match=first 'class=android.widget.TextView'
Escribe texto en un campo de entrada y envíalo:
android input text 'user@example.com' 'id=email_input' --submit
Desplaza un contenedor hacia abajo hasta que aparezca un elemento:
android input scroll 'id=recycler_view' --dir=down --until='text=Settings'
Desliza el dedo hacia la izquierda en un elemento de la tarjeta:
android input swipe 'id=card_view' --dir=left
Presiona el botón Atrás del dispositivo:
android input key back