Local Devices

Información general

Para configurar un dispositivo local que funcione con las actividades de automatización móvil, ya sea un dispositivo físico o un emulador, debe ejecutar una instancia local de Appium y tener las herramientas necesarias para automatizar los dispositivos Android o iOS.

Secciones de tema:

• Almacenamiento de aplicaciones
• Configuración de dispositivo Android
• Configuración de dispositivo iOS

Almacenamiento de aplicaciones

Deberá almacenar sus aplicaciones móviles en la misma máquina en la que se ejecuta su servidor Appium, o cargar el archivo APK o IPA a una URL que sea accesible de forma anónima por el servidor de Appium (p. Ej. Almacenamiento de blobs).

No es posible instalar aplicaciones desde Play Store o App Store, excepto si automatizas manualmente estas aplicaciones para instalar tu aplicación específica.

Configuración de dispositivo Android

Para configurar un dispositivo Android local, debes preparar tu entorno y añadirlo a Mobile Device Manager.

Temas de esta sección:

• Preparación del entorno de Android
• Inicio del servidor de Appium
• Creación de un emulador de Android
• Habilitar la automatización web e híbrida con WebDriver
• Configurar dispositivo físico Android
• Agregar dispositivo Android local en el Administrador de dispositivos móviles

Preparación del entorno de Android

Preparar y configurar su entorno.

1. Descarga e instala Node.js.
2. Abre el símbolo del sistema de Node.js y ejecuta el siguiente comando para instalar Appium:

   npm install -g appium

   Para obtener más información sobre la configuración de Appium, consulta Primeros pasos de Appium.

3. En Windows, ve a Configuración avanzada del sistema > Avanzado > Variables de entorno
4. En Variables del sistema, haz clic en Nuevo y configura las siguientes variables:

   a. Variable ANDROID_HOME .

Nombre de la variable: ANDROID_HOME Valor de la variable: C:\Users\Username\AppData\Local\Android\Sdk Nota: La parte Username , dentro de la ruta del valor de la variable , debe reemplazarse con el nombre real del usuario que opera en la máquina.

b. Variable JAVA_HOME . Necesita tener Java ya instalado para configurar esta variable. Puede descargar Java a través de un archivo zip aquí.

Nombre de variable: JAVA_HOME.

Valor de la variable: la ruta en la que se encuentra el JDK en tu máquina. Por ejemplo: C:\Program Files\Java\jdk8.

Importante: si Java se actualiza automáticamente, deberás configurar manualmente esta variable con la ruta actualizada.

c. Haz clic en Aceptar para confirmar.

1. Edite la variable Ruta para que su usuario incluya Android Debug Bridge (ADB):

   a. Haz clic en Nuevo y agrega el siguiente valor:

   %ANDROID_HOME%\platform-tools

   b. Haz clic en Aceptar para confirmar.

2. Haga clic en Aceptar para establecer la variable.

   
   

   

   
   

Inicio del servidor de Appium

Antes de iniciar cualquier aplicación en su dispositivo, debe iniciar un servidor Appium en su máquina. Abre el símbolo del sistema y ejecuta Appium con los siguientes parámetros:

appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

Nota:

• Si la descarga automática falla, puede apuntar a un chromedriver.exe ya descargado, concatenando el siguiente comando:

--chromedriver-executable "path_to_chromedriver"

• Para obtener ayuda con la depuración de Appium, ejecuta el siguiente comando:

appium-doctor

• Para cancelar Appium, use el comando ctrl + c .

Creación de un emulador de Android

Cree sus emuladores de Android con Android Studio.

1. Descarga e instala Android Studio.
2. Abre Android Studio.
3. Haz clic en Configurar y selecciona SDK Manager en el menú desplegable.
4. Desmarque Ocultar paquetes obsoletos y asegúrese de que Herramientas del SDK de Android (obsoletas) esté seleccionado.
   
   

   

   
   
5. Haga clic en Aplicar y luego en Aceptar para cerrar.
6. Vaya a Configurar > AVD Manager para configurar un dispositivo virtual. Para obtener más información, consulta Crear y gestionar dispositivos virtuales.
   
   

   

   
   
7. Actualice las aplicaciones de Google de su dispositivo.

Habilitar la automatización web e híbrida con WebDriver

Habilita la depuración de WebView.

Si Appium no detecta automáticamente la versión de Chrome o WebView en su Android, elija una de las siguientes opciones:

1. Utiliza el comando --allow-insecure chromedriver_autodownload . Esto permite que Appium detecte y descargue automáticamente la versión de ChromeDriver que corresponde a su entorno.
2. Especifique y descargue manualmente WebDriver para Chrome:

   2.1. Abra su dispositivo en Android Studio.

   2.2. Ve a Configuración > Aplicaciones y notificaciones.

   2.3 Haz clic en Ver todas las aplicaciones.

   2.4. Haga clic en el botón de puntos suspensivos verticales y seleccione Mostrar sistema en el menú desplegable.

   2.5. Utilice la función de búsqueda para buscar WebView del sistema Android.

   2.6. Abre la aplicación y ve a Avanzado.

   27 Copie el número de versión en la parte inferior de la pantalla.

   2.8. Descargue WebDriver para Chrome y considere lo siguiente:

   • Selecciona la versión que corresponde a la versión de Webview del sistema Android del paso anterior y extraela a una carpeta.
   • Está buscando una coincidencia exacta para la versión (major.minor.patch.revision).
   • En caso de que no haya una coincidencia exacta disponible, use la última versión principal de ChromeDriver que coincida con la versión principal de la vista web del sistema Android.
   • Si desea automatizar la aplicación Chrome, realice los mismos pasos anteriores y tome una nota de la versión de Chrome.

Configurar dispositivo físico Android

1. Descarga e instala Android Studio.
2. Abre Android Studio.
3. Haz clic en Configurar y selecciona SDK Manager en el menú desplegable.
4. Desmarque Ocultar paquetes obsoletos y asegúrese de que Herramientas del SDK de Android (obsoletas) esté seleccionado.
5. Haga clic en Aplicar y luego en Aceptar para cerrar.
6. Abra una línea de comandos y ejecute el siguiente comando para iniciar un servidor de depuración:

   %LOCALAPPDATA%\\Android\\Sdk\\platform-tools\\adb.exe start-server

7. Conecta tu dispositivo a la máquina mediante un cable.
8. Habilite las opciones de desarrollador y la depuración de USB en su dispositivo. Para obtener más información, consulta Configurar opciones de desarrollador en el dispositivo.
9. En tu teléfono, ve a Configuración > Opciones de desarrollador.
10. En la sección Redes , abra la Configuración de USB predeterminada y establézcala como Solo para cargar el teléfono.
11. Añade tu dispositivo al Mobile Device Manager.
12. Ejecuta el siguiente comando para iniciar un servidor de Appium:

    appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

    Para parámetros adicionales, consulta Iniciar Appium Server.

    Nota: Asegúrate de dejar la conexión al servidor de Appium funcionando sin interferencias. Por ejemplo, si haces clic dentro del terminal, se cortará la comunicación, lo que puede provocar un error de comunicación en el Mobile Device Manager.

Agregar dispositivo Android local en el Administrador de dispositivos móviles

1. Abre MDM desde Studio.
2. En el panel de navegación izquierdo ve a Dispositivos.
3. Configura tu dispositivo de la siguiente manera:
   • Nombre: introduce un nombre para identificar tu dispositivo en la pestaña Dispositivos.
   • URL de Appium : introduce el host local. Por ejemplo: http://localhost:10001/wd/hub.
   • Plataforma: haz clic en el campo para seleccionar Android o iOS en el menú desplegable.
   • Nombre del dispositivo : escribe el nombre del dispositivo. Una forma de verlo es a través de Android Studio si navegas a Configurar > AVD Managery luego a Más acciones > Ver detalles.
   • Versión de plataforma: agrega el número de versión de tu sistema operativo Android.
   • Capacidades deseadas adicionales (Opcional): agrega capacidades específicas para personalizar tu sesión de automatización. Para obtener más información, consulta Capacidades deseadas de Appium.
   • Establecer ubicación geográfica (Opcional): establece la ubicación del dispositivo para probar las aplicaciones que utilizan los servicios de ubicación para generar datos de ubicación.
4. (Opcional) Configura los detalles de registro y grabación de vídeo en la pestaña Registro.
5. (Opcional) Configura tu proceso de desarrollo en la pestaña Desarrollo.
   • Cerrar pestañas similares (activadas de forma predeterminada): cierra las pestañas que ejecutan conexiones con dispositivos y aplicaciones similares.
   • Esperar a la actualización de la página (activada de forma predeterminada): espera a que la página de origen recupere una captura de pantalla de cada acción.
6. Haz clic en Guardar y Cerrar para agregar tu dispositivo.

   Tu dispositivo se añade a la lista Dispositivos. Para agregar un dispositivo local, consulta Dispositivos locales.

   
   

   

   
   

Configuración de dispositivo iOS

Para configurar un dispositivo iOS, simulador o dispositivo físico local y automatizar una aplicación, tendrás que configurar el servidor de Appium en una máquina macOS.

Importante:

Si el artefacto de su aplicación usa la extensión APP y desea cargar la aplicación en una URL pública, deberá crear una carpeta llamada Payload, colocar el APP dentro, archivar la carpeta Payload y cambiar la extensión a IPA en lugar de ZIP.

Además, asegúrese de que la aplicación que intenta automatizar esté compilada para la arquitectura de destino (simulador o dispositivo físico).

Temas de esta sección:

• Preparación del entorno macOS
• Configuración de dispositivo físico iOS
• Agregar dispositivo iOS local en el Administrador de dispositivos móviles

Preparación del entorno MacOS

1. Instala Xcode.
2. Abra una Terminal y ejecute el siguiente comando para instalar Homebrew:

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Ejecuta el siguiente comando para instalar NodeJS:

   brew install node

4. Instalar Appium:

   npm install -g appium

5. Abre Xcode y deja que instale los componentes adicionales que pueda requerir. Ciérrelo una vez que vea la pantalla de inicio.
6. Ejecuta el siguiente comando para iniciar Appium:

   appium --port 10001

7. Usa la búsqueda en Foco de luz (⌘-Espacio) para abrir la Utilidad de red.
8. Copia la dirección IP para su uso posterior cuando añadas un dispositivo iOS a MDM. Esto se incluirá en la URL de Appium (por ejemplo http://<ipaddress>:8001/wd/hub)
   
   

   

   
   

Configuración de dispositivo físico IOS

Si desea utilizar las actividades de automatización móvil con un dispositivo iOS físico, necesitará una cuenta de desarrollador de Apple.

1. Siga los pasos 1-5 de Preparación del entorno macOS
2. Conecta tu dispositivo físico a tu Mac.
3. Desbloquee su dispositivo y, si aparece una alerta, asegúrese de permitir que la computadora acceda a él.
4. Abra una Terminal y ejecute el siguiente comando:

   instruments -s devices

5. Copia tu ID de dispositivo para usarlo más adelante, cuando agregues tu dispositivo en MDM. Por ejemplo, el ID del dispositivo se añadirá como una capacidad udid :

   Known Devices: Username's iPhone (13.5.1) (<deviceID>)

6. Inicie sesión en su cuenta de desarrollador de Apple y vaya a Membresía.
7. Copia tu ID de equipo para usarla más adelante, cuando agregues tu dispositivo en MDM. Tu ID de equipo deberá añadirse a las capacidades del dispositivo con el nombre xcodeOrgId.
8. Abre Xcode y ve a Preferencias > Cuentas.
9. Añade tu cuenta de desarrollador de Apple.

Agregar dispositivo IOS local en el Administrador de dispositivos móviles

1. Abra el Administrador de dispositivos móviles desde Studio.
2. En el panel de navegación izquierdo ve a Dispositivos.
3. Configura tu dispositivo de la siguiente manera:
   • Nombre: introduce un nombre para identificar tu dispositivo en la pestaña Dispositivos.
   • URL de Appium : introduce el host local. Por ejemplo: http://<ipaddress>:8001/wd/hub.
   • Plataforma : haz clic en el campo para seleccionar iOS en el menú desplegable.
   • Nombre del dispositivo: introduce el nombre del dispositivo.
   • Capacidades deseadas adicionales(dispositivos físicos): añade udid y xcodeOrgId. Para obtener más información, consulte Configurar dispositivo físico iOS
   • Establecer ubicación geográfica (Opcional): establece la ubicación del dispositivo para probar las aplicaciones que utilizan los servicios de ubicación para generar datos de ubicación.
4. (Opcional) Configura los detalles de registro y grabación de vídeo en la pestaña Registro.
5. (Opcional) Configura tu proceso de desarrollo en la pestaña Desarrollo.
   • Cerrar pestañas similares (activadas de forma predeterminada): cierra las pestañas que ejecutan conexiones con dispositivos y aplicaciones similares.
   • Esperar a la actualización de la página (activada de forma predeterminada): espera a que la página de origen recupere una captura de pantalla de cada acción.
6. Haz clic en Guardar y Cerrar para agregar tu dispositivo.

   Tu dispositivo se añade a la lista Dispositivos. Para agregar un dispositivo local, consulta Dispositivos locales.

   Si no puedes iniciar el dispositivo, consulta Solución de problemas: el dispositivo físico no se inicia.