Inspetor Mobile

O Inspetor Mobile é uma ferramenta visual integrada ao QANode para gravar e construir passos de automação mobile interativamente. Em vez de escrever XPath e seletores manualmente, você interage diretamente com a tela do dispositivo e os passos são gerados automaticamente.

Como Acessar

O Inspetor Mobile é aberto a partir do editor de fluxos:

1. Adicione um nó Mobile Flow ao fluxo
2. Configure a credencial mobile (dispositivo, plataforma, app)
3. Clique no botão "Lupa" no painel de propriedades do nó

Na versão desktop, o Appium é iniciado automaticamente ao conectar. Na versão web/server, certifique-se de que o Appium está rodando antes de abrir o inspetor.

Interface

O Inspetor Mobile é dividido em três áreas principais:

┌──────────────────────────────────────────────────────────────┐
│  [Conectar]  Modo: [Toque | Inspecionar]   [Fechar Sessão]   │
├─────────────────────────┬────────────────────────────────────┤
│                         │  Ações Gravadas                    │
│   Tela do Dispositivo   │  ─────────────────────────────     │
│   (screenshot ao vivo)  │  1. tap — Botão Login              │
│                         │  2. type — email@...               │
│                         │  3. tap — Entrar                   │
│                         │  ─────────────────────────────     │
│                         │  [Limpar]          [Salvar Passos] │
├─────────────────────────┴────────────────────────────────────┤
│  Elemento Selecionado: id=com.app:id/login_btn               │
└──────────────────────────────────────────────────────────────┘

Área da Tela do Dispositivo

Exibe o screenshot atualizado do dispositivo em tempo real. Você pode:

• Tocar em elementos para gerar passos tap
• Arrastar para gerar passos swipe
• Clicar com clique-direito ou modo Inspecionar para ver detalhes do elemento

Área de Ações Gravadas

Lista todos os passos registrados durante a sessão. Cada ação mostra:

• Tipo da ação (tap, type, swipe, etc.)
• Descrição do alvo ou texto
• Botão para remover o passo individualmente

Painel do Elemento Selecionado

Exibe as informações do elemento tocado no modo Inspecionar:

• Classe nativa (android.widget.Button, XCUIElementTypeTextField, etc.)
• Resource ID, Accessibility ID, XPath
• Bounds (posição e tamanho na tela)
• Texto atual e atributos relevantes

Modos de Operação

Modo Toque (padrão)

No modo Toque, cada clique na tela do dispositivo:

1. Envia o toque para o dispositivo via Appium
2. Grava um passo tap ou tap-coords com os seletores do elemento tocado
3. Atualiza o screenshot automaticamente após a ação

Para deslizar (swipe): clique e arraste na tela do dispositivo — o gesto é executado no dispositivo e gravado como passo swipe.

Modo Inspecionar

No modo Inspecionar, clicar em um elemento não envia o toque ao dispositivo — apenas exibe as informações do elemento no painel inferior. Use este modo para:

• Explorar a hierarquia de elementos sem interagir com o app
• Copiar seletores para uso manual
• Identificar o melhor seletor antes de criar um passo

Gravando Passos

Passo de Toque (tap)

1. Certifique-se de estar no Modo Toque
2. Clique no elemento desejado na tela do dispositivo
3. O inspetor detecta o elemento, extrai seus seletores e grava um passo tap
4. A tela é atualizada automaticamente

Passo de Digitação (type)

Após tocar em um campo de texto:

1. O inspetor detecta que o campo está ativo
2. Digite o texto no seu teclado físico — o inspetor captura as teclas em tempo real
3. O texto digitado é agrupado e gravado como passo type
4. Pressionar Backspace apaga caracteres e atualiza o passo

Passo de Swipe

1. No Modo Toque, clique e arraste na tela do dispositivo
2. O gesto é executado no dispositivo
3. Um passo swipe é gravado com as coordenadas de início e fim

Feedback Visual

Durante o uso do inspetor, indicadores visuais são exibidos sobre a tela do dispositivo:

Esses indicadores desaparecem automaticamente após alguns segundos.

Salvando os Passos

Ao clicar em "Salvar Passos":

1. Todos os passos gravados na sessão são transferidos para o nó Mobile Flow
2. A sessão Appium permanece aberta (pode continuar gravando depois se necessário)
3. O inspetor é fechado e os passos ficam visíveis no painel do nó

Os passos gerados pelo inspetor podem ser editados manualmente no nó Mobile Flow após salvar — adicionar evidências, ajustar seletores, configurar tentativas, etc.

Gerenciando a Sessão

Fechar o inspetor sem clicar em "Salvar Passos" descarta os passos gravados na sessão atual. Passos já salvos anteriormente no nó não são afetados.

Seletores Gerados

O inspetor gera automaticamente seletores para cada elemento tocado, priorizando nesta ordem:

1. accessibility_id — Quando o elemento tem content-description ou accessibility label
2. id — Quando o elemento tem resource-id (Android) ou nome único (iOS)
3. xpath com @bounds — Seletor baseado nas coordenadas do elemento (mais preciso para tela atual)
4. Coordenadas de fallback — X/Y absolutos usados se todos os seletores falharem

Os seletores com @bounds são gerados pelo inspetor para manter alta precisão na tela específica. Em fluxos automatizados, se a resolução ou orientação mudar, os seletores por accessibility_id ou id são mais robustos.

Dicas

• Use o Modo Inspecionar para identificar o melhor seletor antes de gravar, especialmente em telas com muitos elementos semelhantes
• Grave um fluxo completo de uma vez — conectar, executar o caso de uso no app, salvar — para obter passos com contexto real
• Após salvar, revise os passos no nó e adicione screenshots de evidência nos passos críticos
• Para apps com animações longas, adicione passos wait (elementVisible) após os toques para garantir que a tela carregou antes da próxima ação
• Na versão desktop, a conexão com o dispositivo local é mais rápida — use para desenvolvimento. Para testes em cloud (BrowserStack, etc.), configure a credencial SaaS antes de abrir o inspetor