Local Devices

Visão geral

Para configurar um dispositivo local para trabalhar com as atividades de Mobile Automation, seja ele um dispositivo físico ou um emulador, você precisa executar uma instância local do Appium, e ter as ferramentas necessárias para automatizar dispositivos Android ou iOS.

Seções de tópicos:

• Armazenamento de aplicativos
• Configuração do dispositivo Android
• Configuração do dispositivo iOS

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 APK ou 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.

Configuração do dispositivo Android

Para configurar um dispositivo Android local, você precisa preparar seu ambiente e adicioná-lo ao Mobile Device Manager.

Os tópicos nesta seção:

• Preparando o ambiente Android
• Iniciando o Appium Server
• Criando emulador Android
• Habilitando Web e Automação Híbrida com WebDriver
• Configurando o dispositivo físico Android
• Adicionando dispositivo Android local no Gerenciador de dispositivos móveis

Preparando o ambiente Android

Prepare e configure seu ambiente.

1. Baixar e instalar o Node.js.
2. Abra a prompt de comando do Node.js e execute o seguinte comando para instalar o Appium:

   npm install -g appium

   Para obter mais informações sobre a configuração do Appium, consulte Introdução ao Appium.

3. No Windows, navegue até Configurações de sistema avançadas > Avançado > Variáveis de ambiente
4. Em Variáveis do sistema, clique em Novo e configure as seguintes variáveis:

   a. Variável ANDROID_HOME .

Nome da variável: ANDROID_HOME Valor da variável: C:\Users\Username\AppData\Local\Android\Sdk Nota: A parte Username , dentro do caminho Valor da variável , deve ser substituída pelo nome real do usuário que está operando na máquina.

b. variável JAVA_HOME . Você precisa ter o Java já instalado para configurar esta variável. Você pode baixar o Java através de um arquivo zip aqui.

Nome da variável: JAVA_HOME.

Valor da variável: o caminho onde o JDK está localizado em sua máquina. Por exemplo: C:\Program Files\Java\jdk8.

Importante: Se o Java for atualizado automaticamente, você precisará configurar manualmente esta variável com o caminho atualizado.

c. Clique em OK para confirmar.

1. Edite a variável Path do seu usuário para incluir o Android Debug Bridge (ADB):

   a. Clique em Novo e adicione o seguinte valor:

   %ANDROID_HOME%\platform-tools

   b. Clique em OK para confirmar.

2. Clique em Ok para definir a variável.

   
   

   

   
   

Iniciando o Appium Server

Antes de iniciar qualquer aplicativo em seu dispositivo, você precisa iniciar a execução de um servidor Appium em sua máquina. Abra o prompt de comando e execute o Appium com os seguintes parâmetros:

appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

Observação:

• Se o download automático falhar, você pode apontar para um chromedriver.exe já baixado, concatenando o seguinte comando:

--chromedriver-executable "path_to_chromedriver"

• Para obter ajuda com a depuração do Appium, execute o seguinte comando:

appium-doctor

• Para matar o Appium, use o comando ctrl + c .

Criando emulador Android

Crie seus emuladores Android usando o Android Studio.

1. Baixe e instale o Android Studio.
2. Abra o Android Studio.
3. Clique em Configurar e selecione SDK Manager no menu suspenso.
4. Desmarque Hide Obsolete Packages e certifique-se de que Android SDK Tools (Obsolete) esteja selecionado.
   
   

   

   
   
5. Clique em Aplicar e em OK para fechar.
6. Navegue até Configure > AVD Manager para configurar um dispositivo virtual. Para obter mais informações, consulte Criar e gerenciar dispositivos virtuais.
   
   

   

   
   
7. Atualize os aplicativos do Google do seu dispositivo.

Habilitando Web e Automação Híbrida com WebDriver

Habilite a depuração do WebView.

Se o Appium não detectar automaticamente a versão Chrome ou WebView em seu Android, escolha uma das opções abaixo:

1. Use o comando --allow-insecure chromedriver_autodownload . Isso permite que o Appium detecte e baixe automaticamente a versão do ChromeDriver que corresponde ao seu ambiente.
2. Especifique e baixe manualmente o WebDriver para Chrome:

   2.1. Abra seu dispositivo no Android Studio.

   2.2. Navegue até Configurações > Aplicativos e notificações.

   2.3 Clique em Ver todos os aplicativos.

   2.4. Clique no botão de reticências verticais e selecione Mostrar sistema no menu suspenso.

   2.5. Use a função de pesquisa para procurar Android System WebView.

   2.6. Abra o aplicativo e vá para Avançado.

   2.7. Copie o número da versão na parte inferior da tela.

   2.8. Baixe o WebDriver para Chrome e considere o seguinte:

   • Selecione a versão que corresponde à versão do Android System Webview da etapa anterior e extraia-a para uma pasta.
   • Você está procurando uma correspondência exata para a versão (major.minor.patch.revision).
   • Caso uma correspondência exata não esteja disponível, use a versão principal mais recente do ChromeDriver que corresponda à versão principal do Android System Webview.
   • Se você deseja automatizar o aplicativo Chrome, basta executar as mesmas etapas acima e anotar a versão do Chrome.

Configurando o dispositivo físico Android

1. Baixe e instale o Android Studio.
2. Abra o Android Studio.
3. Clique em Configurar e selecione SDK Manager no menu suspenso.
4. Desmarque Hide Obsolete Packages e certifique-se de que Android SDK Tools (Obsolete) esteja selecionado.
5. Clique em Aplicar e em OK para fechar.
6. Abra uma linha de comando e execute o seguinte comando para iniciar um servidor de depuração:

   %LOCALAPPDATA%\\Android\\Sdk\\platform-tools\\adb.exe start-server

7. Conecte seu dispositivo à sua máquina através de um cabo.
8. Ative as opções do desenvolvedor e a depuração USB no seu dispositivo. Para obter mais informações, consulte Configurar opções de desenvolvedor no dispositivo.
9. Em seu telefone, navegue até Configurações > Opções do desenvolvedor.
10. Na seção Rede , abra Configuração USB padrão e defina-a como Carregar apenas telefone.
11. Adicione seu dispositivo ao Mobile Device Manager.
12. Execute o seguinte comando para iniciar um servidor Appium:

    appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

    Para obter parâmetros adicionais, consulte Iniciando o Servidor do Appium.

    Observação: certifique-se de deixar a conexão ao servidor do Appium em execução sem nenhuma interferência. Por exemplo, se você clicar dentro do terminal, a comunicação será interrompida, o que pode levar a um erro de comunicação no Mobile Device Manager.

Adicionando dispositivo Android local no Gerenciador de dispositivos móveis

1. Abra o MDM 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 localhost. Por exemplo: http://localhost:10001/wd/hub.
   • Plataforma - Clique no campo para selecionar Android na lista suspensa.
   • Nome do dispositivo - Digite o nome do dispositivo. Uma maneira de ver isso é por meio do Android Studio, se você navegar para Configure > AVD Managere, em seguida, vá para More Actions > View Details.
   • Versão da plataforma — adicione o número da versão do seu sistema operacional Android.
   • Recursos adicionais desejados (opcional) — adicione recursos específicos para personalizar sua sessão de automação. Para obter mais informações, consulte Recursos desejados do Appium.
   • Definir localização geográfica (opcional) — defina a localização do seu dispositivo para testar aplicativos que usam serviços de localização para gerar dados de localização.
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 Dispositivos locais.

   
   

   

   
   

Configuração do dispositivo IOS

Para configurar um dispositivo iOS local, simulador ou dispositivo físico e automatizar um aplicativo, você terá que configurar o servidor Appium em uma máquina macOS.

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

Os tópicos nesta seção:

• Preparando o ambiente macOS
• Configurando o dispositivo físico iOS
• Adicionando dispositivo iOS local no Gerenciador de dispositivos móveis

Preparando o ambiente MacOS

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:

   npm install -g appium

5. Abra o Xcode e permita que ele instale quaisquer componentes adicionais necessários. Feche-o quando vir a tela inicial.
6. Execute o seguinte comando para iniciar o Appium:

   appium --port 10001

7. Use a Pesquisa do Spotlight (⌘-Espaço) para abrir o Network Utility.
8. Copie o endereço IP para uso posterior ao adicionar um dispositivo iOS ao MDM. Isso será incluído no URL do Appium (por exemplo, http://<ipaddress>:8001/wd/hub)
   
   

   

   
   

Configurando o Dispositivo Físico IOS

Se você quiser usar as atividades de automação móvel com um dispositivo iOS físico, precisará de uma conta de desenvolvedor da Apple.

1. Siga as etapas 1 a 5 de Preparando o ambiente do macOS
2. Conecte seu dispositivo físico ao seu Mac.
3. Desbloqueie seu dispositivo e, se um alerta aparecer, certifique-se de permitir que o computador o acesse.
4. Abra um Terminal e execute o seguinte comando:

   instruments -s devices

5. Copie a ID do seu dispositivo para uso posterior, ao adicionar seu dispositivo no MDM. Por exemplo, deviceID será adicionado como um recurso udid :

   Known Devices: Username's iPhone (13.5.1) (<deviceID>)

6. Entre na sua conta de desenvolvedor da Apple e vá para Membership.
7. Copie sua ID de equipe para uso posterior, ao adicionar seu dispositivo no MDM. Sua ID de equipe terá que ser adicionada aos recursos do dispositivo com o nome xcodeOrgId.
8. Abra o Xcode e navegue até Preferências > Contas.
9. Adicione sua conta de desenvolvedor da Apple.

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 localhost. Por exemplo: http://<ipaddress>:8001/wd/hub.
   • Plataforma - Clique no campo para selecionar iOS no menu suspenso.
   • Nome do dispositivo — insira o nome do dispositivo.
   • Recursos adicionais desejados(dispositivos físicos) - Adicione o udid e o xcodeOrgId. Para obter mais informações, consulte Configuração do dispositivo físico iOS
   • Definir localização geográfica (opcional) — defina a localização do seu dispositivo para testar aplicativos que usam serviços de localização para gerar dados de localização.
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 Dispositivos locais.

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