Nodo Mobile Flow

El nodo Mobile Flow permite automatizar interacciones con aplicaciones móviles nativas (Android e iOS) usando Appium. Soporta dispositivos reales, emuladores y servicios cloud como BrowserStack, Sauce Labs y LambdaTest.

Descripción General

Requisitos Previos

Appium

El nodo Mobile Flow requiere un servidor Appium accesible:

Versiones 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, XCUITest requiere macOS con Xcode configurado.

Drivers de Appium

Configuración General

Modo de Sesión

• Nueva Sesión (new): Abre una nueva sesión Appium en cada ejecución. Ideal para pruebas aisladas.
• Reutilizar Sesión (reuse): Reutiliza una sesión ya creada por otro nodo Mobile Flow en el mismo flujo. Útil para dividir automatizaciones largas en múltiples nodos manteniendo el mismo dispositivo conectado.

Credencial Mobile

La credencial centraliza la configuración de conexión y las capacidades del dispositivo. Configura en Credenciales → Nueva Credencial → Mobile.

Modos de Conexión

Capacidades del Dispositivo

Pasos (Mobile Steps)

El nodo Mobile Flow ejecuta una secuencia de pasos configurables. Cada paso representa una acción en el dispositivo.

Acciones Disponibles

Estrategias de Selector Mobile

Consejo: El Inspector Mobile genera automáticamente los selectores al tocar los elementos, sin necesidad de escribir XPath manualmente.

Detalle de las Acciones

tap

Toca un elemento usando estrategias de selector.

Si el selector falla en todos los intentos y existen coordenadas de fallback (generadas por el inspector), el toque se realizará en las coordenadas directas.

tap-coords

Toca en coordenadas absolutas en la pantalla.

type

Escribe texto en un campo de entrada.

clear

Limpia el contenido de un campo de entrada.

swipe

Desliza en la pantalla entre dos puntos.

scroll

Desplaza el contenido en una dirección.

wait

Espera una condición antes de continuar.

Modos:

assert

Verifica una condición en la aplicación. Si falla, el paso se marca como fallido.

Modos:

Los resultados de las aserciones están disponibles en los outputs:

{{ steps["mobile-flow"].outputs.asserts.nombreAsercion }}  →  true o false

extract

Extrae texto o un atributo de un elemento.

Los datos extraídos están disponibles en los outputs:

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

reset

Reinicia la aplicación, limpiando su estado (equivalente a desinstalar y reinstalar).

back

Presiona el botón físico/virtual Atrás (Android — keycode 4).

home

Presiona el botón Home (Android — keycode 3).

key-event

Envía un keycode de Android directamente al dispositivo.

Keycodes comunes:

Evidencias (Capturas de pantalla)

Cada paso puede tener configuración de evidencia individual:

Las capturas generadas están disponibles en la pestaña Evidencias del resultado de ejecución. Los toques y swipes se destacan con marcación visual verde sobre la captura.

Outputs

Ejemplo Completo

Inicio de sesión en app Android

Pasos configurados en el nodo:

1. wait → Modo: elementVisible, Selector: id=com.miapp:id/email_field (timeout: 10000ms)
2. tap → Selector: id=com.miapp:id/email_field
3. type → Selector: id=com.miapp:id/email_field, Texto: {{ variables.USER_EMAIL }}
4. type → Selector: id=com.miapp:id/password_field, Texto: {{ variables.USER_PASSWORD }}, Limpiar: true
5. tap → Selector: accessibility_id=Iniciar sesión
6. wait → Modo: elementVisible, Selector: id=com.miapp:id/home_title (timeout: 15000ms)
7. assert → Nombre: loginOk, Modo: elementExists, Selector: id=com.miapp:id/home_title
8. extract → Nombre: welcomeText, Selector: id=com.miapp:id/welcome_message, Atributo: text

Resultado tras la ejecución:

{
  "sessionId": "mi-sesion-android",
  "extracts": { "welcomeText": "¡Hola, Juan!" },
  "asserts": { "loginOk": true }
}

Reutilizando Sesión entre Nodos

Nodo 1 — Mobile Flow (Inicio de sesión)

• Session ID: sesion-android
• Pasos: inicio de sesión en la app

Nodo 2 — Mobile Flow (Verificar Pedido)

• Modo de Sesión: reuse
• Session ID: sesion-android
• Pasos: navegar a pedidos, verificar estado

Ambos nodos comparten el mismo dispositivo y estado de sesión.

Consejos

• Usa el Inspector Mobile para grabar pasos visualmente — genera los selectores automáticamente al tocar los elementos
• En la edición Desktop, Appium se inicia automáticamente cuando se ejecuta un flujo con nodo mobile — no se necesita configuración manual
• Prefiere accessibility_id como selector principal — es más estable que XPath y funciona en Android e iOS
• Configura capturas de pantalla en los pasos críticos para facilitar la identificación de fallos
• Usa Continuar en Fallo en aserciones de monitoreo para recopilar múltiples resultados sin interrumpir el flujo
• Para apps que tardan en iniciar, agrega un paso wait con elementVisible antes de interactuar
• El Session ID personalizado facilita la reutilización de sesión entre múltiples nodos Mobile Flow en el mismo flujo