Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

DeviceTraceCollector

public class DeviceTraceCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.DeviceTraceCollector

Coletor que inicia o rastreamento do Perfetto quando uma execução de teste começa e registra o arquivo de rastreamento no final.

Resumo

Construtores públicos
`DeviceTraceCollector()`

Métodos públicos
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback quando um caso de teste é encerrado.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback quando a execução de um teste é encerrada.
`void`	`onTestStart(DeviceMetricData testData)` Callback quando um caso de teste é iniciado.
`void`	`rebootEnded(ITestDevice device)` Recebe uma notificação quando a reinicialização é concluída no dispositivo.
`void`	`rebootStarted(ITestDevice device)` Recebe uma notificação quando a reinicialização é iniciada no dispositivo.
`void`	`setInstrumentationPkgName(String packageName)`

Construtores públicos

DeviceTraceCollector

public DeviceTraceCollector ()

Métodos públicos

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Gera
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Callback quando um caso de teste é encerrado. Esse é o momento de fazer a limpeza.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste. Será o mesmo objeto em `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: o mapa atual de métricas transmitido para `testEnded(TestDescription,Map)`.

Gera
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Callback quando a execução de um teste é encerrada. Esse é o momento de fazer a limpeza.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados da execução. Será o mesmo objeto em `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: o mapa atual de métricas transmitido para `testRunEnded(long,Map)`.

Gera
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback quando um caso de teste é iniciado.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que contém os dados do caso de teste.

Gera
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Recebe uma notificação quando a reinicialização é concluída no dispositivo.

OBSERVAÇÃO: os receptores precisam evitar a reinicialização durante esse callback. Qualquer tentativa de reinicialização será ignorada.

Parâmetros
`device`	`ITestDevice`: `ITestDevice` em que a reinicialização foi concluída.

Gera
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Recebe uma notificação quando a reinicialização é iniciada no dispositivo.

OBSERVAÇÃO: os receptores precisam evitar a reinicialização durante esse callback. Qualquer tentativa de reinicialização será ignorada.

Parâmetros
`device`	`ITestDevice`: `ITestDevice` em que a reinicialização foi iniciada.

Gera
`DeviceNotAvailableException`

setInstrumentationPkgName

public void setInstrumentationPkgName (String packageName)

Parâmetros
`packageName`	`String`