Dispositivos Android locais

Configurando dispositivos Android locais

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

Existem dois tipos de dispositivos Android locais que você pode automatizar:

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

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:

• appium driver list - lista os drivers instalados (recomendado para Appium 2.0)
• adb devices - lista os dispositivos conectados
• adb start-server - inicia o servidor de depuração
• adb kill-server - para o servidor de depuração
• ctrl + c - mata Appium
• appium-doctor - ajuda na depuração do seu Appium.

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.

Configurando o Dispositivo Android Físico Local

Pré-requisitos

Siga as etapas abaixo para concluir os pré-requisitos para configurar um dispositivo Android físico local:

1. Baixe e instale o Java. É possível baixar o Java por meio de um arquivo zip aqui.
2. Baixe e instale o Node.js. Você pode baixar a versão mais recente do Node.js aqui.
3. Após a conclusão da instalação do Node.js , abra um prompt de comando e verifique se foi bem-sucedida, usando os seguintes comandos:
   • node-v - retorna a versão do Node.js instalada em sua máquina. A versão retornada precisa ser igual ou superior a 19.
   • npm-v - retorna a versão do npm instalado em sua máquina. A versão retornada precisa ser igual ou superior à 8.
4. Baixe e instale o Android Studio. É possível baixar o Android Studio aqui.
5. Instale o Android SDK Tools (obsoleto) usando o Android Studio.
6. No Windows, navegue até Configurações avançadas do sistema > Avançado > Variáveis de ambiente.
7. Em Variáveis do sistema, clique em Novo e configure as seguintes variáveis:

   a. variável JAVA_HOME . Aponta para a pasta onde o Java foi instalado.

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.

b. Variável ANDROID_HOME . Aponta para a pasta onde o Android SDK foi instalado.

Nome da variável: ANDROID_HOME Valor da variável: o caminho onde o Android SDK está localizado em sua máquina. Por exemplo: C:\Users\Username\AppData\Local\Android\Sdk Nota: A parte Username , dentro do caminho Variable Value , deve ser substituída pelo nome real do usuário que está operando na máquina.

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

1. Abra o prompt de comando do Node.js e instale o Appium:

   • Para Appium 1.0, execute o seguinte comando: npm install -g appium. O Appium 1.0 vem com todos os drivers instalados.
   • 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 uiautomator2.

Para obter mais informações sobre a configuração do Appium 2.0, consulte Introdução de início rápido do Appium.

Observação: recomendamos usar o Appium 2.0 com o Mobile Automation versão 22.10 ou superior.

1. Reinicie o computador para aplicar as alterações.

2. Abra o dispositivo móvel físico e habilite as Opções do desenvolvedor.

   • Em seu telefone, navegue até Configurações > Opções do desenvolvedor.
   • Na seção Rede , abra Configuração USB padrão e defina-a como Carregar apenas telefone.
3. Habilite a depuração USB.
4. Em seu telefone, navegue até Configurações > Opções do desenvolvedor.
5. Na seção Rede , abra Configuração USB padrão e defina-a como Carregar apenas telefone.

Configurando o Dispositivo Android Físico Local

1. Conecte o dispositivo físico à máquina local, usando um cabo USB.
2. Abra um prompt de comando e inicie o servidor de depuração, usando o seguinte comando: adb.exe start-server.
3. Permita a depuração USB no dispositivo móvel (se você for solicitado a permitir).
4. Adicione manualmente o parâmetro the --base-path /wd/hub antes de iniciar a sessão do Appium.
5. Inicie o servidor do Appium, usando o seguinte comando: appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload.
   Observação:

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

   --chromedriver-executable "path_to_chromedriver"

   • Certifique-se de deixar a conexão do servidor Appium em execução sem interferências. Por exemplo, se você clicar dentro do terminal, a comunicação é cortada, o que pode levar a um erro de comunicação no Mobile Device Manager.
6. Adicione o dispositivo Android físico local configurado no Mobile Device Manager, usando o procedimento Adição de dispositivo Android local no Mobile Device Manager.

Configuração de dispositivo Android emulado local

Pré-requisitos

1. Baixe e instale o Java. É possível baixar o Java por meio de um arquivo zip aqui.
2. Baixe e instale o Node.js. Você pode baixar a versão mais recente do Node.js aqui.
3. Após a conclusão da instalação do Node.js , abra um prompt de comando e verifique se foi bem-sucedida, usando os seguintes comandos:
   • node-v - retorna a versão do Node.js instalada em sua máquina. A versão retornada precisa ser igual ou superior a 19.
   • npm-v - retorna a versão do npm instalado em sua máquina. A versão retornada precisa ser igual ou superior à 8.
4. Baixe e instale o Android Studio. É possível baixar o Android Studio aqui.
5. No Windows, navegue até Configurações avançadas do sistema > Avançado > Variáveis de ambiente.
6. Em Variáveis do sistema, clique em Novo e configure as seguintes variáveis:

   a. variável JAVA_HOME . Aponta para a pasta onde o Java foi instalado.

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.

b. Variável ANDROID_HOME . Aponta para a pasta onde o Android SDK foi instalado.

• Nome da variável: ANDROID_HOME
• Valor da variável: o caminho onde o SDK do Android está localizado em sua máquina. Por exemplo: C:\Users\Username\AppData\Local\Android\Sdk
  Nota: A parte Username , dentro do caminho Variable Value , deve ser substituída pelo nome real do usuário operando na máquina.
  1. Abra o prompt de comando do Node.js e instale o Appium:
• Para Appium 1.0, execute o seguinte comando: npm install -g appium. O Appium 1.0 vem com todos os drivers instalados.
• Para Appium 2.0, execute o seguinte comando: npm install -g appium@next.

O Appium 2.0-beta vem sem os drivers instalados. Portanto, para instalar os drivers necessários, execute também o seguinte comando: appium driver install uiautomator2.

Para obter mais informações sobre a configuração do Appium 2.0, consulte Introdução de início rápido do Appium.

Observação: recomendamos usar o Appium 2.0 com o Mobile Automation versão 22.10 ou superior.

1. Reinicie o computador para aplicar as alterações.

Criando emulador Android

Crie seu emulador Android usando o Android Studio.

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

   

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

   

   
   
6. Atualize os aplicativos do Google do seu dispositivo.

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

Habilite a depuração do WebView no dispositivo local para permitir que o Mobile Device Manager reconheça a maioria dos elementos de interface gráfica dentro de um aplicativo.

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.
3. Adicione o dispositivo emulado local configurado no Mobile Device Manager, usando o procedimento Adição de dispositivo Android local 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.

     Importante: Para ativar os drivers Appium instalados anteriormente, adicione o seguinte recurso à seção Recursos adicionais desejados :

     Name	Valor
     appium:automationName	UiAutomator2

     Para obter mais informações, consulte Recursos desejados do Appium.

4. (Opcional) - Defina a localização do seu dispositivo na guia Localização para testar aplicativos que usam Serviços de Localização para gerar dados de localização.
   
   

   

   
   
5. (Opcional) Configure os detalhes de registro em log e gravação de vídeo na aba Registro em log.
6. (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.
7. Clique em Salvar e fechar para adicionar seu dispositivo.

   Seu dispositivo é adicionado à lista de Dispositivos.