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:

• Physical - a physical Android device that you can connect to your local machine, through a USB cable.
• Emulator - an emulator for an Android 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:

• appium driver list - lists installed drivers (recommended for 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. After the installation of Node.js is finished, open a command prompt and check if it was successful, using the following commands:

   • node-v - returns the Node.js version installed on your machine. The version returned needs to be equal to, or higher than 19.
   • npm-v - returns the version of npm installed on your machine. The version returned needs to be equal to, or higher than 8.

4. Baixe e instale o Android Studio. É possível baixar o Android Studio aqui.

5. Install Android SDK Tools (Obsolete) using Android Studio.

6. In Windows, navigate to Advanced system settings > Advanced > Environment Variables.

7. Under System variables click New and configure the following variables:

   1. Variável JAVA_HOME . Aponta para a pasta em que 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.

   2. Variável ANDROID_HOME . Aponta para a pasta em que o SDK do Android 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 Observação: 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.

      Importante:

      If Java is updated automatically, you need to manually configure this variable with the updated path.

1. Open the Node.js command prompt and install Appium:
   • For Appium 1.0, run the following command: npm install -g appium. Appium 1.0 comes with all drivers installed.
   • 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 uiautomator2.

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

Observação:

We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.

1. Reinicie o computador para aplicar as alterações.
2. Open the physical mobile device, and enable Developer Options.
   • On your phone, navigate to Settings > Developer Options.
   • Under the Networking section, open Default USB configuration and set it to Charging phone only.
3. Enable USB debugging.
4. On your phone, navigate to Settings > Developer Options.
5. Under the Networking section, open Default USB configuration and set it to Charging phone only.

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. Allow USB debugging on the mobile device (if you're asked to allow it).

4. Adicione manualmente o parâmetro the --base-path /wd/hub antes de iniciar a sessão do Appium.

5. Start the Appium server, using the following command: appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload.

   Observação:

   • If the auto-download fails, you can point to an already downloaded chromedriver.exe, by concatenating the following command:

     --chromedriver-executable "path\_to\_chromedriver"

   • Make sure to leave the Appium server connection running without any interferences. For example, if you click within the terminal, the communication is cut off, which may lead to a communication error in 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. After the installation of Node.js is finished, open a command prompt and check if it was successful, using the following commands:

   • node-v - returns the Node.js version installed on your machine. The version returned needs to be equal to, or higher than 19.
   • npm-v - returns the version of npm installed on your machine. The version returned needs to be equal to, or higher than 8.

4. Baixe e instale o Android Studio. É possível baixar o Android Studio aqui.

5. In Windows, navigate to Advanced system settings > Advanced > Environment Variables.

6. Under System variables click New and configure the following variables:

   1. Variável JAVA_HOME . Aponta para a pasta em que 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.

   2. Variável ANDROID_HOME . Aponta para a pasta em que o SDK do Android foi instalado.

      • Variable name: ANDROID_HOME
      • Variable value: the path where the Android SDK is located on your machine. For example: C:\Users\Username\AppData\Local\Android\Sdk
      Observação:

      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.

      1. Open the Node.js command prompt and install Appium:

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

         Appium 2.0-beta comes without the drivers installed. Therefore, to install the needed drivers, also run the following command: 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.

         Observação:

         We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.

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

Criando emulador Android

Create your Android emulator using Android Studio.

1. Abra o Android Studio.

2. Click Configure and select SDK Manager from the dropdown.

3. Uncheck Hide Obsolete Packages and make sure that Android SDK Tools (Obsolete) is selected.

   

4. Click Apply and then Ok to close.

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:
   1. Open your device in Android Studio.
   2. Navegue até Configurações > Aplicativos e notificações. 3 Clique em Ver todos os aplicativos.
   3. Click the vertical ellipsis button and select Show system from the dropdown.
   4. Use the search function to look for Android System WebView.
   5. Open the app and go to Advanced.
   6. Copy the version number at the bottom of the screen.
   7. 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.

   • Appium URL - Enter the localhost. For example: http://localhost:10001/wd/hub.

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

   • Device Name - Enter the device name. One way to see that is through Android Studio if you navigate to Configure > AVD Manager, and then go to More Actions > View Details.

   • Versão da plataforma — adicione o número da versão do seu sistema operacional Android.

   • Additional Desired Capabilities (Optional) - Add specific capabilities to customize your automation session.

     Importante:

     Para ativar os drivers do 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. (Optional) - Set your device location in the Location tab, to test applications that use Location Services to generate location data.

   

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. Para adicionar um dispositivo local, consulte .