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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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`