Introdução às APIs de automação móvel

Este guia de início rápido ajuda você a criar sua primeira automação codificada, usando APIs de automação móvel. O tutorial usa o aplicativo UiPath® Android Basic e um Emulador do Google Pixel do Sauce Labs para testes automatizados.

1. Adicione o dispositivo móvel e o aplicativo dentro do Mobile Device Manager

Para usar o dispositivo móvel e aplicativo desejados dentro de nossa automação codificada, temos que criá-los primeiro no MDM (Mobile Device Manager):

1. Para criar o aplicativo:
   1. Abra o MDM e acesse Aplicativos
   2. Selecione Adicionar um aplicativo.
   3. Na janela Editar aplicativo, insira as informações necessárias:
      1. Nome: para esse exemplo, use Basic App - Android.
      2. Tipo: selecione Aplicativo para um aplicativo nativo.
      3. Plataforma: selecione Android para automatizar o aplicativo Android.
      4. Aplicativo: para esse exemplo, insira o seguinte link para o Aplicativo Básico Android: https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk.
      5. Pacote de aplicativos: insira o pacote de aplicativos móveis, como com.example.basicapp.
      6. Atividade do aplicativo: insira a instância de atividades, como: .core.MainActivity.
      7. Para recursos adicionais desejados, adicione o recurso appium:app para garantir que o aplicativo funcione conforme o esperado.

      Tabela 1. Recursos Adicionais Desejados

      Name	Valor
      appium:app	appium:app https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk

   
   

   

   
   
2. Para criar o dispositivo:
   1. Acesse Dispositivos e selecione Adicionar um dispositivo.
   2. Nomeie o dispositivo. Para esse exemplo, use Google Pixel 3a GoogleAPI Emulator.
   3. Defina os seguintes parâmetros: URL do Appium, Plataforma, Nome do dispositivo, Versão da plataforma.
      1. Recupere os parâmetros do seu provedor de farm de dispositivos móveis escolhido. Neste exemplo, estamos usando Sauce Labs.
      2. Para obter a URL do Appium, acesse Conta e, em seguida, Configurações do usuário. Copie a URL sob demanda em Criação de driver.
      3. Para obter Plataforma, Nome do dispositivo e Versão da plataforma, acesse Automatizado, em seguida, Configurador de plataforma. Selecione os recursos para Google Pixel 3a GoogleAPI Emulator e Android Emulator version 10.0. Em Script de configuração, escolha seu Appium version. Para esse exemplo, use 2.0.0.
      4. Copie e cole os valores do Sauce Labs no MDM.
      5. 
         

         

         
         
   4. Selecione Salvar e fechar.
   5. Selecione Iniciar um aplicativo nesse dispositivo e conecte o dispositivo ao aplicativo criado anteriormente.

2. Crie seu Repositório de Objetos para o aplicativo móvel

Para automatizar seu aplicativo móvel preferido, grave seus elementos móveis dentro do Repositório de Objetos do projeto. Para esse exemplo, criamos um aplicativo Aplicativo básico com um HomeScreen geral, contendo três elementos de interface gráfica que usamos para automatizar. Verifique a lista a seguir para ver como a estrutura do Repositório de Objetos aparece:

• BasicApp
  • HomeScreen
    • EditText
    • SingleClickButton
    • VerifyText
  
  

  

  
  

3. Estabeleça uma conexão

Depois de configurar seu dispositivo e aplicativo no MDM, comece a escrever o código para sua automação. Antes de começar a usar as APIs de automação móvel, você precisa estabelecer uma conexão entre seu dispositivo móvel e o aplicativo escolhido, usando as APIs correspondentes.

Um connection é uma classe que representa a conexão que você cria entre um dispositivo e um aplicativo, que expõe as APIs que você pode usar para automatizar cenários de testes móveis. Acesse Conexão para obter mais informações sobre a criação de um connection.

Para criar uma conexão, você tem um conjunto de APIs dedicadas que você pode usar. Nesse exemplo, usamos a API Connect, com a segunda sobrecarga, que exige os nomes de dispositivos e aplicativos como strings.

Crie a conexão usando as seguintes etapas:

1. Comece com uma instrução using, para evitar criar uma variável separada.
2. Dentro da instrução using, chame a API Connect, com a segunda versão de sobrecarga.

   Para essa sobrecarga, insira o nome do dispositivo e o nome do aplicativo para estabelecer a conexão.

   [TestCase]
           public void Execute()
           {
           using (Connection connection = mobile.Connect(
               "Google Pixel 3a GoogleAPI Emulator", 
               "Basic App - Android"))

3. Opcionalmente, para fins de depuração, você pode adicionar uma mensagem Log.

   Log("Connection established");

4. Comece a automatizar o aplicativo e o dispositivo móvel

O fluxo de automação nesse exemplo inclui tocar em certos botões, obter texto exibido na tela do celular e mover um controle deslizante. Essas ações simulam cenários de automação móvel da vida real.

Para automatizar os elementos de interface gráfica nesse exemplo, usamos IElementDescriptors. Eles representam elementos de interface gráfica acessados diretamente do Repositório de Objetos. Além de IElementDescriptors, você pode usar outros tipos de seletores com APIs de automação móvel, como ObjectRepositoryTarget e SelectorTarget. Acesse Seletores de API para saber como e quando usar outros tipos de seletores.

1. Chame a API Tap para clicar em SingleClickButton no aplicativo Android Basic.

   // Tap the SingleClickButton
               connection.Tap(Descriptors.BasicApp.HomeScreen.SingleClickButton);
               Log("Tapped SingleClickButton ");

2. Use a API SetText para inserir um texto específico no campo EditText.

   string expectText = "Random text";
               connection.SetText(Descriptors.BasicApp.HomeScreen.EditText, expectText);
               Log("Inserted random text");

3. Obtenha o texto que você definiu anteriormente e verifique se ele corresponde ao texto do elemento de interface gráfica VerifyText. Use as APIs GetText e VerifyExpression.

   var actualText = connection.GetText(Descriptors.BasicApp.HomeScreen.VerifyText);
               testing.VerifyExpression(expectText == actualText, "EditText validation failed.");
               SelectorTarget selector = null;

4. Use a API PositionalSwipe para mover o controle deslizante.
   A API PositionalSwipe requer duas variáveis Point, representando os pontos inicial e final para a ação de deslizar. Crie esses pontos antes de usar a API para legibilidade aprimorada.

   // Perform a positional swipe operation to use the slider
   
               var startPoint = new Point(226, 304);
               var endPoint = new Point(296, 304);
               
               connection.PositionalSwipe(startPoint, endPoint);
   
               Log("Performed Swipe action.");

   Para obter a posição da tela, acesse a conexão ativa no MDM. Passe o mouse sobre a tela do celular. Isso exibirá o local do cursor em pixels no canto inferior esquerdo do MDM.

   
   

   

   
   

Amostra de fluxo de trabalho

Para seguir as etapas neste guia de Início rápido ou para experimentá-lo por conta própria, baixe a amostra do Guia de início rápido de APIs de automação móvel.