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:

• Physical - a physical Android device that you can connect to your local machine, through a USB cable.
• Emulator - an emulator for an Android device that's stored locally.

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 - lists installed drivers (recommended for 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:

1. Descarga e instala Java. Puedes descargar Java a través de un archivo zip aquí.

2. Descarga e instala Node.js. Puedes descargar la última versión de Node.js aquí.

3. After the installation of Node.js is finished, open a command prompt and check if it was successful, using the following commands:

   • node-v - returns the Node.js version installed on your machine. The version returned needs to be equal to, or higher than 19.
   • npm-v - returns the version of npm installed on your machine. The version returned needs to be equal to, or higher than 8.

4. Descarga e instala Android Studio. Puedes descargar Android Studio aquí.

5. Install Android SDK Tools (Obsolete) using Android Studio.

6. In Windows, navigate to Advanced system settings > Advanced > Environment Variables.

7. Under System variables click New and configure the following variables:

   1. Variable JAVA_HOME . Apunta a la carpeta donde se instaló Java. Nombre de la variable: JAVA_HOME. Valor de variable: la ruta donde se encuentra el JDK en tu máquina. Por ejemplo: C:\Program Files\Java\jdk8.

   2. Variable ANDROID_HOME . Apunta a la carpeta donde se instaló el SDK de Android. 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 de Valor de variable , debe reemplazarse por el nombre real del usuario que opera en la máquina.

      Importante:

      If Java is updated automatically, you need to manually configure this variable with the updated path.

1. Open the Node.js command prompt and install Appium:
   • For Appium 1.0, run the following command: npm install -g appium. Appium 1.0 comes with all drivers installed.
   • For Appium 2.0, run the following command: npm install -g appium@next.

Appium 2.0 comes without the drivers installed. Therefore, to install the needed drivers, also run the following command: 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:

We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.

1. Reinicie el equipo para aplicar los cambios.
2. Open the physical mobile device, and enable Developer Options.
   • On your phone, navigate to Settings > Developer Options.
   • Under the Networking section, open Default USB configuration and set it to Charging phone only.
3. Enable USB debugging.
4. On your phone, navigate to Settings > Developer Options.
5. Under the Networking section, open Default USB configuration and set it to Charging phone only.

Configurar dispositivo Android físico local

1. Conecta el dispositivo físico a la máquina local mediante un cable USB.

2. Abre un símbolo del sistema e inicia el servidor de depuración con el siguiente comando: adb.exe start-server.

3. Allow USB debugging on the mobile device (if you're asked to allow it).

4. Agrega manualmente el parámetro the --base-path /wd/hub antes de iniciar la sesión de Appium.

5. Start the Appium server, using the following command: appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload.

   Nota:

   • If the auto-download fails, you can point to an already downloaded chromedriver.exe, by concatenating the following command:

     --chromedriver-executable "path\_to\_chromedriver"

   • Make sure to leave the Appium server connection running without any interferences. For example, if you click within the terminal, the communication is cut off, which may lead to a communication error in Mobile Device Manager.

6. Añade el dispositivo Android físico local configurado en Mobile Device Manager, utilizando el procedimiento Añadir dispositivo Android local en Mobile Device Manager .

Configurar un dispositivo emulado Android local

Requisitos previos

1. Descarga e instala Java. Puedes descargar Java a través de un archivo zip aquí.

2. Descarga e instala Node.js. Puedes descargar la última versión de Node.js aquí.

3. After the installation of Node.js is finished, open a command prompt and check if it was successful, using the following commands:

   • node-v - returns the Node.js version installed on your machine. The version returned needs to be equal to, or higher than 19.
   • npm-v - returns the version of npm installed on your machine. The version returned needs to be equal to, or higher than 8.

4. Descarga e instala Android Studio. Puedes descargar Android Studio aquí.

5. In Windows, navigate to Advanced system settings > Advanced > Environment Variables.

6. Under System variables click New and configure the following variables:

   1. Variable JAVA_HOME . Apunta a la carpeta donde se instaló Java. Nombre de la variable: JAVA_HOME. Valor de variable: la ruta donde se encuentra el JDK en tu máquina. Por ejemplo: C:\Program Files\Java\jdk8.

   2. Variable ANDROID_HOME . Apunta a la carpeta donde se instaló el SDK de Android.

      • Variable name: ANDROID_HOME
      • Variable value: the path where the Android SDK is located on your machine. For example: 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. Open the Node.js command prompt and install Appium:

         • For Appium 1.0, run the following command: npm install -g appium. Appium 1.0 comes with all drivers installed.
         • For Appium 2.0, run the following command: npm install -g appium@next.

         Appium 2.0-beta comes without the drivers installed. Therefore, to install the needed drivers, also run the following command: 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:

         We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.

         1. Reinicie el equipo para aplicar los cambios.

Creación de un emulador de Android

Create your Android emulator using Android Studio.

1. Abre Android Studio.

2. Click Configure and select SDK Manager from the dropdown.

3. Uncheck Hide Obsolete Packages and make sure that Android SDK Tools (Obsolete) is selected.

   

4. Click Apply and then Ok to close.

5. Ve a Configurar > AVD Manager para configurar un dispositivo virtual. Para obtener más información, consulta Crear y gestionar dispositivos virtuales.

   

6. Actualice las aplicaciones de Google de su dispositivo.

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

Habilite la depuración de WebView en el dispositivo local para permitir que Mobile Device Manager reconozca la mayoría de los elementos de la interfaz de usuario 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:

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:
   1. Open your device in Android Studio.
   2. Ve a Configuración > Aplicaciones y notificaciones. 3 Haz clic en Ver todas las aplicaciones.
   3. Click the vertical ellipsis button and select Show system from the dropdown.
   4. Use the search function to look for Android System WebView.
   5. Open the app and go to Advanced.
   6. Copy the version number at the bottom of the screen.
   7. 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.
3. Añade el dispositivo emulado local configurado 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

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.

   • Appium URL - Enter the localhost. For example: http://localhost:10001/wd/hub.

   • Platform - Click the field to select Android from the dropdown.

   • Device Name - Enter the device name. One way to see that is through Android Studio if you navigate to Configure > AVD Manager, and then go to More Actions > View Details.

   • Versión de plataforma: agrega el número de versión de tu sistema operativo Android.

   • Additional Desired Capabilities (Optional) - Add specific capabilities to customize your automation session.

     Importante:

     Para activar los controladores Appium instalados anteriormente, añade la siguiente capacidad a la sección Capacidades adicionales deseadas :

     Nombre	Valor
     appium:automationName	UiAutomator2

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

4. (Optional) - Set your device location in the Location tab, to test applications that use Location Services to generate location data.

   

5. (Opcional) Configura los detalles de registro y grabación de vídeo en la pestaña Registro.

6. (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.

7. 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 .