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

Ao trabalhar com Dispositivos Físicos iOS, você precisa da seguinte infraestrutura:

1. Dispositivo do Windows OS
   • UiPath Studio (Hardware/Software) – guia de instalação
2. Dispositivo macOS
   • Servidor do Appium
     • disparar
     • Node JS
   • Xcode
     • Necessário para instalar o Appium Driver no dispositivo iOS
3. Dispositivo iOS
   • Appium WebDriver

Figura 1. Arquitetura para dispositivos físicos locais do iOS

Pré-requisitos

1. macOS 13+ (Ventura ou posterior)
2. ID Apple (para Xcode e provisionamento)
3. Dispositivo iOS físico (i iPhone/iPad)
4. UiPath Studio 2023.10 (ou superior)
5. Cabo USB para conectar o dispositivo

Configuração de dispositivo IOS físico local

1. Instalar o Homebrew.
   1. Abra o Terminal (selecione Command+Space).
   2. Execute o seguinte comando:

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

      Figura 2. Instalação do Homebrew - linha de comando
      

      

      
      
   3. Se solicitado, execute o seguinte comando para adicionar o Homebrew à sua variável de ambiente PATH :

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

   4. Verifique.

      brew -version

2. Instale o Xcode e as Ferramentas de Linha de Comando.
   • Instale o Xcode por meio da App Store e abra-o uma vez.
   • A partir do Terminal, execute o seguinte:

   • 1. xcode-select –install

     2. sudo xcodebuild -license accept

     3. Verificar:

        xcodebuild -version

3. Habilite o modo do Desenvolvedor no dispositivo iOS.
   1. No seu iPhone ou iPad, acesse Configurações > Privacidade e segurança > Modo do desenvolvedor.
      Figura 3. Modo do desenvolvedor no dispositivo iOS
      

      

      
      
   2. Ative e reinicie.
   3. Após reiniciar, aprove o pop-up.
   4. Conecte-se via USB e confie no computador.
      Figura 4. Habilitar a confiança do dispositivo iOS
      

      

      
      
4. Instale o Node.js.
   1. Execute o seguinte comando:

      brew install node

      Figura 5. Instalação do Node.js
      

      

      
      
   2. Verifique.

      node -v

      npm -v

5. Instale o Appium v3.
   1. Execute o seguinte comando:

      npm install -g appium@3

      Figura 6. Instalação do Appium
      

      

      
      
   2. Verifique.

      appium -v

      Figura 7. Verificação do Appium
      

      

      
      
6. Instalar os Drivers e os plug-ins do Appium.
   1. Instale o driver do iOS.

      appium driver install xcuitest

      Figura 8. Appium xcuitiest
      

      

      
      
   2. (Opcional) Configure a opção Android.

      appium driver install uiautomator2

   3. Listar drivers.

      appium driver list

      Figura 9. Drivers do Appium
      

      

      
      
7. Configure o WebDriverAgent.
   1. Instale o Carthage.
   2. Configure o WebDriverAgent.
      1. Navegue até a pasta appium-webdriveragent , usando o seguinte caminho: /Usetrs/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent e abra o arquivo xcodeproj .
         Figura 10. Pasta do WebDriverAgent
         

         

         
         
      2. Selecione WebDriverAgent e, na seção Destinos , abra WebDriverAgentRunner.
         Figura 11. Executor do WebDriverAgent
         

         

         
         
      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.
         Figura 12. Identificador do pacote do WebDriverAgent
         

         

         
         
      5. Copie e salve esse Identificador de pacote, que você usará para adicionar seu aplicativo dentro do Mobile Device Manager (Id de pacote).
      Problema: um problema comum que você pode encontrar é um Certificado de Desenvolvedor Não Confiável. Para corrigir o problema, siga as instruções no pop-up.

      Figura 13. Solução de problemas do WebDriverAgent
      

      

      
      
8. Verifique o acesso ao dispositivo físico.
   1. Confirme se o IntegrationApp está instalado em seu dispositivo físico.
      Figura 14. IntegrationApp no dispositivo físico
      

      

      
      
   2. Execute xcrun xctrace list devices.
   3. Certifique-se de que seu iPhone apareça na lista. Se não, verifique as configurações de Modo do desenvolvedor e Confiabilidade . Você precisará do UDID ou da informação entre parênteses após o nome do seu dispositivo.
      Figura 15. Acesso a dispositivo físico
      

      

      
      
9. Inicie o Appium Server.
   1. Abra o terminal e insira appium.
      Figura 16. Início do servidor Appium
      

      

      
      
   2. Copie a URL do appium (para ser usada na próxima etapa).
      Observação: não use a localização 127.
10. Conecte o UiPath ao Appium.
    1. Abra o UiPath Studio e instale o Mobile Automation Activities.
    2. Abra o Mobile Device Manager e selecione Adicionar dispositivo.
       
       
       
       
       
       
       
       

Adicione o dispositivo iOS físico local configurado no Mobile Device Manager usando o procedimento Adição de dispositivo iOS no Mobile Device Manager .

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.