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.

Esta página foi traduzida pela API Cloud Translation.

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`