Dispositivos IOS locales

Configuración de dispositivos iOS locales

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

Hay dos tipos de dispositivos iOS locales que puedes automatizar:

• Físico : un dispositivo iOS físico que puedes conectar a tu máquina local mediante un cable USB.
• Emulador : un emulador para un dispositivo iOS que se almacena localmente.

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 (recomendado para Appium 2.0):

• xcrun simctl list : enumera los dispositivos, tipos de dispositivos, tiempos de ejecución o pares de dispositivos disponibles.
• xcrun simctl list devices : enumera los dispositivos disponibles.
• xcrun simctl list devicetypes : enumera los tipos de dispositivos.
• xcrun simctl list runtimes : enumera los runtimes.
• xcrun simctl list runtimes: enumera los pares de dispositivos.

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

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

Configuración de dispositivo físico IOS

Arquitectura

Al trabajar con dispositivos físicos iOS, necesitas la siguiente infraestructura:

1. Dispositivo WindowsOS
   • UiPath Studio (hardware/software): guía de instalación
2. Dispositivo macOS
   • Servidor Appium
     • Homebrew
     • NodoJS
   • Xcode
     • Se requiere para instalar Appium Driver en un dispositivo iOS
3. Dispositivo iOS
   • WebDriver de Appium

Figura 1. Arquitectura para dispositivos físicos locales de IOS

Requisitos previos

1. macOS 13+ (Ventura o posterior)
2. ID de Apple (para Xcode y aprovisionamiento)
3. Dispositivo iOS físico (iPhone/iPad)
4. UiPath Studio 2023.10 (o posterior)
5. Cable USB para conectar el dispositivo

Configurar un dispositivo físico IOS local

1. Instala Homebrew.
   1. Abre Terminal (selecciona Command+Space).
   2. Ejecuta el siguiente comando:

      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

      Figura 2. Instalación de Homebrew: línea de comandos
      

      

      
      
   3. Si se te solicita, ejecuta el siguiente comando para añadir Homebrew a tu variable de entorno PATH :

      echo >> /Users/<username>/.zprofile
        echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
        eval "$(/opt/homebrew/bin/brew shellenv)"

   4. Verificar.

      brew -version

2. Instala Xcode y las herramientas de línea de comandos.
   • Instala Xcode a través de la App Store y ábrelo una vez.
   • Desde la Terminal, ejecuta lo siguiente:

   • 1. xcode-select –install

     2. sudo xcodebuild -license accept

     3. Verificar:

        xcodebuild -version

3. Habilita el modo Desarrollador en el dispositivo iOS.
   1. En tu iPhone o iPad, ve a Ajustes > Privacidad y seguridad > Modo desarrollador.
      Figura 3. Modo desarrollador en dispositivo IOS
      

      

      
      
   2. Activar y reiniciar.
   3. Después de reiniciar, aprueba la ventana emergente.
   4. Conéctese a través de USB y confíe en el ordenador.
      Figura 4. Habilitar la confianza del dispositivo iOS
      

      

      
      
4. Instala Node.js.
   1. Ejecuta el siguiente comando:

      brew install node

      Figura 5. Instalación de Node.js
      

      

      
      
   2. Verificar.

      node -v

      npm -v

5. Instala Appium v3.
   1. Ejecuta el siguiente comando:

      npm install -g appium@3

      Figura 6. Instalación de Appium
      

      

      
      
   2. Verificar.

      appium -v

      Figura 7. Verificación de Appium
      

      

      
      
6. Instala los controladores y complementos de Appium.
   1. Instale el controlador de iOS.

      appium driver install xcuitest

      Figura 8. Appium xcuitest
      

      

      
      
   2. (Opcional) Configurar la opción de Android.

      appium driver install uiautomator2

   3. Enumerar controladores.

      appium driver list

      Figura 9. Controladores de Appium
      

      

      
      
7. Configura WebDriverAgent.
   1. Instala Cartago.
   2. Configura WebDriverAgent.
      1. Navega a la carpeta appium-webdriveragent , utilizando la siguiente ruta: /Usetrs/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent y abre el archivo xcodeproj .
         Figura 10. Carpeta WebDriverAgent
         

         

         
         
      2. Selecciona WebDriverAgent y, en la sección Destinos , abre WebDriverAgentRunner.
         Figura 11. Ejecutor WebDriverAgent
         

         

         
         
      3. Cambie a la pestaña Firma y capacidades , seleccione Administrar firmas automáticamentey elija una cuenta de usuario en el menú desplegable Equipo .
      4. Cambia el Identificador de paquete por un valor único.
         Figura 12. Identificador del paquete WebDriverAgent
         

         

         
         
      5. Copie y guarde este Identificador de paquete, que utilizará para añadir su aplicación dentro de Mobile Device Manager (ID de paquete).
      Problema: un problema común que puedes encontrar es un certificado de desarrollador que no es de confianza. Para solucionar el problema, sigue las instrucciones de la ventana emergente.

      Figura 13. Solución de problemas de WebDriverAgent
      

      

      
      
8. Verifica el acceso al dispositivo físico.
   1. Confirma que IntegrationApp está instalada en tu dispositivo físico.
      Figura 14. IntegrationApp en dispositivo físico
      

      

      
      
   2. Ejecutar xcrun xctrace list devices.
   3. Asegúrate de que tu iPhone aparece en la lista. Si no es así, verifica el modo de desarrollador y la configuración de confianza . Necesitarás la información UDID o entre paréntesis después del nombre de tu dispositivo.
      Figura 15. Acceso al dispositivo físico
      

      

      
      
9. Inicia el servidor de Appium.
   1. Abre el terminal e introduce appium.
      Figura 16. Inicio de Appium Server
      

      

      
      
   2. Copie la URL de Appium (que se utilizará en el siguiente paso).
      Nota: No utilices la ubicación 127.
10. Conecta UiPath a Appium.
    1. Abre UiPath Studio e instala las actividades de automatización móvil.
    2. Abre Mobile Device Manager y selecciona Añadir dispositivo.
       
       
       
       
       
       
       
       

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

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 la URL de Appium que hayas copiado previamente con el siguiente formato: http://<ipaddress>:8001.
   • Plataforma : haz clic en el campo para seleccionar iOS en el menú desplegable.
   • Nombre del dispositivo: introduce el nombre del dispositivo.

   • Capacidades deseadas adicionales : agrega las siguientes capacidades:

     Nombre	Valor
     automationName	xcuitest (esta capacidad activa el controlador de Appium para iOS)
     udid	the Identifier of the connected physical iOS device

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 añadir un dispositivo local, consulta .

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

   
   

   

   
   

Automatización híbrida y web en IOS

La automatización híbrida funciona de forma predeterminada para dispositivos iOS, siempre que no intentes automatizar una aplicación creada para la producción. Al automatizar las aplicaciones de producción, el contenido alojado en WKWebView no se podrá automatizar, aunque cualquier contenido web alojado en un SF SafariViewController también se puede automatizar en las aplicaciones de producción. Para obtener más información, consulta SFSauroViewController.