Uso de automação móvel para aplicativo de banco móvel

Neste tutorial, exploramos como usar o pacote de Automação Móvel para automatizar tarefas dentro de um aplicativo de banco móvel. O tutorial usa o simulador de banco móvel fornecido pelo Bank of America e um Emulador Google Pixel do Sauce Labs. Concentraremo-nos especificamente em automatizar e testar as seguintes ações:

1. Fazendo login no aplicativo.
2. Implementação de um bloqueio de cartão de débito.
3. Visualização de uma reivindicação e captura de tela.

O tutorial fornece instruções sobre como usar tarefas e APIs para automatizar esses cenários.

Pré-requisitos

Para usar o dispositivo móvel desejado e o aplicativo desejado, temos que criá-los primeiro no Gerenciador de Dispositivos Móveis (MDM), da seguinte forma:

1. Adicione um dispositivo do Sauce Labs ao MDM.

   Para obter mais informações sobre a adição de dispositivos, acesse Adicionando dispositivos do Sauce Labs.

2. Adicione o simulador de banco móvel do Bank of America ao MDM.

   Para obter mais informações sobre a adição de aplicativos, acesse Adicionando aplicativos.

Projeto de amostra

Para seguir as etapas e experimentar o tutorial por conta própria, verifique o seguinte projeto de exemplo: Simulador de banco móvel.

Usando atividades

Nesse exemplo, usamos elementos do Repositório de Objetos como elementos de entrada para atividades.Para criar elementos de interface do usuário para celular, estabeleça uma conexão no Mobile Device Manager (MDM) entre o dispositivo de destino e o aplicativo. Em seguida, diretamente no painel Repositório de Objetos, crie cada elemento e use Indicar Elemento para indicar o elemento de interface do usuário específico no dispositivo MDM.

Para seguir facilmente o tutorial, verifique a seguinte lista para a estrutura do Repositório de Objetos:

• Aplicativo do BankOfAmerica, menu MobileScreen
  • backFromClaimDetails
  • backFromClaimStatus
  • BackToMenu
  • firstClaimSeeDetails
  • Lock
  • LockCard
  • Login
  • ManageDebitCredit
  • Menu
  • Senha
  • swipeMenu
  • ID do Usuário
  • viewmyclaims

Dica: como alternativa, você pode criar um fluxo de trabalho semelhante usando ações gravadas. Esse processo envolve a criação de uma conexão entre seu dispositivo e o aplicativo através do MDM, realizando uma série de ações nessa conexão e, em seguida, importando essas etapas para uma sequência. Para obter mais informações, acesse Criar fluxo de trabalho com ações do gravador.

Etapas

1. Estabeleça uma conexão entre o dispositivo e o aplicativo:
   1. Adicione uma atividade de Conexão de Dispositivo Móvel.
   2. Use os Selecionar detalhes da conexão para conectar o dispositivo móvel e o aplicativo criados anteriormente.
2. Faça login no aplicativo móvel:
   1. Adicione uma atividade Tap para selecionar o campo ID do usuário, para que você possa inserir um nome de usuário.
   2. Adicione uma atividade Set Text para inserir o nome de usuário dentro do campo ID do usuário.
   3. Adicione uma atividade Tap para selecionar o campo Senha, para que você possa inserir a senha.
   4. Adicione uma atividade Set Text para inserir a senha correspondente.
   5. Use uma atividade de Toque para selecionar o botão Login.
   Figura 1. As primeiras atividades como parte do login no aplicativo
   

   

   
   
3. Bloquear um cartão de débito ou de crédito:
   1. Adicione uma atividade Tap para navegar até o menu do aplicativo bancário móvel.
   2. Adicione uma atividade Swipe para deslizar para baixo no menu.

      O objetivo é deslizar até que você encontre a seção Gerenciar Débito/Crédito.

   3. Adicione uma atividade Tap para selecionar a seção Gerenciar Débito/Crédito.
   4. Adicione uma atividade Tap para selecionar o ícone de Bloqueio para o primeiro cartão que é exibido.
   5. Adicione uma atividade Swipe para deslizar para baixo no aviso de cartão de bloqueio.

      Essa ação permite que você confirme a ação selecionando Bloquear cartão.

   6. Adicione uma atividade Tap para selecionar Bloquear cartão.
   Figura 2. Atividades usadas para bloquear o cartão de débito
   

   

   
   
4. Faça uma captura de tela de uma reivindicação:
   1. Adicione uma atividade Tap para selecionar o botão Voltar e retorne ao menu principal.
   2. Adicione uma atividade Swipe para deslizar para baixo no menu principal até que a seção Visualizar Minhas Reivindicações apareça.
   3. Use uma atividade Tap para selecionar a seção Visualizar Minhas Reivindicações.
   4. Adicione uma atividade Tap para selecionar Ver detalhes para a primeira reivindicação.
   5. Use a API TakeScreenshot para fazer uma captura de tela dos primeiros detalhes da reclamação.
   Figura 3. Atividades usadas para fazer uma captura de tela de uma reivindicação
   

   

   
   
5. Por fim, depois de fazer a captura de tela, voltamos ao menu principal do aplicativo, usando a atividade Tap para selecionar o elemento de interface gráfica Voltar duas vezes.

Utilização de automação programada

Pré-requisitos

Para automatizar um aplicativo móvel usando APIs, grave os elementos móveis do aplicativo dentro do Repositório de Objetos do projeto.Para esse exemplo, criamos um aplicativo BankOfAmerica com um MobileScreen geral, contendo todos os elementos de interface do usuário que usamos para automatizar. Para criar elementos de interface do usuário para celular, estabeleça uma conexão no Mobile Device Manager (MDM) entre o dispositivo de destino e o aplicativo. Em seguida, diretamente no painel Repositório de Objetos, crie cada elemento e use Indicar Elemento para indicar o elemento de interface do usuário específico no dispositivo MDM.

Verifique a lista a seguir para a estrutura do Repositório de Objetos:

• Aplicativo do BankOfAmerica, menu MobileScreen
  • backFromClaimDetails
  • backFromClaimStatus
  • BackToMenu
  • firstClaimSeeDetails
  • Lock
  • LockCard
  • Login
  • ManageDebitCredit
  • Menu
  • Senha
  • swipeMenu
  • ID do Usuário
  • viewmyclaims

Etapas

1. Estabeleça uma conexão entre o dispositivo e o aplicativo:
   1. Crie uma variável do tipo Connection, usando a API Connect, com a segunda versão de sobrecarga.

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

      [TestCase]
              public void Execute()
              {
                  Connection connection = mobile.Connect(
                  "Android mobile device", 
                  "BankOfAmericaSimulator");
      
                  Log("Connection established");

2. Opcionalmente, para fins de depuração, você pode adicionar uma mensagem Log após a conexão.
3. Faça login no aplicativo móvel:
   1. Chame a API Tap para clicar no campo ID do usuário.

      Essa ação permite que você insira o nome de usuário.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.UserId);

   2. Use a API SetText para inserir um nome de usuário no campo ID do usuário.

      connection.SetText(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.UserId, 
          "[e-mail]", 
          MobileOptions.SetText().WithSendNewline(false));

   3. Chame a API Tap para selecionar o campo Senha para que você possa inserir a senha.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Password);

   4. Use a API SetText para inserir uma senha no campo Senha.
      O método WithSendNewLine(false) garante que o elemento de teclado OK não seja pressionado no dispositivo móvel após o envio do texto. Para obter mais informações sobre as opções disponíveis da API Set Text, acesse Classe MobileOptions.SetTextOptions.

      connection.SetText(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Password, "abcde", MobileOptions.SetText().WithSendNewline(false));

   5. Utilizar a API Tap para selecionar Login.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Login);

4. Bloquear um cartão de débito ou de crédito:
   1. Navegue até o menu do aplicativo de banco móvel, usando a API Tap:

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Menu);

   2. Deslize para baixo no menu, usando a API Swipe.

      O objetivo é deslizar até que você encontre a seção Gerenciar Débito/Crédito.

      connection.Swipe(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.swipeMenu, 
          ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.ManageDebitCredit, 
          SwipeDirection.Down,     
          4);

   3. Selecione a seção Gerenciar Débito/Crédito usando a API Tap.
      O método WithTimeout() permite que a API pause por um número predeterminado de segundos. Essa pausa dura até que o elemento de interface gráfica de usuário de destino apareça ou um erro seja gerado.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.ManageDebitCredit, TapTypeEnum.Single, MobileOptions.Tap().WithTimeout(120));

   4. Para o primeiro cartão que é exibido, selecione o ícone Bloquear usando a API Tap.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.Lock);

   5. Deslize para baixo no aviso de cartão de bloqueio, usando a API Directional Swipe para que possamos confirmar a ação selecionando Bloquear cartão.

      connection.DirectionalSwipe(SwipeDirection.Down);

   6. Selecione Bloquear cartão usando a API Tap.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.LockCard);

5. Faça uma captura de tela de uma reivindicação.
   1. Volte ao menu principal, usando a API Tap e o ícone de retorno.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.BackToMenu);

   2. Deslize para baixo no menu principal, até que a seção Visualizar Minhas Reivindicações apareça.
      Para essa etapa, usamos a API Swipe, desta vez utilizando a sexta sobrecarga. Essa sobrecarga requer um IElementDescriptor para o contêiner, e um SelectorTarget para o elemento de interface gráfica de destino.
      Primeiro criamos um SelectorTarget para a seção Visualizar Minhas Reivindicações e, em seguida, utilize a API Swipe.
      1. Abra o Gerenciamento de Dispositivos Móveis (MDM) e crie a conexão entre o dispositivo móvel e o aplicativo.
      2. Acesse o Repositório de Objetos e crie um novo elemento para a tela do celular.
      3. Selecione Indicar Elemento.
      4. No menu de opções de seleção, copie o controle web identificado pelos seletores.

         Para este aplicativo bancário móvel, você tem que garantir que seletores WebView como seletores nativos sejam selecionados como uma opção de seleção.

      5. Retorne ao editor de código e crie uma variável do tipo SelectorTarget. Use o método MobileTarget.FromSelector, que requer como argumento o controle web que você copiou anteriormente.

         SelectorTarget viewMyClaimsTarget = MobileTarget.FromSelector("<mbl android:className='android.widget.TextView' text='View My Claims' />");

      6. Use a API Swipe, com a variável SelectorTarget para finalizar a ação de deslizar para baixo.

         connection.Swipe(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.swipeMenu, viewMyClaimsTarget, SwipeDirection.Down, 20);

   3. Toque na seção Visualizar Minhas Reivindicações.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.viewmyclaims);

   4. Toque em Ver detalhes para a primeira reivindicação.

      connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.firstClaimSeeDetails);

   5. Use a API TakeScreenshot para fazer uma captura de tela dos primeiros detalhes da reclamação.

      connection.TakeScreenshot();

6. Por fim, depois de fazer a captura de tela, retornamos ao menu principal do aplicativo, tocando no elemento Voltar do elemento de interface gráfica duas vezes.

   connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.backFromClaimDetails);
       connection.Tap(ObjectRepository.Descriptors.BankOfAmerica.MobileScreen.backFromClaimStatus);