Dispositivos IOS locais

Configurando dispositivos iOS locais

Para configurar um dispositivo local para funcionar com as atividades de Automação móvel, você precisa executar uma instância local do Appium e ter as ferramentas necessárias para automatizar dispositivos iOS.

Há dois tipos de dispositivos iOS locais que você pode automatizar:

• Físico - um dispositivo iOS físico que você pode conectar à sua máquina local por meio de um cabo USB.
• Emulador - um emulador para um dispositivo iOS armazenado localmente.

Comandos Appium mais usados

A lista abaixo descreve os comandos mais usados para configurar o Appium no contexto de Mobile Device Automation (recomendado para Appium 2.0):

• xcrun simctl list - Listar dispositivos disponíveis, tipos de dispositivos, tempos de execução ou pares de dispositivos.
• xcrun simctl list devices - lista os dispositivos disponíveis.
• xcrun simctl list devicetypes - lista os tipos de dispositivos.
• xcrun simctl list runtimes - lista os tempos de execução.
• xcrun simctl list runtimes - lista os pares de dispositivos.

Armazenamento de aplicativos

Você precisará armazenar seus aplicativos móveis na mesma máquina em que seu servidor Appium está em execução ou fazer upload do arquivo IPA para um URL que seja acessível anonimamente pelo servidor Appium (por exemplo, armazenamento de blobs).

Não é possível instalar aplicativos da Play Store ou App Store, exceto se você automatizar manualmente esses aplicativos para instalar seu aplicativo específico.

Importante:

Se o artefato do seu aplicativo usar a extensão APP e você quiser fazer upload do aplicativo para um URL público, será necessário criar uma pasta chamada Payload, colocar o APP dentro dela, arquivar a pasta Payload e alterar a extensão para IPA em vez de ZIP.

Além disso, certifique-se de que o aplicativo que você está tentando automatizar seja compilado para a arquitetura de destino (simulador ou dispositivo físico).

Configurando o Dispositivo Físico IOS

Arquitetura

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

Pré-requisitos

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. Execute o seguinte 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. Execute o seguinte comando:

      brew install node

      Figure 5. Node.js installation
      

      

      
      
   2. Verify.

      node -v

      npm -v

5. Install Appium v3.
   1. Execute o seguinte 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. Alterne para a guia Assinatura e recursos , selecione Gerenciar automaticamente a assinaturae escolha uma conta de usuário no menu suspenso Equipe .
      4. Altere o identificador de pacote para um valor exclusivo.
         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. Execute 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.

Adicionando dispositivo IOS local no Gerenciador de dispositivos móveis

1. Abra o Gerenciador de dispositivos móveis do Studio.
2. No painel de navegação à esquerda, acesse Dispositivos.
3. Configure seu dispositivo da seguinte forma:
   • Nome — insira um nome para identificar seu dispositivo na aba Dispositivos.
   • URL do Appium - Insira o URL do Appium que você copiou anteriormente, usando o seguinte formato: http://<ipaddress>:8001.
   • Plataforma - Clique no campo para selecionar iOS no menu suspenso.
   • Nome do dispositivo — insira o nome do dispositivo.

   • Recursos adicionais desejados - Adicione os seguintes recursos:

     Name	Valor
     automationName	xcuitest (esse recurso ativa o driver Appium iOS)
     udid	the Identifier of the connected physical iOS device

4. (Opcional) Configure os detalhes de registro em log e gravação de vídeo na aba Registro em log.
5. (Opcional) Configure seu processo de desenvolvimento na aba Desenvolvimento.
   • Fechar abas similares (ativado por padrão): feche abas que estejam executando conexões com dispositivos e aplicativos semelhantes.
   • Aguardar atualização da página (ativado por padrão): aguarde a origem da página recuperar uma captura de tela de cada ação.
6. Clique em Salvar e fechar para adicionar seu dispositivo.

   Seu dispositivo é adicionado à lista de Dispositivos. Para adicionar um dispositivo local, consulte .

   Se não conseguir iniciar seu dispositivo, consulte Resolução de problemas: falha na inicialização de dispositivo físico.

   
   

   

   
   

Automação Híbrida e Web no IOS

A automação híbrida funciona por padrão para dispositivos iOS, desde que você não esteja tentando automatizar um aplicativo desenvolvido para produção. Ao automatizar aplicativos de produção, o conteúdo hospedado do WKWebView não será automatizável, embora qualquer conteúdo da Web hospedado em um SFSafariViewController também possa ser automatizado em aplicativos de produção. Para obter mais informações, consulte SFSafariViewController.