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

When working with iOS Physical Devices, you require the following infrastructure:

1. WindowsOS Device
   • UiPath Studio (Hardware/Software) – installation guide
2. macOS Device
   • Appium Server
     • Homebrew
     • NodeJS
   • Xcode
     • Required to install Appium Driver on iOS device
3. iOS Device
   • Appium WebDriver

Figure 1. Architecture for IOS Local Physical Devices

Requisitos previos

1. macOS 13+ (Ventura or later)
2. Apple ID (for Xcode and provisioning)
3. Physical iOS device (iPhone/iPad)
4. UiPath Studio 2023.10 (or higher)
5. USB cable to connect the device

Configuring Local Physical iOS Device

1. Install Homebrew.
   1. Open Terminal (select Command+Space).
   2. Ejecuta el siguiente comando:

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

      Figure 2. Homebrew installation - command line
      

      

      
      
   3. If prompted, run the following command to add Homebrew to your PATH environment variable:

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

   4. Verify.

      brew -version

2. Install Xcode and Command Line Tools.
   • Install Xcode via App Store and open it once.
   • From Terminal, run the following:

   • 1. xcode-select –install

     2. sudo xcodebuild -license accept

     3. Verify:

        xcodebuild -version

3. Enable Developer mode on iOS Device.
   1. On your iPhone or iPad, go to Settings > Privacy & Security > Developer Mode.
      Figure 3. Developer mode on IOS device
      

      

      
      
   2. Toggle on and restart.
   3. After restart, approve the popup.
   4. Connect via USB and trust the computer.
      Figure 4. Enable iOS device trust
      

      

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

      brew install node

      Figure 5. Node.js installation
      

      

      
      
   2. Verify.

      node -v

      npm -v

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

      npm install -g appium@3

      Figure 6. Appium installation
      

      

      
      
   2. Verify.

      appium -v

      Figure 7. Appium verification
      

      

      
      
6. Install Appium Drivers and Plugins.
   1. Install iOS driver.

      appium driver install xcuitest

      Figure 8. Appium xcuitest
      

      

      
      
   2. (Optional) Configure Android option.

      appium driver install uiautomator2

   3. List drivers.

      appium driver list

      Figure 9. Appium drivers
      

      

      
      
7. Set up WebDriverAgent.
   1. Install Carthage.
   2. Set up WebDriverAgent.
      1. Navigate to the appium-webdriveragent folder, using the following path: /Usetrs/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent, and open the xcodeproj file.
         Figure 10. WebDriverAgent folder
         

         

         
         
      2. Select WebDriverAgent, and, under the Targets section, open WebDriverAgentRunner.
         Figure 11. WebDriverAgent runner
         

         

         
         
      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.
         Figure 12. WebDriverAgent Bundle Identifier
         

         

         
         
      5. Copy and save this Bundle Identifier, which you will use to add your Application inside Mobile Device Manager (Bundle Id).
      Trouble: A common issue that you may encounter is an Untrusted Developer Certificate. To fix the issue, follow the instructions oin the popup.

      Figure 13. WebDriverAgent troubleshooting
      

      

      
      
8. Verify Physical Device access.
   1. Confirm that the IntegrationApp is installed on your physical device.
      Figure 14. IntegrationApp on physical device
      

      

      
      
   2. Ejecutar xcrun xctrace list devices.
   3. Ensure your iPhone appears in the list. If not, verify Developer Mode and Trust settings. You will need the UDID or information in the parenthesis after your device name.
      Figure 15. Physical device access
      

      

      
      
9. Start the Appium Server.
   1. Open the terminal and enter appium.
      Figure 16. Appium Server start
      

      

      
      
   2. Copy the appium url (to be used in next step).
      Note: Do not use the 127 location.
10. Connect UiPath to Appium.
    1. Open UiPath Studio and install Mobile Automation Activities.
    2. Open Mobile Device Manager, and select Add device.
       
       
       
       
       
       
       
       

Add the configurated local physical iOS device in Mobile Device Manager, using the Adding iOS Device in Mobile Device Manager procedure.

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.