Primeros pasos con las API de automatización móvil

Esta guía de inicio rápido te ayuda a crear tu primera automatización codificada, utilizando las API de automatización móvil. El tutorial utiliza la aplicación básica de Android de UiPath® y un emulador de Google Pixel de Sauce Labs para las pruebas automatizadas.

1. Añade el dispositivo móvil y la aplicación dentro de Mobile Device Manager

Para utilizar el dispositivo móvil y la aplicación deseados dentro de nuestra automatización codificada, tenemos que crearlos primero en MDM (Mobile Device Manager):

1. Para crear la aplicación:
   1. Abre MDM, y ve a Aplicaciones
   2. Selecciona Añadir una aplicación.
   3. En la ventana Editar aplicación, introduce la información necesaria:
      1. Nombre: para este ejemplo, utiliza Basic App - Android.
      2. Tipo: selecciona Aplicación para una aplicación nativa.
      3. Plataforma: selecciona Android para automatizar la aplicación Android.
      4. Aplicación: para este ejemplo, introduce el siguiente enlace a la aplicación básica de Android: https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk.
      5. Paquete de aplicación: introduce el paquete de aplicación móvil, como com.example.basicapp.
      6. Actividad de la aplicación: introducir la instancia de actividad, como: .core.MainActivity.
      7. Para capacidades adicionales deseadas, añade la capacidad appium:app, para garantizar que la aplicación funcione como se espera.

      Tabla 1. Capacidades adicionales deseadas

      Nombre	Valor
      appium:app	appium:app https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk

   
   

   

   
   
2. Para crear el dispositivo:
   1. Ve a Dispositivos y selecciona Añadir un dispositivo.
   2. Dale un nombre al dispositivo. Para este ejemplo, utiliza Google Pixel 3a GoogleAPI Emulator.
   3. Establece los siguientes parámetros: URL de Appium, Plataforma, Nombre del dispositivo, Versión de la plataforma.
      1. Recupera los parámetros del proveedor de granja de dispositivos móviles elegido. En este ejemplo, utilizamos Sauce Labs.
      2. Para obtener la URL de Appium, ve a Cuenta y luego a Configuración del usuario. Copia la URL bajo demanda en Creación de controladores.
      3. Para obtener Plataforma, Nombre del dispositivo y Versión de la plataforma, ve a Automatizado y luego Configurador de plataforma. Selecciona las capacidades para Google Pixel 3a GoogleAPI Emulator y Android Emulator version 10.0. En Script de configuración, elige tu Appium version. Para este ejemplo, utiliza 2.0.0.
      4. Copia y pega los valores de Sauce Labs en MDM.
      5. 
         

         

         
         
   4. Selecciona Guardar y cerrar.
   5. Selecciona Iniciar una aplicación en este dispositivo y conecta el dispositivo con la aplicación creada anteriormente.

2. Crea tu repositorio de objetos para la aplicación móvil

Para automatizar tu aplicación móvil preferida, graba sus elementos móviles dentro del repositorio de objetos del proyecto. Para este ejemplo, creamos una aplicación de aplicación básica con una Pantalla de inicio general, que contiene tres elementos de interfaz de usuario que utilizamos para automatizar. Consulta la siguiente lista para ver cómo aparece la estructura del repositorio de objetos:

• BasicApp
  • HomeScreen
    • EditText
    • SingleClickButton
    • VerifyText
  
  

  

  
  

3. Establecer una conexión

Después de configurar tu dispositivo y aplicación en MDM, comienza a escribir el código para tu automatización. Antes de empezar a utilizar las API de automatización móvil, debes establecer una conexión entre tu dispositivo móvil y la aplicación elegida, utilizando las API correspondientes.

Una connection es una clase que representa la conexión que creas entre un dispositivo y una aplicación, que expone las API que puedes utilizar para automatizar escenarios de prueba móviles. Consulta Conexión para obtener más información sobre la creación de una connection.

Para crear una conexión, tienes un conjunto de API dedicadas que puedes utilizar. En este ejemplo, utilizamos la API de Connect, con la segunda sobrecarga, que requiere los nombres de dispositivo y aplicación como cadenas.

Crea la conexión utilizando los siguientes pasos:

1. Comienza con una declaración using, para evitar crear una variable independiente.
2. Dentro de la declaración using, llama a la API de Connect, con la segunda versión de sobrecarga.

   Para esta sobrecarga, introduce el nombre del dispositivo y el nombre de la aplicación, para establecer la conexión.

   [TestCase]
           public void Execute()
           {
           using (Connection connection = mobile.Connect(
               "Google Pixel 3a GoogleAPI Emulator", 
               "Basic App - Android"))

3. Opcionalmente, para fines de depuración, puedes añadir un mensaje Log.

   Log("Connection established");

4. Empieza a automatizar la aplicación móvil y el dispositivo

El flujo de automatización en este ejemplo incluye tocar ciertos botones, obtener texto que se muestra en la pantalla del móvil y deslizar un control deslizante. Estas acciones simulan escenarios de automatización móvil de la vida real.

Para automatizar los elementos de la interfaz de usuario en este ejemplo, utilizamos IElementDescriptors. Estos representan elementos de interfaz de usuario a los que se accede directamente desde el repositorio de objetos. Además de IElementDescriptors, puedes utilizar otros tipos de selectores con las API de automatización móvil, como ObjectRepositoryTarget y SelectorTarget. Consulta Selectores de API para aprender cómo y cuándo utilizar otros tipos de selectores.

1. Llama a la API Tap para hacer clic en SingleClickButton desde la aplicación básica de Android.

   // Tap the SingleClickButton
               connection.Tap(Descriptors.BasicApp.HomeScreen.SingleClickButton);
               Log("Tapped SingleClickButton ");

2. Utiliza la API de SetText para introducir un texto específico en el campo EditText.

   string expectText = "Random text";
               connection.SetText(Descriptors.BasicApp.HomeScreen.EditText, expectText);
               Log("Inserted random text");

3. Obtén el texto que estableciste anteriormente y verifica si coincide con el texto del elemento de IU VerifyText. Utiliza las API de GetText y VerifyExpression.

   var actualText = connection.GetText(Descriptors.BasicApp.HomeScreen.VerifyText);
               testing.VerifyExpression(expectText == actualText, "EditText validation failed.");
               SelectorTarget selector = null;

4. Utiliza la API de PositionalSwipe para mover el control deslizante.
   La API de PositionalSwipe requiere dos variables Point, que representan los puntos de inicio y final para la acción de deslizamiento. Crea estos puntos antes de utilizar la API para mejorar la legibilidad.

   // Perform a positional swipe operation to use the slider
   
               var startPoint = new Point(226, 304);
               var endPoint = new Point(296, 304);
               
               connection.PositionalSwipe(startPoint, endPoint);
   
               Log("Performed Swipe action.");

   Para obtener la posición de la pantalla, ve a la conexión activa en MDM. Pasa el cursor sobre la pantalla del móvil. Esto mostrará la ubicación del cursor en píxeles en la esquina inferior izquierda del MDM.

   
   

   

   
   

Muestra de flujo de trabajo

Para seguir los pasos en esta guía de inicio rápido o para probarlo tú mismo, descarga la muestra de inicio rápido de las API de automatización móvil.