A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à 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, currentTestCaseMetrics)` Callback quando um caso de teste é encerrado.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback quando uma execução de 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 termina 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, 
                 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 que durante `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: o mapa atual de métricas transmitidas para `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Gera
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback quando uma execução de 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 que durante `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: o mapa atual de métricas transmitidas para `ERROR(/#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 termina 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 começou.

Gera
`DeviceNotAvailableException`

setInstrumentationPkgName

public void setInstrumentationPkgName (String packageName)

Parâmetros
`packageName`	`String`