Boilerplate WebdriverIO

Este repositorio contiene un boilerplate (plantilla inicial) para empezar a trabajar con WebdriverIO, un framework de automatización de pruebas para navegadores web y aplicaciones móviles.

Requisitos previos

Antes de utilizar este boilerplate, asegúrate de tener instalado Node.js en tu sistema. Puedes descargarlo e instalarlo desde nodejs.org.

También te sugiero utilizar:

• La guía de mi blog Appium v2 Android Setup Guide
• El video de setup de mi canal de youtube: Appium v2 - WebdriverIO, es importante tener en cuenta que esto es una referencia, el setup de WDIO cambió y hay opciones que cambiaron.

Instalación

1. Clona este repositorio en tu máquina local:

git clone https://github.com/charlyautomatiza/boilerplate-webdriverio.git

2. Navega hasta el directorio del proyecto:

cd boilerplate-webdriverio

3. Ejecuta el comando npm install:

npm install

Ejecución de pruebas

Para empezar a trabajar con WebdriverIO, podrás descargar la última versión de la Guinea Pig App de WebDriverIO, tanto para usar en Android como en iOS.

Para no tener errores te sugiero que crees una carpeta llamada app en la raíz del proyecto y dejes la apk de la Guinea Pig en la misma.

Una vez que hayas configurado tus variables de entorno, puedes ejecutar las pruebas utilizando el siguiente comando:

npm run wdio

Este comando ejecutará las pruebas utilizando WebdriverIO y generará un informe de resultados.

Para crear y abrir el reporte de Allure unificado de los resultados de los test

npm run open-report

Integración continua: Ejecución automática en emulador Android (GitHub Actions)

Este proyecto incluye un workflow de GitHub Actions que automatiza la ejecución de las pruebas E2E en un emulador de Android. El workflow realiza lo siguiente:

• Descarga la APK de ejemplo (Guinea Pig App) y la coloca en la carpeta app/.
• Configura los permisos necesarios para el emulador en el runner de CI.
• Levanta un emulador Android (API 34, Android 14) usando la acción reactivecircus/android-emulator-runner.
• Instala las dependencias del proyecto (Node.js, Appium, WebdriverIO, etc).
• Ejecuta los tests E2E definidos en el proyecto.
• Publica los resultados de Allure y JUnit como artefactos del workflow.

¿Cuándo se ejecuta este workflow?

• Automáticamente en cada push o pull request sobre la rama main.

Puedes consultar el archivo del workflow en .github/workflows/android-emulator.yml para más detalles.

Contribuir

¡Siéntete libre de contribuir a este proyecto! Si encuentras errores o tienes ideas para mejorar el boilerplate, por favor abre un issue o envía una pull request.

Soporte

Si necesitas ayuda o tienes alguna pregunta, no dudes en abrir un issue en este repositorio. Estaremos encantados de ayudarte.

Además, puedes encontrar más información sobre WebdriverIO en la documentación oficial.

Para obtener más contenido y actualizaciones, visita mi sitio web.

También puedes unirte a nuestro servidor de Discord para obtener soporte adicional y participar en la comunidad: Discord Server.