Dispositivos IOS locais

Configurando dispositivos iOS locais

Para configurar um dispositivo local para trabalhar com atividades de Automação Móvel, você precisa:

• Tenha um ambiente macOS.
• Execute uma instância local do Appium no dispositivo macOS.

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

Pré-requisitos

1. Instale o Xcode.
2. Abra um Terminal e execute o seguinte comando para instalar o Homebrew:

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Execute o seguinte comando para instalar o NodeJS:

   brew install node

4. Instalar Appium:
   • Para Appium 1.0, execute o seguinte comando: npm install -g appium. Isso instalou automaticamente todos os drivers necessários.
   • Para Appium 2.0, execute o seguinte comando: npm install -g appium@next.
   O Appium 2.0 vem sem os drivers instalados. Portanto, para instalar os drivers necessários, execute também o seguinte comando: appium driver install xcuitest.

   Importante:

   • Recomendamos o uso do Appium 2.0 com Mobile Automation versão 22.10 ou superior.

   • Instale o Appium 2.0 se quiser testar suas automações móveis em um dispositivo físico iOS.

5. Abra o Xcode e permita que ele instale quaisquer componentes adicionais necessários. Feche-o quando vir a tela inicial.
6. Inicie o servidor Appium, usando o seguinte comando: appium --port 8001 --default-capabilities "{\"appium:systemPort\":9001}" --relaxed-security.
   
   

   

   
   

Configuração de dispositivo IOS físico local

1. Conecte seu dispositivo físico ao seu Mac.
2. Desbloqueie seu dispositivo e, se um alerta aparecer, certifique-se de permitir que o computador o acesse.
3. Obtenha o URL do Appium e salve-o para mais tarde:
   • Vá para Configurações do sistema, na guia Rede e selecione a rede Wi-Fi à qual o dispositivo físico está conectado.
   • Copie o endereço IP da rede Wi-Fi à qual o dispositivo está conectado. O formato da URL do Appium é http://<ipaddress>:8001 (8001 é o número da porta onde você inicia o Appium).
     
     

     

     
     
4. Obtenha o UDID do dispositivo iOS físico que você conectou à sua máquina, do XCode.
   • Vá para Janela > Dispositivos e Simuladores > Dispositivos.
   • Clique no dispositivo iOS ao qual você se conectou.
   • Copie o identificador. Este é o UDID, que você adicionará posteriormente como um recurso adicional desejado, ao adicionar este dispositivo físico iOS ao MDM.
5. Crie WebDriverAgent com XCode no seu Mac.
   • Navegue até a pasta appium-webdriveragent usando o seguinte caminho: /Users/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragente abra o arquivo xcodeproj .
   • Selecione WebDriverAgente abra WebDriverAgentRunner, na seção Destinos .
   • Alterne para a guia Assinatura e recursos , selecione Gerenciar automaticamente a assinaturae escolha uma conta de usuário no menu suspenso Equipe .
   • Altere o identificador de pacote para um valor exclusivo.

   • Copie e salve este identificador de pacote. Você o usará para adicionar seu aplicativo dentro do MDM (Bundle Id).

     
     

     

     
     
6. Instale o WebDriverAgent em seu dispositivo físico iOS.
   • Selecione WebDriverAgentRunner na barra de navegação WebDriverAgent.
   • No XCode, vá para Producte clique em Test. Em seu dispositivo físico iOS conectado, você verá a instalação do WebDriverAgent .
7. 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.

   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.