Este guia descreve como encontrar os resultados de testes acionados seguindo o guia Execução de dispositivos da plataforma de dispositivos para desenvolvedores.
Antes de começar
Estas etapas pressupõem que você já criou um Google Cloud projeto,
concluiu as etapas de configuração na plataforma de dispositivos para desenvolvedores
Guia de início rápido 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 o ID da sessão:
gcloud beta device-run sessions describe your_session_id
Que retorna resultados semelhantes a:
Session [session-number] finished with result [FAILED].
Result files are stored at [https://console.cloud.google.com/storage/browser/<your_project_id>/automation/sessions/session-number/].
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 segue a ordem dos IDs de dispositivo. As falhas de teste são esperadas e precisam ser investigadas e resolvidas por melhorias e execuções iterativas.
gcloud beta device-run sessions describe your_session_id --full
Que retorna resultados semelhantes a:
name: projects/your-project-id/locations/global/sessions/session-370961e1
sessionConfig:
displayName: instrumentation-session
jobConfigs:
- action:
androidInstrumentationTest:
testInstallable:
files:
- gcsInputFile:
path: gs://your-project-id-devicerun/automation/inputs/2026-07-30_11:28.31915956_8514/app_name_test.apk
allocationConfig:
deviceConfigs:
- actions:
- androidInstallPackages:
installables:
- files:
- gcsInputFile:
path: gs://your-project-id-devicerun/automation/inputs/2026-07-30_11:28.31915956_8514/app_name.apk
- androidLogcat: {}
requirement:
deviceId: pa3q-35
displayName: job-000
outputDirectoryConfig:
gcsOutputDirectory:
path: gs://your-project-id-devicerun/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://your-project-id-devicerun/automation/sessions/session-370961e1/job-000/execution-000/logcat.txt
- gcsOutputFile:
path: gs://your-project-id-devicerun/automation/sessions/session-370961e1/job-000/execution-000/instrument.log
- gcsOutputFile:
path: gs://your-project-id-devicerun/automation/sessions/session-370961e1/job-000/execution-000/test_result.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
No navegador da Web
Para mais detalhes, carregue o URL do bucket que contém os resultados do teste na saída do teste. Ele deve ser semelhante a:
https://console.cloud.google.com/storage/browser/storage/browser/<your_project_id>/automation/sessions/<session_id>
Navegação
Para procurar seus registros na interface da Web do Google Cloud Console, siga estas etapas:
- Em um navegador, anexe o nome do projeto usado no comando
gcloud config set projectao URLhttps://console.cloud.google.com/?project=e carregue a página. - Expanda o menu no canto superior esquerdo.
- Encontre Cloud Storage.
- No menu de armazenamento, selecione Buckets.
- Na primeira coluna, clique no nome do projeto.
- Clique em Automação.
- Clique em Sessões.
- No campo Filtro, cole o ID da sessão da execução de teste mais recente (consulte a saída do teste).
- Clique no nome da sessão resultante.
- Selecione job-* para conferir
test_result_merged.xml, que contém detalhes abrangentes dos resultados em todos os casos de teste. - Abra execution-* para conferir um detalhamento de cada fragmento individual. Nessa pasta, navegue até:
instrumentation.loglogcat.txttest_result.xml
- Acesse os URLs públicos e autenticados para entender os resultados do teste.
Estrutura do arquivo
Explore os arquivos de registro no bucket do Cloud Storage para entender melhor a falha do teste. A estrutura do arquivo é semelhante a:
- gs://my_project_id_devicerun/automation
- inputs/
- 2026-05-29_10:13.026220_JZTM
- app.apk
- test.apk
- sessions/
- session-number
- job-000/
- test_results_merged.xml
- execution-000/
- instrumentation.log
- test_result.xml
- logcat.txt
- video.mp4
- execution-001/
- instrumentation_output.txt
- junit.xml
- logcat.txt
- video.mp4
- job-001/
- session-number
Entender os resultados
O arquivo test_result.xml ou test_result_merged.xml gerado na saída é um arquivo XML JUnit padrão. Esse arquivo contém os resultados por método de teste, permitindo que você revise o status de aprovação ou falha específico, 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 contínua e entrega contínua (CI/CD) e ferramentas de geração de relatórios de teste.
Documentação de suporte
- Conceitos básicos para testes de apps Android
- Criar testes instrumentados
- Sobre os buckets do Cloud Storage
A seguir
Em seguida, teste nossa API Device Streaming da plataforma de dispositivos para desenvolvedores .