A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

IMetricCollector

public interface IMetricCollector
implements ILogSaverListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

Subclasses indiretas conhecidas

BaseDeviceMetricCollector, BugreportzOnFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, GcovCodeCoverageCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, ScreenshotOnFailureCollector

BaseDeviceMetricCollector	Implementação básica de `IMetricCollector` que permite iniciar e interromper a coleta em `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` e `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BugreportzOnFailureCollector	Coletar um relatório de bug quando um caso de teste falhar.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Clang do dispositivo e as registra como artefatos de teste.
CountTestCasesCollector	Contar e informar o número de casos de teste para um determinado `IRemoteTest`.
DebugHostLogOnFailureCollector	Coletor que vai coletar e registrar os registros do host quando ocorrer uma falha no caso de teste.
FilePullerDeviceMetricCollector	Um `BaseDeviceMetricCollector` que detecta a chave de métricas vinda do dispositivo e as extrai como um arquivo do dispositivo.
FilePullerLogCollector	Gerenciou o arquivo informado pelo dispositivo.
GcovCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do gcov do dispositivo e as registra como artefatos de teste.
JavaCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Java do dispositivo e as registra como artefatos de teste.
LogcatOnFailureCollector	Coletor que vai capturar e registrar um logcat quando um caso de teste falhar.
ScreenshotOnFailureCollector	Coletor que vai capturar e registrar uma captura de tela quando um caso de teste falhar.

Essa interface será adicionada como um decorador ao informar os resultados dos testes para coletar as métricas correspondentes.

Essa interface não pode ser usada como , mesmo que estenda ITestInvocationListener. A verificação de configuração vai rejeitá-lo. Ele precisa ser usado como um "metrics_collector".

Os coletores não precisam manter um estado interno, porque podem ser reutilizados em vários lugares. Se um estado interno realmente precisar ser usado, ele precisará ser limpo em init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

Resumo

Métodos públicos
`abstract`	`getBuildInfos()` Retorna a lista de informações de build disponíveis na invocação.
`abstract`	`getDevices()` Retorna a lista de dispositivos disponíveis na invocação.
`abstract ITestInvocationListener`	`getInvocationListener()` Retorna o `ITestInvocationListener` original para onde os resultados estão sendo encaminhados.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicialização do coletor com o contexto atual e onde encaminhar os resultados.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando um caso de teste falha com falha de suposição.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Chamada de retorno quando um caso de teste é encerrado.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Chamada de retorno quando um caso de teste é encerrado.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Chamada de retorno quando um caso de teste falha.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Chamada de retorno quando uma execução de teste é encerrada.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback quando uma execução de teste é iniciada.
`abstract void`	`onTestStart(DeviceMetricData testData)` Callback quando um caso de teste é iniciado.

Métodos públicos

getBuildInfos

public abstract  getBuildInfos ()

Retorna a lista de informações de build disponíveis na invocação.

Retorna

getDevices

public abstract  getDevices ()

Retorna a lista de dispositivos disponíveis na invocação.

Retorna

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Retorna o ITestInvocationListener original para onde os resultados estão sendo encaminhados.

Retorna
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialização do coletor com o contexto atual e onde encaminhar os resultados. Será chamado apenas uma vez por instância, e o coletor precisa atualizar o contexto e o listener interno. O método de inicialização nunca será chamado durante uma execução de teste.

Não substitua, a menos que você saiba o que está fazendo.

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` para a invocação em andamento.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` em que os resultados serão colocados.

Retorna
`ITestInvocationListener`	o novo listener que envolve o original.

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback quando um caso de teste falha com falha de suposição.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados do caso de teste.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Chamada de retorno quando um caso de teste é encerrado. É hora de limpar.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que armazena 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 `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Chamada de retorno quando um caso de teste é encerrado. É hora de limpar.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que armazena 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 `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Chamada de retorno quando um caso de teste falha.

Parâmetros
`testData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados do caso de teste.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Chamada de retorno quando uma execução de teste é encerrada. É hora de limpar.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados da execução. Será o mesmo objeto que durante `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: o mapa atual de métricas transmitidas para `ITestLifeCycleReceiver.testRunEnded(long, Map)`.

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback quando uma execução de teste é iniciada.

Parâmetros
`runData`	`DeviceMetricData`: o `DeviceMetricData` que armazena os dados da execução.

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback quando um caso de teste é iniciado.

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