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.

Self Healing

Cuando Self Healing está habilitado, Mobile Flow puede recuperar automáticamente elementos en acciones como toque y escritura cuando los selectores grabados dejan de funcionar.

En mobile, la recuperación considera señales como:

• accessibility_id
• texto visible
• label, name, value y hint
• resource-id
• clase/tipo nativo del elemento
• contexto cercano en la jerarquía capturada por Appium

Esto ayuda en cambios comunes como:

• pequeños ajustes de etiqueta
• diferencias entre mayúsculas y minúsculas
• texto con o sin acentos
• cambios de selector manteniendo el mismo elemento en pantalla

El self healing en mobile también respeta la plataforma activa:

• prioriza estrategias compatibles con iOS cuando la ejecución corre en iOS
• prioriza estrategias compatibles con Android cuando la ejecución corre en Android

Cuando una recuperación se aplica, aparece en los detalles de la ejecución con:

• el paso afectado
• la confianza de la recuperación
• el selector mobile utilizado
• una acción Aplicar al Flujo para promover el selector recuperado al flujo original

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.

Cuando el flujo se graba vía MCP, los pasos aparecen en el editor visual con el mismo patrón de revisión del Inspector Mobile, incluyendo destaques de interacción e información útil para revisar fallos.

Use MCP para grabar o ajustar jornadas mobile cuando un cliente de IA necesita interactuar con Appium, pero revise el editor visual para confirmar que cada objetivo grabado representa la acción esperada.

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.

Para campos de texto, QANode intenta localizar el objetivo por capas:

1. identificadores fuertes como resource-id, accessibility id, name y content-desc;
2. hint, label y text cuando pertenecen al propio campo;
3. relación contextual entre el label visible y el input cercano;
4. coordenadas grabadas como fallback visual;
5. clase genérica de input solo como último recurso.

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.

Modos:

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

double-tap

Hace doble toque en un elemento usando estrategias de selector.

long-press

Realiza una pulsación larga en un elemento.

pinch-zoom

Realiza un gesto de pellizco o zoom sobre un elemento.

multi-touch

Realiza un gesto multitáctil con dos dedos simultáneos.

permission

Acepta o descarta alertas del sistema, o concede/revoca permisos de la app Android.

Acciones:

Las acciones grantPermission y revokePermission son exclusivas de Android. El nombre del permiso sigue el formato Android, por ejemplo: android.permission.CAMERA.

push-file

Envía un archivo de QANode al dispositivo antes de continuar la automatización.

Use este paso cuando la aplicación necesita que un archivo exista en el dispositivo antes de abrir un selector nativo, galería, picker de documentos o flujo de upload.

En Android, las rutas comunes quedan en /sdcard/Download/.... En iOS, QANode intenta enviar al container de la aplicación cuando está disponible y usa un fallback compatible con Appium/XCUITest.

pull-file

Descarga un archivo del dispositivo, lo guarda como artefacto de QANode y retorna fileRef.

Cuando sea posible, prefiera Ruta exacta. Cuando la aplicación genera el archivo con nombre dinámico, use carpeta/patrón para capturar el archivo compatible más reciente.

Archivos como imágenes, PDFs, textos, planillas y videos pueden capturarse siempre que Appium consiga leer el archivo en el dispositivo o en el container de la aplicación.

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

Archivos descargados

Cuando se ejecuta un paso Descargar archivo, el output queda disponible por el nombre de la variable:

{{ steps["mobile-flow"].outputs.files.reporte.fileRef }}
{{ steps["mobile-flow"].outputs.files.reporte.name }}
{{ steps["mobile-flow"].outputs.fileRef }}

Use el fileRef para pasar el archivo a Extraer Archivo, Archivo a Base64, HTTP Request, componentes u otros nodos que aceptan archivo.

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