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:

Versões recomendadas (QANode 0.2.2+)

npm install -g appium@3.2.0
appium driver install --source=npm appium-uiautomator2-driver@7.0.0
appium driver install --source=npm appium-xcuitest-driver@10.25.0

Para iOS, o XCUITest requer macOS com Xcode configurado.

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.

Self Healing

Quando Self Healing está habilitado, o Mobile Flow tenta recuperar automaticamente elementos em ações como toque e digitação quando os seletores gravados deixam de funcionar.

No mobile, a recuperação considera sinais como:

• accessibility_id
• texto visível
• label, name, value e hint
• resource-id
• tipo/classe nativa do elemento
• contexto próximo na hierarquia capturada pelo Appium

Isso ajuda em mudanças comuns como:

• ajustes pequenos de rótulo
• diferenças de maiúsculas/minúsculas
• texto com ou sem acento
• mudança de seletor mantendo o mesmo elemento na tela

O self healing em mobile também respeita a plataforma ativa:

• prioriza estratégias compatíveis com iOS quando a execução está em iOS
• prioriza estratégias compatíveis com Android quando a execução está em Android

Quando uma recuperação é aplicada, ela aparece nos detalhes da execução com:

• passo afetado
• confiança da recuperação
• seletor mobile utilizado
• ação Aplicar ao Fluxo para promover o seletor recuperado ao fluxo original

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.

double-tap

Toque duplo em um elemento.

long-press

Pressiona e segura um elemento por uma duração determinada. Útil para abrir menus de contexto, acionar seleção de texto e outros gestos longos.

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.

pinch-zoom

Executa um gesto de pinça (aproximar dedos) ou zoom (afastar dedos) sobre um elemento ou ponto da tela.

multi-touch

Simula um toque simultâneo em dois ou mais pontos da tela.

scroll

Rola o conteúdo em uma direção ou continua rolando até que um elemento ou texto apareça na tela.

Modos:

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 }}

permission

Gerencia alertas de sistema e permissões do aplicativo.

Operações:

grantPermission e revokePermission são suportados apenas em sessões Android com o UiAutomator2.

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