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.

Coletor IMetric

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

Subclasses indiretas conhecidas

AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFail ureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector e 12 outros.

AtraceCollector	Um `IMetricCollector` que executa umtrace durante um teste e coleta o resultado e registra-o na invocação.
Coletor AtraceRunMetric	Coleta os rastreamentos de todo o diretório de teste no diretório fornecido do dispositivo de teste, registra o diretório de teste e pós-processa os arquivos de rastreamento no diretório de teste e agrega as métricas.
BaseDeviceMetricCollector	Implementação básica de `IMetricCollector` que permite iniciar e parar a coleta em `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` e `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
BluetoothConnectionLatencyCollector	O coletor enviará uma configuração de métrica de duração statsd predefinida para os dispositivos e coletará a duração da conexão Bluetooth para cada perfil.
BluetoothConnectionStateCollector	Este coletor coletará métricas BluetoothConnectionStateChanged e registrará o número do estado da conexão para cada perfil.
BluetoothHciSnoopLogCollector	Coletor para ativar o registro de espionagem Bluetooth HCI no DUT e coletar o registro para cada teste.
BugreportzOnFailureCollector	Colete um bugreportz quando um caso de teste falhar.
BugreportzOnTestCaseFailureCollector	Colete um bugreportz quando um caso de teste falhar em uma execução.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá medições de cobertura Clang do dispositivo e as registrará como artefatos de teste.
CountTestCasesCollector	Conte e relate o número de casos de teste para um determinado `IRemoteTest` .
DebugHostLogOnFailureCollector	Coletor que reunirá e registrará os logs do lado do host quando ocorrer uma falha no caso de teste.
Coletor DeviceTrace	Coletor que iniciará o rastreamento perfeito quando uma execução de teste for iniciada e registrará o arquivo de rastreamento no final.
FilePullerDeviceMetricCollector	Um `BaseDeviceMetricCollector` que escuta a chave de métricas proveniente do dispositivo e as extrai como um arquivo do dispositivo.
FilePullerLogCollector	Registrador do arquivo relatado pelo lado do dispositivo.
Coletor GcovCodeCoverage	Um `BaseDeviceMetricCollector` que extrairá medições de cobertura gcov do dispositivo e as registrará como artefatos de teste.
GcovKernelCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá medições de cobertura do kernel gcov do debugfs e do dispositivo e, finalmente, as registrará como artefatos de teste.
HostStatsdMetricCollector	Um `IMetricCollector` que coleta métricas statsd do lado do host usando comandos do utilitário statsd.
JavaCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá medições de cobertura Java do dispositivo e as registrará como artefatos de teste.
LogcatOnFailureCollector	Coletor que capturará e registrará um logcat quando um caso de teste falhar.
LogcatTimingMetricCollector	Um coletor de métrica que coleta informações de tempo (por exemplo, tempo de troca do usuário) do logcat durante um ou vários testes repetidos usando determinados padrões de regex para analisar sinais de início e fim de um evento a partir de linhas de logcat.
MóduloLogcatCollector	Versão do coletor logcat, mas para módulo.
PerfettoPullerMetricCollector	Implementação básica do `FilePullerDeviceMetricCollector` que permite extrair os arquivos perfeitos do dispositivo e coletar as métricas dele.
RebootReasonCollector	Coletor que coleta reinicializações do dispositivo durante a execução do teste e as reporta por motivo e contagens.
RuntimeRestartCollector	Coletor que coleta carimbos de data/hora de reinicializações de tempo de execução (travamentos do servidor do sistema) durante a execução do teste, se houver.
Captura de telaOnFailureCollector	Coletor que irá capturar e registrar uma captura de tela quando um caso de teste falhar.
ShowmapPullerMetricCollector	Implementação básica do `FilePullerDeviceMetricCollector` que permite extrair os arquivos showmap do dispositivo e coletar as métricas dele.
TraceCmdCollector	Um `IMetricCollector` que coleta rastreamentos durante o teste usando trace-cmd e os registra na invocação.

Esta interface será adicionada como decorador ao relatar resultados de testes para coletar métricas correspondentes.

Esta interface não pode ser usada como até estende ITestInvocationListener . A verificação da configuração irá rejeitá-lo. Deve ser usado como "metrics_collector".

Não se espera que os coletores mantenham um estado interno, pois podem ser reutilizados em vários locais. Se um estado interno realmente precisar ser usado, ele deverá ser limpo em init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) .

Resumo

Métodos públicos
`default boolean`	`captureModuleLevel ()` Se o coletor é ou não aplicável à captura em nível de módulo e deve ser init.
`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 estamos encaminhando os resultados.
`abstract ITestInvocationListener`	`init ( IInvocationContext context, ITestInvocationListener listener)` Inicialização do coletor com o contexto atual e para onde encaminhar os resultados.
`abstract void`	`onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)` Retorno de chamada quando um caso de teste falha com falha de suposição.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Retorno de chamada quando um caso de teste é finalizado.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` Retorno de chamada quando um caso de teste é finalizado.
`abstract void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` Retorno de chamada quando um caso de teste falha.
`default void`	`onTestModuleEnded ()` Permite capturar o evento de término do módulo.
`default void`	`onTestModuleStarted ()` Permite capturar o evento de módulo iniciado.
`abstract void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` Retorno de chamada quando uma execução de teste é encerrada.
`abstract void`	`onTestRunStart ( DeviceMetricData runData)` Retorno de chamada quando uma execução de teste é iniciada.
`default void`	`onTestRunStart ( DeviceMetricData runData, int testCount)` Retorno de chamada quando uma execução de teste é iniciada.
`abstract void`	`onTestStart ( DeviceMetricData testData)` Retorno de chamada quando um caso de teste é iniciado.

Métodos públicos

captureModuleLevel

public boolean captureModuleLevel ()

Se o coletor é ou não aplicável à captura em nível de módulo e deve ser init.

Devoluções
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

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

Devoluções

getDispositivos

public abstract  getDevices ()

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

Devoluções

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Retorna o ITestInvocationListener original para onde estamos encaminhando os resultados.

Devoluções
`ITestInvocationListener`

iniciar

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialização do coletor com o contexto atual e para onde encaminhar os resultados. Será chamado apenas uma vez por instância e espera-se que o coletor atualize seu contexto interno e ouvinte. Init nunca será chamado durante uma execução de teste antes.

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` onde colocar os resultados.

Devoluções
`ITestInvocationListener`	o novo ouvinte envolvendo o original.

Lança
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

Lança
`DeviceNotAvailableException`

onTestEnd

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

Retorno de chamada quando um caso de teste é finalizado. Este deve ser o momento da limpeza.

Parâmetros
`testData`	`DeviceMetricData` : o `DeviceMetricData` que contém os dados do caso de teste. Será o mesmo objeto de `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentTestCaseMetrics`	: o mapa atual de métricas passado para `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` .
`test`	`TestDescription` : o `TestDescription` do caso de teste em andamento.

Lança
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Retorno de chamada quando um caso de teste é finalizado. Este deve ser o momento da limpeza.

Parâmetros
`testData`	`DeviceMetricData` : o `DeviceMetricData` que contém os dados do caso de teste. Será o mesmo objeto de `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` .
`currentTestCaseMetrics`	: o mapa atual de métricas passado para `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` .

Lança
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Retorno de chamada quando um caso de teste falha.

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

Lança
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Permite capturar o evento de término do módulo.

Lança
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar o evento de módulo iniciado.

Lança
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Retorno de chamada quando uma execução de teste é encerrada. Este deve ser o momento da limpeza.

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

Lança
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Retorno de chamada quando uma execução de teste é iniciada.

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

Lança
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Retorno de chamada quando uma execução de teste é iniciada.

Parâmetros
`runData`	`DeviceMetricData` : o `DeviceMetricData` que contém os dados da execução.
`testCount`	`int` : o número de casos de teste nesta execução de teste.

Lança
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Retorno de chamada quando um caso de teste é iniciado.

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

Lança
`DeviceNotAvailableException`