Dispositivos IOS locais

Configuração de dispositivos iOS locais para automação móvel executando uma instância do Appium local.

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:

• Physical - a physical iOS device that you can connect to your local machine, through a USB cable.
• Emulator - an emulator for an iOS device that's stored locally.

Comandos Appium mais usados

A lista abaixo descreve os comandos mais usados para configurar o Appium no contexto de Automação de dispositivos móveis (recomendado para o 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.

AVISO:

Se o artefato do seu aplicativo usar a extensão APP e você quiser carregar o aplicativo em uma URL pública, será necessário criar uma pasta chamada Payload, colocar o APP dentro dela, arquivar a pasta Payload e alterar a extensão para IPA ao invés 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:

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

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

3. Execute o seguinte comando para instalar o NodeJS:

brew install node 4. Instale o Appium:

• For Appium 1.0, run the following command: npm install -g appium. This automatically installed all drivers needed.
• For Appium 2.0, run the following command: npm install -g appium@next.

Appium 2.0 comes without the drivers installed. Therefore, to install the needed drivers, also run the following command: appium driver install xcuitest.

AVISO:

• We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.
• Instale o Appium 2.0 se você quiser testar suas automações móveis em um Dispositivo Físico iOS. 1. Abra o Xcode e permita que ele instale quaisquer componentes adicionais necessários. Feche-o após ver a tela inicial. 2. Inicie o servidor do 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:

   • Go to System Settings, then the Network tab, and select the Wi-Fi network that the physical device is connected to.
   • Copie o endereço IP para a 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.

   • Go to Window > Devices and Simulators > Devices.
   • Clique no dispositivo iOS ao qual você se conectou.
   • Copy the Identifier. This is the UDID, that you'll later add as an additional desired capability, when adding this iOS physical device to MDM.

5. Crie o WebDriverAgent com o 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 .
   • Select WebDriverAgent, and open WebDriverAgentRunner, under the Targets section.
   • Switch to the Signing & Capabilities tab, select Automatically manage signing, and choose a user account from the Team dropdown.
   • Change the Bundle Identifier to a unique value.
   • Copie e salve este Identificador de pacote. Você o usará para adicionar seu aplicativo dentro do MDM (Id do pacote).
     

6. Install the WebDriverAgent on your iOS physical device.

   • Select WebDriverAgentRunner in the WebDriverAgent navigation bar.
   • In XCode, go to Product, and click Test. On your connected iOS physical device, you'll see the WebDriverAgent installing.

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.

   • Appium URL - Enter the Appium URL, that you previously copied, using the following format: http://<ipaddress>:8001.

   • Platform - Click the field to select iOS from the dropdown.

   • Nome do dispositivo — insira o nome do dispositivo.

   • Additional Desired Capabilities - Add the following capabilities:

     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 você não conseguir iniciar seu dispositivo, consulte Soluçã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 criado para produção. Ao automatizar aplicativos de produção, o conteúdo hospedado do WKWebView não será automatizado, 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.