Encontrar os resultados do teste da plataforma do dispositivo de desenvolvimento

Neste guia, descrevemos como encontrar os resultados dos testes acionados seguindo o guia Execução de dispositivo na plataforma de dispositivo do desenvolvedor.

Antes de começar

Estas etapas pressupõem que você já criou um projeto Google Cloud , concluiu as etapas de configuração no guia de início rápido da plataforma de dispositivos para desenvolvedores e fez a autenticação com gcloud no terminal.

Na linha de comando

Confira um resumo básico do resultado do teste com este comando e seu ID de sessão:

gcloud beta device-run sessions describe SESSION_ID

que retorna resultados semelhantes a:

Session SESSION_ID finished with result [FAILED].
Result files are stored at [https://console.cloud.google.com/storage/browser/BUCKET_NAME/automation/sessions/SESSION_ID/].
JOB NAME  EXECUTION NAME  EXECUTION RESULT
job-000   all             FAILED: 2 test cases failed, 5 passed
job-001   all             PASS

Para cada ID de tipo de dispositivo especificado com a flag --device, um job é gerado na sessão. O índice do job vai seguir a ordem dos IDs dos dispositivos. As falhas de teste são esperadas e precisam ser investigadas e resolvidas com melhorias e execuções iterativas.

Para mais detalhes sobre uma sessão de teste, adicione --full ao comando describe executado anteriormente:

gcloud beta device-run sessions describe SESSION_ID --full

que retorna resultados semelhantes a:

name: projects/PROJECT_ID/locations/global/sessions/session-370961e1
sessionConfig:
  displayName: instrumentation-session
  jobConfigs:
  -   action:
      androidInstrumentationTest:
        testInstallable:
          files:
          -   gcsInputFile:
              path: gs://BUCKET_NAME/automation/inputs/2026-07-30_11:28.31915956_8514/app_name_test.apk
    allocationConfig:
      deviceConfigs:
      -   actions:
        -   androidInstallPackages:
            installables:
            -   files:
              -   gcsInputFile:
                  path: gs://BUCKET_NAME/automation/inputs/2026-07-30_11:28.31915956_8514/app_name.apk
        -   androidLogcat: {}
        requirement:
          deviceId: pa3q-35
    displayName: job-000
  outputDirectoryConfig:
    gcsOutputDirectory:
      path: gs://BUCKET_NAME/automation/sessions
sessionReport:
  endTime: '2026-07-30T03:30:05.838Z'
  id: 6587313f-fdf7-418a-a9b9-b6fa98dff838
  jobReports:
  -   displayName: job-000
    endTime: '2026-07-30T03:30:04.601Z'
    executionReports:
    -   displayName: all
      endTime: '2026-07-30T03:30:02.151Z'
      id: 29b167dd-dde9-4ea9-b2cd-738049083fc9
      outputFiles:
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/logcat.txt
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/instrument.log
      -   gcsOutputFile:
          path: gs://PROJECT_ID-devicerun/automation/sessions/session-370961e1/job-000/execution-000/junit.xml
      result:
        cause:
          summary:
            message: One or more test assertions or test methods failed. Inspect the
              test runner logs and structured test results for details.
            reason: TEST_CASE_FAILURE
            type: CUSTOMER
        resultType: FAILED
      startTime: '2026-07-30T03:29:32.769Z'
      status:
        progressMessages:
        -   2 test cases failed, 5 passed
        statusType: DONE
    id: 7974e37a-2928-4aaf-abba-3a8b6bae853b
    result:
      cause:
        summary:
          message: Job has one or more failed tests. See execution reports for details.
          reason: JOB_HAS_FAILED_TESTS
      resultType: FAILED
    startTime: '2026-07-30T03:28:53.756Z'
    status:
      statusType: DONE
  result:
    cause:
      summary:
        message: Session has one or more failed jobs. See job reports for details.
        reason: SESSION_HAS_FAILED_JOBS
    resultType: FAILED
  startTime: '2026-07-30T03:28:52.702Z'
  status:
    statusType: DONE

Em um navegador da Web

Para mais detalhes, carregue o URL no bucket que contém os resultados do teste da saída. Ele deve ser parecido com: https://console.cloud.google.com/storage/browser/BUCKET_NAME/automation/sessions/SESSION_ID/

As sessões aparecem no seguinte formato de caminho no armazenamento: gs://BUCKET_NAME/automation/sessions/SESSION_ID/job-000/EXECUTION_ID/

Para procurar seus registros na interface da Web do console Google Cloud , siga estas etapas:

  1. Em um navegador, adicione o nome do projeto usado no comando gcloud config set project ao URL https://console.cloud.google.com/?project= e carregue a página.
  2. Expanda o menu no canto superior esquerdo.
  3. Encontre Cloud Storage.
  4. No menu de armazenamento, selecione Buckets.
  5. Na primeira coluna, clique no nome do projeto.
  6. Clique em Automação.
  7. Clique em Sessões.
  8. No campo Filtro, cole o ID da sessão da sua execução de teste mais recente. Consulte a saída do teste.
  9. Clique no nome da sessão resultante.
  10. Selecione job-* para ver junit.xml, que contém detalhes abrangentes dos resultados em todos os casos de teste.
  11. Abra execution-* para ver um detalhamento de cada fragmento individual. Nessa pasta, navegue até:
    • instrumentation.log: os registros brutos do teste de instrumentação do Android.
    • system.log: o syslog bruto do sistema iOS que contém registros do dispositivo e da estrutura.
    • logcat.txt: arquivo logcat do Android.
    • junit.xml: o relatório XML do JUnit que detalha os casos de teste aprovados ou reprovados.
    • *.ips: registros de falhas de diagnóstico do iOS (se ocorreram falhas).
  12. Acesse os URLs públicos e autenticados para entender os resultados do teste.

Estrutura do arquivo

Analise os arquivos de registro no bucket do Cloud Storage para entender melhor a falha do teste. A estrutura do arquivo é semelhante a esta:

-   gs://BUCKET_NAME/automation
  -   inputs/
    -   2026-05-29_10:13.026220_JZTM
      -   app.apk
      -   test.apk
  -   sessions/
    -   SESSION_ID
      -   job-000/
        -   junit.xml
        -   execution-000/
          -   instrumentation.log
          -   junit.xml
          -   logcat.txt
          -   video.mp4
        -   execution-001/
          -   instrumentation.log
          -   junit.xml
          -   logcat.txt
          -   video.mp4
      -   job-001/
    -   SESSION_ID

Entenda os resultados

Os arquivos junit.xml gerados na saída são arquivos XML JUnit padrão. Esses arquivos contêm os resultados por método de teste, permitindo que você analise o status específico de aprovação ou falha, o tempo de execução e os rastreamentos de erros de cada método de teste individual. É possível integrar e analisar esse arquivo com a maioria dos sistemas de integração e entrega contínuas (CI/CD) e ferramentas de geração de relatórios de teste.

Documentação de apoio

A seguir

Em seguida, teste a API Device Streaming da plataforma de dispositivos para desenvolvedores.