Test Suite

2023.4

False

Guía de usuario de Test Suite

Última actualización 28 de feb. de 2024

Dispositivos Android locales

Configuración de dispositivos Android locales

Para configurar un dispositivo local que funcione con las actividades de automatización móvil, debes ejecutar una instancia local de Appium y tener las herramientas necesarias para automatizar los dispositivos Android.

Hay dos tipos de dispositivos Android locales que puede automatizar:

Físico: un dispositivo Android físico que puedes conectar a tu máquina local, a través de un cable USB.
Emulador: un emulador de un dispositivo Android que se almacena de forma local.

Comandos de Appium más utilizados

La siguiente lista describe los comandos más utilizados para configurar Appium en el contexto de la automatización de dispositivos móviles:

appium driver list : enumera los controladores instalados (recomendado para Appium 2.0)
adb devices : enumera los dispositivos conectados
adb start-server: inicia la depuración del servidor
adb kill-server : detiene el servidor de depuración
ctrl + c : elimina Appium
appium-doctor : ayuda a depurar su Appium.

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.

Configurar dispositivo Android físico local

Requisitos previos

Siga los pasos a continuación para completar los requisitos previos para configurar un dispositivo Android físico local:

Descarga e instala Java. Puedes descargar Java a través de un archivo zip aquí.
Descarga e instala Node.js. Puedes descargar la versión más reciente de Node.js aquí.
Una vez finalizada la instalación de Node.js , abra un símbolo del sistema y verifique si se realizó correctamente, usando los siguientes comandos:
- node-v : devuelve la versión de Node.js instalada en tu máquina. La versión devuelta debe ser igual o superior a 19.
- npm-v: devuelve la versión de npm instalada en tu máquina. La versión devuelta debe ser igual o superior a 8.
Descarga e instala Android Studio. Puedes descargar Android Studio aquí.
Instale las herramientas del SDK de Android (obsoleto) con Android Studio.
En Windows, ve a Configuración avanzada del sistema > Avanzado > Variables de entorno.
En Variables del sistema, haz clic en Nuevo y configura las siguientes variables:

a. Variable JAVA_HOME . Apunta a la carpeta donde se instaló Java.

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.

b. Variable ANDROID_HOME . Apunta a la carpeta donde se instaló Android SDK.

Nombre de la variable: ANDROID_HOME Valor de la variable: la ruta de acceso en la que se encuentra el SDK de Android en su máquina. Por ejemplo: 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.

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

Abre el símbolo del sistema de Node.js e instala Appium:
- Para Appium 1.0, ejecuta el siguiente comando: npm install -g appium. Appium 1.0 viene con todos los controladores instalados.
- Para Appium 2.0, ejecuta el siguiente comando: npm install -g appium@next.

Appium 2.0 viene sin los controladores instalados. Por tanto, para instalar los controladores necesarios, ejecuta también el siguiente comando:

appium driver install
                           uiautomator2

Para obtener más información sobre la configuración de Appium 1.0, consulta Introducción de inicio rápido.

Nota: recomendamos utilizar Appium 2.0 con la versión 22.10 o superior de Mobile Automation.

Reinicie el equipo para aplicar los cambios.
Abre el dispositivo móvil físico y habilita las Opciones de desarrollador.
- En tu teléfono, ve a Configuración > Opciones de desarrollador.
- En la sección Redes , abra la Configuración de USB predeterminada y establézcala como Solo para cargar el teléfono.
Habilita la depuración de USB.
En tu teléfono, ve a Configuración > Opciones de desarrollador.
En la sección Redes , abra la Configuración de USB predeterminada y establézcala como Solo para cargar el teléfono.

Configurar dispositivo Android físico local

Conecta el dispositivo físico a la máquina local mediante un cable USB.
Abre un símbolo del sistema e inicia el servidor de depuración con el siguiente comando: adb.exe start-server.
Permita la depuración de USB en el dispositivo móvil (si se le pide que lo permita).
Agrega manualmente el parámetro the --base-path /wd/hub antes de iniciar la sesión de Appium.
Inicia el servidor de Appium, utilizando el comando siguiente: appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload.
Nota:
- Si la descarga automática falla, puede apuntar a un chromedriver.exeya descargado, concatenando el siguiente comando:
--chromedriver-executable "path_to_chromedriver"
- Asegúrese de dejar la conexión del servidor de Appium funcionando sin ninguna interferencia. Por ejemplo, si hace clic dentro del terminal, se corta la comunicación, lo que puede provocar un error de comunicación en Mobile Device Manager.
Añade el dispositivo configurado Android físico local en Mobile Device Manager, utilizando el procedimiento Añadir dispositivo Android local en Mobile Device Manager.

Configurar un dispositivo emulado Android local

Requisitos previos

Descarga e instala Java. Puedes descargar Java a través de un archivo zip aquí.
Descarga e instala Node.js. Puedes descargar la versión más reciente de Node.js aquí.
Una vez finalizada la instalación de Node.js , abra un símbolo del sistema y verifique si se realizó correctamente, usando los siguientes comandos:
- node-v : devuelve la versión de Node.js instalada en tu máquina. La versión devuelta debe ser igual o superior a 19.
- npm-v: devuelve la versión de npm instalada en tu máquina. La versión devuelta debe ser igual o superior a 8.
Descarga e instala Android Studio. Puedes descargar Android Studio aquí.
En Windows, ve a Configuración avanzada del sistema > Avanzado > Variables de entorno.
En Variables del sistema, haz clic en Nuevo y configura las siguientes variables:

a. Variable JAVA_HOME . Apunta a la carpeta donde se instaló Java.

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.

b. Variable ANDROID_HOME . Apunta a la carpeta donde se instaló Android SDK.

Nombre de la variable: ANDROID_HOME
Valor de la variable: la ruta donde se encuentra el SDK de Android en tu máquina. Por ejemplo: C:\Users\Username\AppData\Local\Android\Sdk

Nota: La parte Username , dentro de la ruta del valor de la variable , debe reemplazarse por el nombre real del usuario que opera en la máquina.
1. Abre el símbolo del sistema de Node.js e instala Appium:
Para Appium 1.0, ejecuta el siguiente comando: npm install -g appium. Appium 1.0 viene con todos los controladores instalados.
Para Appium 2.0, ejecuta el siguiente comando: npm install -g appium@next.

Appium 2.0-beta viene sin controladores instalados. Por lo tanto, para instalar los controladores necesarios, ejecuta también el comando siguiente: appium driver install uiautomator2.

Para obtener más información sobre la configuración de Appium 2.0, consulta Introducción de inicio rápido.

Nota: recomendamos utilizar Appium 2.0 con la versión 22.10 o superior de Mobile Automation.

Reinicie el equipo para aplicar los cambios.

Creación de un emulador de Android

Cree su emulador de Android con Android Studio.

Abre Android Studio.
Haz clic en Configurar y selecciona SDK Manager en el menú desplegable.
Desmarque Ocultar paquetes obsoletos y asegúrese de que Herramientas del SDK de Android (obsoletas) esté seleccionado.
Haga clic en Aplicar y luego en Aceptar para cerrar.
Navega hasta Configurar > AVD Manager para configurar un dispositivo virtual. Para obtener más información, consulta Crear y gestionar dispositivos virtuales.
Actualice las aplicaciones de Google de su dispositivo.

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

Habilita la depuración de WebView en el dispositivo local para permitir que Mobile Device Manager reconozca la mayoría de los elementos de la IU dentro de una aplicación.

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

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.
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. Descarga WebDriver para Chrome y ten en cuenta 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.
Añade el dispositivo configurado Android emulado local en Mobile Device Manager, utilizando el procedimiento Añadir dispositivo Android local en Mobile Device Manager.

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

Abre MDM desde Studio.
En el panel de navegación izquierdo ve a Dispositivos.

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.

Importante: para activar los controladores de Appium instalados previamente, agrega la siguiente capacidad a la sección Capacidades deseadas adicionales :

Nombre	Valor
`appium:automationName`	`UiAutomator2`

Para obtener más información, consulta Capacidades deseadas de Appium.

(Opcional): configura la ubicación de tu dispositivo en la pestaña Ubicación para probar las aplicaciones que utilizan los servicios de ubicación para generar datos de ubicación.
(Opcional) Configura los detalles de registro y grabación de vídeo en la pestaña Registro.
(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.
Haz clic en Guardar y Cerrar para agregar tu dispositivo.

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