1. Instalación y configuración del Java Development Kit (JDK)
Appium requiere el entorno de ejecución de Java para interactuar con las herramientas de Android. Es fundamental instalar una versión compatible, preferiblemente JDK 11 o superior.
- Descargue el instalador correspondiente a su sistema operativo desde el sitio oficial de Oracle o adopte una distribución abierta como OpenJDK.
- Tras completar la instalación, defina la variable de entorno JAVA_HOME apuntando al directorio raíz de la instalación de Java.
- Añada la ruta
%JAVA_HOME%\bin(en Windows) o$JAVA_HOME/bin(en macOS/Linux) a la variable global PATH.
Para confirmar que la configuración es exitosa, ejecute el siguiente comando en su terminal:
java -version
2. Preparación del Android SDK mediante Android Studio
Para automatizar aplicaciones en Android, es imprescindible contar con las herramientas del SDK. La forma más eficiente de gestionarlas es a través de Android Studio.
- Instale Android Studio y acceda al SDK Manager desde la configuración enicial.
- Descargue las Build-Tools y las Platform-Tools necesarias.
- Configure la variable de entorno ANDROID_HOME con la ruta donde se almacenó el SDK (comúnmente en
AppData\Local\Android\Sdken Windows). - Incorpore las siguientes rutas al PATH del sistema para habilitar el uso de comandos como
adb:%ANDROID_HOME%\platform-tools%ANDROID_HOME%\tools%ANDROID_HOME%\build-tools\[versión]
Verifique la conexión con el SDK mediante el comando:
adb version
3. Instalación de Node.js y NPM
Appium es un servidor desarrollado en Node.js, por lo que su motor de ejecución es obligatorio para el funcionamiento del ecosistema.
- Obtenga la versión LTS (Long Term Support) desde el portal oficcial de Node.js.
- Siga el asistente de instalación, el cual configurará automáticamente los binarios en el PATH.
Compruebe que Node.js y su gestor de paquetes estén disponibles:
node -v
npm -v
4. Despliegue de Appium Server
La instalación de Appium se realiza de forma global a través de NPM. Con la legada de Appium 2.x, el servidor es modular, permitiendo instalar solo los controladores (drivers) necesarios.
Ejecute el comando para instalar la versión principal:
npm install -g appium
Una vez instalado el servidor, es necesario instalar el driver para Android (UiAutomator2):
appium driver install uiautomator2
5. Verificación de Variables de Entorno
Para asegurar que Appium pueda localizar todas las dependencias durante la ejecución de las pruebas, valide que su entorno contenga las siguientes definiciones esenciales:
| Variable | Propósito |
|---|---|
| JAVA_HOME | Ruta base del compilador de Java. |
| ANDROID_HOME | Ruta base de las herramientas de Android SDK. |
| PATH | Debe incluir los directorios /bin de Java y /platform-tools de Android. |
Para un diagnóstico exhaustivo, se recomienda instalar y ejecutar appium-doctor, una utilidad que escanea el sistema en busca de configuraciones faltantes:
npm install -g appium-doctor
appium-doctor --android