Habilidade de Verificação de UI Android

Esta habilidade fornece uma abordagem sistemática para testar aplicações React Native em um emulador Android usando comandos ADB. Ela permite interação autônoma, verificação de estado e checagem de regressão visual.

Quando Usar

• Verificando mudanças de UI em apps React Native ou Android Nativo.
• Debugging autônomo de problemas de layout ou bugs de interação.
• Garantindo a funcionalidade de recursos quando o teste manual é muito lento.
• Capturando screenshots automatizados para documentação de Pull Requests.

🛠 Pré-requisitos

• Emulador Android em execução.
• adb instalado e no PATH.
• Aplicação em modo de depuração para acesso ao logcat.

🚀 Fluxo de Trabalho

1. Calibração do Dispositivo

Antes de interagir, sempre verifique a resolução da tela para garantir que as coordenadas de toque sejam precisas.

adb shell wm size

Observação: Layouts são frequentemente escalados. Use o tamanho físico retornado como base para cálculos de coordenadas.

2. Inspeção de UI (Descoberta de Estado)

Use o dump do uiautomator para encontrar os limites exatos dos elementos de UI (botões, campos de texto).

adb shell uiautomator dump /sdcard/view.xml && adb pull /sdcard/view.xml ./artifacts/view.xml

Pesquise no view.xml por text, content-desc ou resource-id. O atributo bounds [x1,y1][x2,y2] define a área clicável.

3. Comandos de Interação

• Toque: adb shell input tap <x> <y> (Use o centro dos limites do elemento).
• Deslizar: adb shell input swipe <x1> <y1> <x2> <y2> <duration_ms> (Usado para rolar).
• Entrada de Texto: adb shell input text "<message>" (Observação: Suporte limitado para caracteres especiais).
• Eventos de Teclado: adb shell input keyevent <code_id> (ex: 66 para Enter).

4. Verificação e Relatórios

Verificação Visual

Capture um screenshot após a interação para confirmar as mudanças na UI.

adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./artifacts/test_result.png

Verificação Analítica

Monitore os logs do console JS em tempo real para detectar erros ou registrar sucessos.

adb logcat -d | grep "ReactNativeJS" | tail -n 20

Limpeza

Sempre armazene os arquivos gerados na pasta artifacts/ para atender às regras de organização do projeto.

💡 Melhores Práticas

• Aguarde Animações: Sempre adicione uma pequena pausa (ex: 1-2s) entre a interação e a verificação.
• Toques Centrais: Calcule a média aritmética de [x1,y1][x2,y2] para o alvo de toque mais confiável.
• Marcadores de Log: Use mensagens de log distintas no código (ex: ✅ Action Successful) para facilitar a verificação grep.
• Falhe Rápido: Se uma uiautomator dump falhar ou não encontrar o texto esperado, pare e solucione o problema em vez de tocar cegamente.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.