entrada do android

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=submit corresponde 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 flag i apó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 como text=/^\/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_button ou o nome completo do recurso com.example.app:id/submit_button).
    • class (sinônimos: clazz, cls, clz): o nome da classe do elemento ou o nome simples da classe (como class=Button ou android.widget.Button).
    • desc (sinônimo: content): a descrição do conteúdo de acessibilidade.
  • Propriedades de interação: correspondidas como valores booleanos (true ou false).
    • 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 (true ou false).
    • 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 --submit para 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 (como back, home, recents, power, volume-up, volume-down, enter, tab, esc ou um código de tecla inteiro do Android). Oferece suporte às flags modificadoras --shift, --alt e --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