Requisitos previos del sistema

Para establecer un entorno de pruebas funcional con Appium en Windows, es necesario preparar los siguientes componentes fundamentales:

• Intérprete de Python: Se recomienda una versión 3.x superior a la 3.5, como la 3.6.6. Se sugiere el uso de un entorno de desarrollo como PyCharm o VS Code.
• Node.js: Motor de ejecución necesario para instalar el servidor de Appium vía línea de comandos.
• Java Development Kit (JDK): Versión 1.8 o superior es obligatoria.
• Servidor de Appium: Puede instalarse como cliente de escritorio o mediante npm.
• Android SDK: Conjunto de herramientas para la compilación y depuración de aplicaciones Android.
• Dispositivo de pruebas: Un teléfono físico o un emulador como Nox Player.
• Biblioteca de cliente: El paquete Appium-Python-Client para la interacción desde scripts de Python.

Instalación de los componentes principales

1. Configuración de Python y Node.js

La instalación de Python y Node.js en Windows es un proceso directo. Se debe descargar el instalador oficial de cada proyecto y seguir las instrucciones, asegurándose de añadir los ejecutables al PATH del sistema.

2. Configuración del JDK de Java

Después de instalar el JDK, es crucial establecer la variable de entorno JAVA_HOME apuntando al directorio de instalación, y añadir la ruta del subdirectorio bin al PATH.

3. Instalación del servidor de Appium

Existen dos métodos principales para instalar Appium:

Método A: Cliente de Escritorio

Descargue el instalador .exe desde la página oficial de lanzamientos de Appium Desktop en GitHub. Ejecútelo y siga el asistente. Tras la instalación, inicie la aplicación, cambie el host a 127.0.0.1 y haga clic en "Start Server". El servidor debería iniciar en el puerto 4723, lo que confirma la instalación exitosa.

Método B: Línea de comandos (npm)

Para una instalación por terminal, se pueden usar los siguientes comandos, priorizando el registro de npm de Taobao si hay problemas de conectividad:

# Instalación usando el registro de Taobao
npm --registry http://registry.npm.taobao.org install -g appium
# Alternativa: instalar una versión específica
npm --registry http://registry.npm.taobao.org install -g appium@1.7.2

Se puede verificar la instalación con el comando appium, que debería iniciar el servidor. Para diagnóstico, puede instalarse appium-doctor.

4. Configuración del Android SDK

Después de descomprimir el SDK en una carpeta (por ejemplo, C:\Android\SDK), es obligatorio configurar las siguientes variables de entorno:

• Añadir C:\Android\SDK\platform-tools al PATH del sistema (contiene adb).
• Añadir C:\Android\SDK\tools y C:\Android\SDK\tools\bin al PATH (contiene herramientas como aapt y uiautomatorviewer).
• Crear una variable de entorno ANDROID_HOME con el valor de la ruta de instalación del SDK.

La verificación se realiza ejecutando adb version en un terminal, lo que debería mostrar la versión del puente de depuarción de Android.

5. Configuración del emulador Nox y utilidades del SDK

Para garantizar una integración fluida entre el SDK de Android y el emulador Nox, es recomendable copiar el archivo adb.exe desde ANDROID_HOME\platform-tools al directorio de instalación de Nox (por ejemplo, C:\Program Files\Nox\bin), renombrándolo como nox_adb.exe tras hacer una copia de seguridad del archivo original.

Dentro de las herramientas del SDK, hay dos esenciales para las pruebas:

• aapt: Utilidad para inspeccionar archivos APK. Permite extraer el nombre del paquete y la actividad principal. ``` aapt dump badging Ruta\al\archivo.apk

  
  Busque las líneas `package: name='...' ` y `launchable activity name='...' `.
  

• uiautomatorviewer: Herramienta gráfica para inspeccionar la jerarquía de vistas de la interfaz de usuario de una aplicación en un dispositivo conectado. Se inicia con uiautomatorviewer desde la terminal. (Nota: Cierre cualquier sesión activa de Appium para evitar conflictos de puerto).

6. Instalación del cliente Python para Appium

La biblioteca que permite a los scripts de Python comunicarse con el servidor de Appium se instala mediante pip:

pip install Appium-Python-Client

Se puede verificar una instalación correcta importando el módulo en un intérprete de Python sin errores.

Primer script de prueba automatizado

Con todos los componentes configurados, se puede crear un script básico para iniciar una aplicación en el emulador. Los parámetros esenciales para la conexión se obtienen previamente:

• platformName: "Android"
• platformVersion: La versión de Android del emulador o dispositivo.
• deviceName: El identificador del dispositivo, obtenido con adb devices (ej. 127.0.0.1:62001).
• appPackage: El nombre del paquete de la apliccaión (ej. com.jd.app.reader).
• appActivity: La actividad principle de la aplicación (ej. com.jingdong.app.reader.logo.JdLogoActivity).

A continuación, un ejemplo de script que inicia una aplicación específica:

from appium import webdriver

configuracion = {
    "platformName": "Android",
    "platformVersion": "4.4.2",
    "deviceName": "127.0.0.1:62001",
    "appPackage": "com.jd.app.reader",
    "appActivity": "com.jingdong.app.reader.logo.JdLogoActivity"
}

controlador = webdriver.Remote('http://127.0.0.1:4723/wd/hub', configuracion)

Al ejecutar este script con el servidor de Appium activo y el emulador en funcionamiento, la aplicación objetivo debería iniciarse automáticamente en el dispositivo virtual.