layout do Android

Retorna a árvore de layout de um app.

Uso

android layout [-dhp] [--device=PARAM] [--flat] [--full] [--no-idle] [--output=PARAM]

Opções

  • --device=PARAM: o número de série do dispositivo.
  • -d,--diff: descontinuada; sinalização sem operação. Será removido em uma versão futura.
  • --flat: retorna uma lista simples em vez de uma árvore.
  • --full: retorna a árvore completa, incluindo elementos não interativos e ocultos.
  • -h,--help: mostra a mensagem de ajuda do comando especificado.
  • --no-idle - Não aguarde o estado inativo do layout ao buscar o layout.
  • -o,--output=PARAM: grava o layout no arquivo ou diretório especificado. Se omitido, será impresso na saída padrão.
  • -p,--pretty: imprime o JSON retornado de forma organizada.

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 informações da versão e sai.

Descrição

O android layout captura a hierarquia da interface em tempo real da tela ativa em um dispositivo Android ou emulador conectado e a gera no formato JSON.

Agentes de IA e scripts de teste podem usar o android layout para inspecionar texto visível, IDs de recursos, descrições de acessibilidade, estados de interação e limites de elementos sem depender apenas de capturas de tela visuais.

Formatar e filtrar a saída de layout

  • -p, --pretty: formata a saída JSON com recuo e quebras de linha para facilitar a leitura.
  • -o, --output: grava o JSON de layout no caminho de arquivo especificado em vez da saída padrão.
  • --flat: gera uma lista JSON simples de nós da interface em vez de uma árvore de hierarquia aninhada.
  • --full: inclui elementos da interface não interativos e ocultos que são filtrados por padrão.
  • --no-idle: captura o layout imediatamente sem esperar que a linha de execução da interface do app atinja um estado ocioso.

Exemplos

Imprima a árvore de layout da interface formatada da tela ativa:

android layout --pretty

Salve a hierarquia completa da interface (incluindo elementos não interativos) em um arquivo:

android layout --pretty --full --output=./hierarchy.json