Interaja com apps Android realizando gestos e eventos de tecla em elementos da interface.
Uso
android input [-h] [--device=PARAM]
Opções
--device=PARAM: número de série do dispositivo ou ID do emulador (conforme informado por "adb devices").-h,--help: mostra a mensagem de ajuda do comando especificado.
Opções de android:
--sdk=PARAM: caminho para o SDK do Android.-v,--verbose: ativa a saída detalhada para solução de problemas.-V,--version: imprime as informações da versão e sai.
Subcomandos
key: pressione um botão físico, uma tecla de navegação ou um código de tecla do Android.scroll: rola um elemento de contêiner, opcionalmente até que um elemento de destino apareça.swipe: desliza de um elemento da interface que corresponde a um seletor em uma determinada direção.tap: toque em um elemento da interface que corresponda a um seletor.text: digita texto em um elemento da interface que corresponde a um seletor.
Descrição
O android input realiza interações do usuário e entradas de hardware em um dispositivo ou emulador
conectado com tecnologia Android.
Os agentes de IA e os scripts de teste podem usar android input em combinação com
android layout ou android screen para descobrir elementos da interface
e interagir com eles usando gestos ou pressionamentos de teclas.
Seletores de elementos da interface
A maioria dos subcomandos input segmenta elementos da interface usando uma expressão de seletor. Um
seletor é uma lista separada por vírgulas de pares key=value ou key:value
que especificam as propriedades que um elemento de destino precisa atender. Coloque os seletores entre aspas simples para evitar que o shell interprete espaços, vírgulas ou caracteres especiais.
Os seletores correspondem à hierarquia de nós de acessibilidade ativa do app:
- Propriedades de string: correspondidas como substrings que não diferenciam maiúsculas de minúsculas por padrão (por exemplo,
text=submitcorresponde a "Enviar pedido"). Transmita*para corresponder a qualquer elemento com um valor não vazio para essa propriedade. Coloque um valor entre barras para que ele seja correspondido como uma expressão regular que diferencia maiúsculas de minúsculas e que pode corresponder a qualquer parte do valor (por exemplo,text=/^Submit$/). Adicione a flagiapós a barra de fechamento para uma expressão regular que não diferencia maiúsculas de minúsculas (por exemplo,text=/^submit$/i). As vírgulas dentro de uma expressão regular não dividem o seletor. Para corresponder a um texto literal que começa com/, use uma expressão regular comotext=/^\/help/.text(sinônimo:txt): o texto visível exibido no elemento.id(sinônimo:res): o nome do ID do recurso de visualização (por exemplo,id=submit_buttonou o nome completo do recursocom.example.app:id/submit_button).class(sinônimos:clazz,cls,clz): o nome da classe do elemento ou o nome simples da classe (comoclass=Buttonouandroid.widget.Button).desc(sinônimo:content): a descrição do conteúdo de acessibilidade.
- Propriedades de interação: correspondidas como valores booleanos (
trueoufalse).clickable(sinônimo:click): se o elemento pode ser clicado.checkable: se o elemento pode ser marcado ou alternado.scrollable(sinônimo:scroll): se o elemento é um contêiner rolável.focusable: se o elemento pode receber foco.longclickable(sinônimo:longclick): se o elemento é compatível com cliques longos.
- Propriedades de estado: correspondidas como valores booleanos (
trueoufalse).checked: se o elemento está marcado no momento.focused: se o elemento tem o foco no momento.selected: se o elemento está selecionado.
Comportamento de correspondência (--match)
Quando um seletor corresponde a mais de um elemento na tela:
--match=single(padrão): falha com um erro e lista todos os elementos correspondentes, garantindo que as interações não acionem o componente de interface errado.--match=first: interage com o primeiro elemento correspondente encontrado na hierarquia da interface.
Gestos e comandos disponíveis
tap <target>: clica no centro do elemento de destino.text <string> <target>: limpa o texto atual e digita<string>no elemento de destino. Transmita--submitpara enviar um evento de tecla Enter/OK após digitar.scroll <target>: rola um elemento de contêiner em uma direção especificada (--dir=up|down|left|right). Use--until=<selector>para continuar rolando até que um elemento correspondente apareça.swipe <target>: realiza um gesto de deslizar começando em<target>em uma direção (--dir=up|down|left|right), com--distance(fração da tela) e--speed(pixels por segundo) opcionais.key <key>: envia um evento de botão físico ou tecla (comoback,home,recents,power,volume-up,volume-down,enter,tab,escou um código de tecla inteiro do Android). Oferece suporte às flags modificadoras--shift,--alte--ctrl.
Especificar um dispositivo de destino (--device)
Se vários dispositivos ou emuladores estiverem conectados, transmita --device=<serial-number>
(conforme informado por adb devices) para direcionar eventos de entrada a um dispositivo específico.
Exemplos
Toque em um botão pelo texto visível:
android input tap 'text=Submit'
Toque em um elemento que corresponda a várias propriedades:
android input tap 'id=submit_btn,class=Button,clickable=true'
Toque no primeiro elemento correspondente quando houver várias correspondências:
android input tap --match=first 'class=android.widget.TextView'
Digite o texto em um campo de entrada e envie:
android input text 'user@example.com' 'id=email_input' --submit
Role um contêiner para baixo até que um item apareça:
android input scroll 'id=recycler_view' --dir=down --until='text=Settings'
Deslize para a esquerda em um elemento do card:
android input swipe 'id=card_view' --dir=left
Pressione o botão "Voltar" do dispositivo:
android input key back