Jornada de Testes de UI Android

Visão Geral

Esta habilidade descreve o fluxo de trabalho padrão para executar testes de Jornada de Usuário especificados em XML em aplicativos Android. Uma "jornada" é um conjunto sequenciado de ações do usuário e asserções de estado projetadas para verificar a funcionalidade de ponta a ponta. O XML da jornada atua como a fonte da verdade para o comportamento do aplicativo. O executor procede sequencialmente, realizando interações de UI, verificando asserções de estado e escrevendo um relatório de resultado JSON padronizado.

Quando Usar

• Use ao avaliar o comportamento da UI de um aplicativo Android em relação a uma especificação de teste em XML.
• Use ao automatizar fluxos de usuário de várias etapas (por exemplo, login, checkout, navegação) e verificar expectativas.
• Use ao executar testes de verificação e gerar relatórios de teste JSON padronizados.
• Use ao depurar fluxos de aplicativos em dispositivos físicos ou emuladores usando comandos ADB.

Como Funciona

graph TD
    A[Parse Journey XML] --> B[Execute Action / Interaction]
    B --> C{Success?}
    C -- Yes --> D[Verify State Expectation / Assertion]
    C -- No/Crash --> G[Mark FAILED & Exit]
    D -- Passed --> E{More Steps?}
    D -- Failed --> G
    E -- Yes --> B
    E -- No --> F[Output JSON Summary]

Etapa 1: Analisar a Especificação da Jornada

Leia e analise a estrutura do conjunto de testes XML. O nó raiz <journey> define o nome do caso de teste, e o bloco <actions> contém a sequência de etapas do teste.

<journey name="Search and Cart Flow">
   <description>Verify that searching for an item and adding it to the cart succeeds.</description>
   <actions>
      <action>Search for soda</action>
      <action>Tap the first search result</action>
      <action>Verify that the product detail screen is shown</action>
   </actions>
</journey>

Etapa 2: Avaliação Sequencial das Etapas

Processe cada elemento <action> na ordem exata especificada. As etapas de teste são classificadas em dois grupos:

A. Ações Interativas (Toques, Deslizamentos, Entrada de Texto)

Execute a interação física da UI usando ADB.

• Toque: Toque no centro dos limites do elemento alvo:

  adb shell input tap <x> <y>
  

• Deslizar/Rolar: Deslize de uma coordenada para outra com uma duração:

  adb shell input swipe <x1> <y1> <x2> <y2> <duration_ms>
  

• Digitar Texto: Digite texto no campo de entrada ativo:

  adb shell input text "<string>"
  

Se o elemento estiver ausente ou a ação não puder ser executada, a ação e a jornada falharão.

B. Asserções de Estado (Verificação de Expectativas)

Etapas que começam com "verificar", "checar" ou "garantir" representam asserções de estado.

• Inspecione a tela atual (usando capturas de tela ou uiautomator dump) sem interagir ou rolar.
• Confirme se todas as sub-asserções são atendidas. Por exemplo, "Verificar se o aplicativo está na tela inicial e o logotipo está visível" falha se a tela inicial não for exibida ou o logotipo estiver ausente.

Etapa 3: Lidar com Falhas e Travamentos

Se o aplicativo travar, sair, congelar ou falhar em uma asserção:

1. Pare imediatamente a execução da jornada.
2. Marque a etapa com falha como FAILED.
3. Marque quaisquer etapas subsequentes como SKIPPED.
4. Documente o motivo exato da falha.

Etapa 4: Gerar Relatório JSON

Formate os resultados da execução em um esquema JSON padronizado e escreva-o no log de saída.

Exemplos

Exemplo 1: Especificação Completa da Jornada em XML

<journey name="Login and Profile Edit">
   <description>Logs into the app, navigates to settings, and changes user profile information.</description>
   <actions>
      <action>Verify that the username input field is visible</action>
      <action>Tap the username input field</action>
      <action>Type "testuser" into the input</action>
      <action>Tap the password input field</action>
      <action>Type a redacted test password into the input</action>
      <action>Tap the "Login" button</action>
      <action>Verify that the Home dashboard is visible and user profile photo is shown</action>
   </actions>
</journey>

Exemplo 2: Relatório de Resultado JSON Padrão

{
  "journey": "Login e Edição de Perfil",
  "results": [
    {
      "action": "Verificar se o campo de entrada de nome de usuário está visível",
      "status": "PASSOU",
      "commands": [],
      "comment": "Entrada de nome de usuário detectada nos limites [100,200][980,300] via dump de UI."
    },
    {
      "action": "Tocar no campo de entrada de nome de usuário",
      "status": "PASSOU",
      "commands": [
        "adb shell input tap 540 250"
      ],

…