Nó Mobile Flow

O nó Mobile Flow permite automatizar interações com aplicativos móveis nativos (Android e iOS) usando o Appium. Suporta dispositivos reais, emuladores e serviços cloud como BrowserStack, Sauce Labs e LambdaTest.

Visão Geral

Pré-requisitos

Appium

O nó Mobile Flow requer um servidor Appium acessível:

Drivers Appium

Configuração Geral

Modo de Sessão

• Nova Sessão (new): Abre uma nova sessão Appium a cada execução. Ideal para testes isolados.
• Reutilizar Sessão (reuse): Reaproveita uma sessão já criada por outro nó Mobile Flow no mesmo fluxo. Útil para dividir automações longas em múltiplos nós mantendo o mesmo dispositivo conectado.

Credencial Mobile

A credencial centraliza as configurações de conexão e capacidades do dispositivo. Configure em Credenciais → Nova Credencial → Mobile.

Modos de Conexão

Capacidades do Dispositivo

Passos (Mobile Steps)

O nó Mobile Flow executa uma sequência de passos configuráveis. Cada passo representa uma ação no dispositivo.

Ações Disponíveis

Estratégias de Seletor Mobile

Dica: O Inspetor Mobile gera automaticamente os seletores ao tocar nos elementos, sem necessidade de escrever XPath manualmente.

Detalhes das Ações

tap

Toca em um elemento usando estratégias de seletor.

Caso o seletor falhe em todas as tentativas e houver coordenadas de fallback (geradas pelo inspetor), o toque será realizado nas coordenadas diretas.

tap-coords

Toca em coordenadas absolutas na tela.

type

Digita texto em um campo de entrada.

clear

Limpa o conteúdo de um campo de entrada.

swipe

Desliza na tela entre dois pontos.

scroll

Rola o conteúdo em uma direção.

wait

Aguarda uma condição antes de prosseguir.

Modos:

assert

Verifica uma condição no aplicativo. Se falhar, o passo é marcado como falha.

Modos:

Os resultados das asserções ficam disponíveis nos outputs:

{{ steps["mobile-flow"].outputs.asserts.nomeAsserção }}  →  true ou false

extract

Extrai texto ou atributo de um elemento.

Os dados extraídos ficam disponíveis nos outputs:

{{ steps["mobile-flow"].outputs.extracts.nomeExtracao }}

reset

Reinicia o aplicativo, limpando seu estado (equivalente a desinstalar e reinstalar).

back

Pressiona o botão físico/virtual Voltar (Android — keycode 4).

home

Pressiona o botão Home (Android — keycode 3).

key-event

Envia um keycode Android diretamente ao dispositivo.

Keycodes comuns:

Evidências (Screenshots)

Cada passo pode ter configuração de evidência individual:

Os screenshots gerados ficam disponíveis na aba Evidências do resultado da execução. Toques e swipes são destacados com marcação visual verde sobre o screenshot.

Outputs

Exemplo Completo

Login em aplicativo Android

Passos configurados no nó:

1. wait → Modo: elementVisible, Seletor: id=com.meuapp:id/email_field (timeout: 10000ms)
2. tap → Seletor: id=com.meuapp:id/email_field
3. type → Seletor: id=com.meuapp:id/email_field, Texto: {{ variables.USER_EMAIL }}
4. type → Seletor: id=com.meuapp:id/password_field, Texto: {{ variables.USER_PASSWORD }}, Limpar: true
5. tap → Seletor: accessibility_id=Entrar
6. wait → Modo: elementVisible, Seletor: id=com.meuapp:id/home_title (timeout: 15000ms)
7. assert → Nome: loginOk, Modo: elementExists, Seletor: id=com.meuapp:id/home_title
8. extract → Nome: welcomeText, Seletor: id=com.meuapp:id/welcome_message, Atributo: text

Resultado após execução:

{
  "sessionId": "minha-sessao-android",
  "extracts": { "welcomeText": "Olá, João!" },
  "asserts": { "loginOk": true }
}

Reutilizando Sessão entre Nós

Nó 1 — Mobile Flow (Login)

• Session ID: sessao-android
• Passos: login no app

Nó 2 — Mobile Flow (Verificar Pedido)

• Modo de Sessão: reuse
• Session ID: sessao-android
• Passos: navegar para pedidos, verificar status

Ambos os nós compartilham o mesmo dispositivo e estado de sessão.

Dicas

• Use o Inspetor Mobile para gravar passos visualmente — ele gera os seletores automaticamente ao tocar nos elementos
• Na versão desktop, o Appium é iniciado automaticamente quando um fluxo com nó mobile é executado — não é necessário nenhuma configuração manual
• Prefira accessibility_id como seletor principal — é mais estável que XPath e funciona em Android e iOS
• Configure screenshots nos passos críticos para facilitar a identificação de falhas
• Use Continuar em Falha em asserções de monitoramento para coletar múltiplos resultados sem interromper o fluxo
• Para apps que demoram para iniciar, adicione um passo wait com elementVisible antes de interagir
• O Session ID personalizado facilita a reutilização de sessão entre múltiplos nós Mobile Flow no mesmo fluxo