webdriverio-template

Proyecto base y guía paso a paso para automatizar pruebas de aplicaciones móviles Android con Appium. Utiliza JavaScript con WebdriverIO como framework de automatización y el driver uiautomator2 para la interacción con el dispositivo.

Referencia base:

• Appium Quickstart: https://appium.io/docs/en/latest/quickstart/

Pre Requisitos, configuración y validación

1. Node.js >=24

   • Descarga: https://nodejs.org/
   • Valida: node -v → v26.5.0

2. npm >=10

   • Descarga: npm install -g npm
   • Valida: npm -v → 12.0.0

3. Java JDK >= 17

   • Debe ser JDK, no JRE.
   • Descarga: https://www.oracle.com/java/technologies/downloads/archive/ o https://adoptium.net/en-GB/temurin/releases/
   • Valida: java -version → java version "16.0.2" 2021-07-20
   • Valida: echo $env:JAVA_HOME → C:\Program Files\Java\jdk-16.0.2

4. Android SDK + Android Studio

   • Descarga: https://developer.android.com/studio
     • Al instalar descargar las opciones por defecto de SDK que deben incluir como minimo las siguientes:
     • Valida: (Settings → Languages & Frameworks → Android SDK)
       • SDK Platforms: Android 16.0 (API 36.1) *o la que se requiera
       • SDK Tools: Android SDK Platform-Tools y Android Emulator
   • Android SDK Variables de entorno: https://developer.android.com/tools/variables
   • Configura la variable de entorno ANDROID_HOME con la ruta donde está instalado el SDK de Android.
     • Valida: echo $env:ANDROID_HOME → C:\Users\robison.rojas\AppData\Local\Android\Sdk
   • Configura la variable de entorno PATH para incluir la ruta a las herramientas del SDK de Android.
     • %ANDROID_HOME%\platform-tools
     • %ANDROID_HOME%\tools
     • %ANDROID_HOME%\tools\bin
     • %ANDROID_HOME%\emulator
     • Valida: adb version → Android Debug Bridge version 1.0.41

5. Emulador o dispositivo Android conectado por USB o Wi-Fi.

   • Emulador CLI: https://developer.android.com/studio/run/emulator-commandline
   • Emulador GUI: Android Studio (More Actions → Virtual Device Manager)
   • Dispositivo físico:
     • Preparar dispositivo: https://developer.android.com/studio/debug/dev-options
     • Conectar dispositivo: https://developer.android.com/tools/adb#connect-to-a-device-over-wi-fi
   • Valida: adb devices → List of devices attached -emulator-5554 device

Instalar proyecto

Colonar o crear repositorio para el proyecto y ejecutar:

1. npm install appium appium-uiautomator2-driver webdriverio --save-dev

Herramientas de desarrollo

Instalar herramientas y plugins adicionales para apoyar el desarrollo:

Referencia: https://appium.io/docs/en/latest/ecosystem/

1. appium driver doctor: Valida si todos los requisitos previos y otros detalles del entorno necesarios para el controlador/complemento se han configurado correctamente.

   • npx appium driver doctor uiautomator2
   • appium {driver|plugin} doctor <extension-name>
   • Appium Doctor puede sugerir una o más soluciones opcionales. Pero si ve 0 required fixes needed, Eso significa que todo está listo para ejecutar pruebas de Appium.

2. Inspector: https://appium.github.io/appium-inspector/latest/

   • Descarga: appium plugin install inspector

Ejecutar la prueba

1. Inicia un emulador/dispositivo Android.

   • Valida: adb devices → List of devices attached -emulator-5554 device

2. Inicia Appium en una terminal:

   • npx appium

3. En otra terminal, ejecuta la prueba:

   • node test.js

La prueba se conecta por defecto a:

• Host: localhost
• Puerto: 4723

Puedes personalizarlo con variables de entorno:

• APPIUM_HOST
• APPIUM_PORT

Ejemplo:

$env:APPIUM_HOST = "localhost" $env:APPIUM_PORT = "4723" node test.js

---

win + R = systempropertiesadvanced