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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Subclasses diretas conhecidas

AtraceCollector	Um `IMetricCollector` que executa um rastreamento durante um teste e coleta o resultado e o registro para a invocação.
BugreportzOnFailureCollector	Coleta um bugreportz quando um caso de teste falha.
BugreportzOnTestCaseFailureCollector	Coletar um bugreportz quando um caso de teste em uma execução falhar.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Clang do dispositivo e as registra como artefatos de teste.
CodeCoverageCollector	Um `BaseDeviceMetricCollector` que vai extrair medições de cobertura nativa e Java do dispositivo e as registrar como artefatos de teste.
CountTestCasesCollector	Conta e informa o número de casos de teste para um determinado `IRemoteTest`.
DebugHostLogOnFailureCollector	Coletor que vai reunir e registrar os registros do lado do host quando ocorrer uma falha no caso de teste.
DeviceTraceCollector	Coletor que inicia o rastreamento do Perfetto quando uma execução de teste começa e registra o arquivo de rastreamento no final.
FilePullerDeviceMetricCollector	Um `BaseDeviceMetricCollector` que detecta a chave de métricas do dispositivo e as extrai como um arquivo.
GcovCodeCoverageCollector	Um `BaseDeviceMetricCollector` que vai extrair as medições de cobertura do gcov do dispositivo e registrá-las como artefatos de teste.
GcovKernelCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do kernel gcov do debugfs e do dispositivo e, por fim, as registra como artefatos de teste.
HostStatsdMetricCollector	Um `IMetricCollector` que coleta métricas do statsd do lado do host usando comandos do utilitário statsd.
JavaCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai medições de cobertura do Java do dispositivo e as registra como artefatos de teste.
LogcatOnFailureCollector	Coletor que captura e registra um logcat quando um caso de teste ou uma execução de teste falha.
LogcatTimingMetricCollector	Um coletor de métricas que coleta informações de tempo (por exemplo, tempo de troca de usuário) do logcat durante um ou vários testes repetidos usando padrões regex específicos para analisar sinais de início e fim de um evento das linhas do logcat.
ModulePerfettoCollector	Coletor que inicia o rastreamento do perfetto quando um módulo de teste começa e termina e o dispositivo é reiniciado.
RebootReasonCollector	Coletor que coleta reinicializações de dispositivos durante o teste e as informa por motivo e contagem.
RuntimeRestartCollector	Coletor que coleta carimbos de data/hora de reinicializações de tempo de execução (falhas do servidor do sistema) durante a execução do teste, se houver.
ScreenRecordOnFailureCollector	Coletor que captura e registra uma gravação de tela quando um caso de teste falha.
ScreenshotOnFailureCollector	Coletor que captura e registra uma captura de tela quando um caso de teste falha.

Subclasses indiretas conhecidas

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

AtraceRunMetricCollector	Coleta os traces de todos os diretórios de teste no diretório especificado do dispositivo de teste, registra o diretório de teste e pós-processa os arquivos de trace no diretório de teste e agrega as métricas.
BluetoothConnectionLatencyCollector	O coletor vai enviar uma configuração de métrica de duração do statsd predefinida para os dispositivos e coletar a duração da conexão Bluetooth de cada perfil.
BluetoothConnectionStateCollector	Esse coletor vai coletar métricas BluetoothConnectionStateChanged e registrar o número de estados de conexão para cada perfil.
BluetoothHciSnoopLogCollector	Coletor para ativar o registro de rastreamento do HCI Bluetooth no DUT e coletar o registro de cada teste.
FilePullerLogCollector	Registrador do arquivo informado pelo lado do dispositivo.
ModuleLogcatCollector	Versão do coletor logcat, mas para o módulo.
PerfettoFilePullerCollector	Um coletor que extrai arquivos de rastreamento do Perfetto do dispositivo, compacta-os (opcionalmente) e os adiciona aos registros de teste.
PerfettoPullerMetricCollector	Essa classe foi descontinuada. Use `PerfettoFilePullerCollector` e `ERROR(/PerfettoTracePostProcessor)` em vez disso.
ShowmapPullerMetricCollector	Implementação básica de `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.

Implementação básica de IMetricCollector que permite iniciar e interromper a coleta em onTestRunStart(DeviceMetricData) e onTestRunEnd(DeviceMetricData,Map).

Resumo

Constantes
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Construtores públicos
`BaseDeviceMetricCollector()`

Métodos públicos
`boolean`	`doesModuleContainFailure()` Retorna "true" se o módulo atual tiver falhas em casos de teste ou execuções de teste.
`void`	`enableDefaultMetricCollection()` Permite que os coletores ativem a coleta de métricas padrão.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` Retorna a lista de informações de build disponíveis na invocação.
`final List<ITestDevice>`	`getDevices()` Retorna a lista de dispositivos disponíveis na invocação.
`File`	`getFileFromTestArtifacts(String fileName)` Recupere o arquivo dos artefatos de teste ou do módulo e armazene em cache em um mapa para as chamadas subsequentes.
`final ITestInvocationListener`	`getInvocationListener()` Retorna o `ITestInvocationListener` original para onde estamos encaminhando os resultados.
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` Retorna todos os dispositivos não simulados da lista `getDevices()`.
`String`	`getRunName()` Retorna o nome da execução de teste `mRunName` que aciona o coletor.
`String`	`getTestName()` Retorna o nome do teste `mTestName` que aciona o coletor.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicialização do coletor com o contexto atual e onde encaminhar os resultados.
`final void`	`invocationEnded(long elapsedTime)` Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.
`final void`	`invocationFailed(FailureDescription failure)` Informa uma invocação incompleta devido a alguma condição de erro.
`final void`	`invocationFailed(Throwable cause)` Informa uma invocação incompleta devido a alguma condição de erro.
`void`	`invocationSkipped(SkipReason reason)` Informa que uma invocação foi ignorada.
`final void`	`invocationStarted(IInvocationContext context)` Listeners de invocação para encaminhamento
`boolean`	`isDefaultMetricCollectionEnabled()` Indica se o coletor está coletando métricas como parte da coleta de métricas padrão.
`final boolean`	`isDisabled()` Retorna "True" se o objeto inteiro estiver desativado (ignora a configuração e a desmontagem).
`boolean`	`isDisabledReceiver()` Se o `IDeviceActionReceiver` está desativado ou não.
`final void`	`logAssociation(String dataName, LogFile logFile)` Não use na implementação do coletor de métricas internas.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando um caso de teste falha devido a uma falha de proposição.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback quando um caso de teste é encerrado.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback quando um caso de teste é encerrado.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback quando um caso de teste falha.
`void`	`onTestModuleEnded()` Permite capturar o evento de término do módulo.
`void`	`onTestModuleStarted()` Permite capturar o evento de início do módulo.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback quando a execução de um teste é encerrada.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Callback para eventos testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando a execução de um teste é iniciada.
`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`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Define o nível em que o coletor deve coletar registros, independentemente de falhas.
`final void`	`setDisable(boolean isDisabled)` Define se o objeto deve ser desativado.
`void`	`setDisableReceiver(boolean isDisabled)` Define se o `IDeviceActionReceiver` precisa ser desativado.
`final void`	`setLogSaver(ILogSaver logSaver)` Não use na implementação do coletor de métricas internas.
`void`	`setModuleContainsFailure()` Define se o módulo teve falhas (caso de teste, execução de teste).
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Define o nível em que o coletor deve coletar registros durante falhas.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternativa a `testEnded(TestDescription,Map)` em que podemos especificar o horário de término diretamente.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Informa o fim da execução de um caso de teste individual.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Informa a falha de um caso de teste individual.
`final void`	`testFailed(TestDescription test, String trace)` Informa a falha de um caso de teste individual.
`final void`	`testIgnored(TestDescription test)` Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornece os dados de depuração ou de registro associados da invocação de teste.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Não use dentro da implementação do coletor de métricas.
`final void`	`testModuleEnded()` Informa o fim da execução de um módulo.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Informa o início da execução de um módulo.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Informa o fim da execução do teste.
`final void`	`testRunFailed(FailureDescription failure)` Não foi possível concluir o teste de execução de relatórios devido a uma falha descrita por `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` A execução do teste de relatórios não foi concluída devido a um erro fatal.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Informa o início de um teste.
`final void`	`testRunStarted(String runName, int testCount)` Callbacks de execução de teste
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Informa o início de um teste.
`final void`	`testRunStopped(long elapsedTime)` A execução de teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Chamado quando um teste é ignorado e não é executado por um motivo que geralmente não é esperado.
`final void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(TestDescription)` em que também especificamos quando o teste foi iniciado, combinado com `testEnded(TestDescription,long,Map)` para uma medição precisa.
`final void`	`testStarted(TestDescription test)` Callbacks de casos de teste

Constantes

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Valor da constante: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Valor da constante: "test-case-include-group"

Construtores públicos

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Métodos públicos

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Retorna "true" se o módulo atual tiver falhas em casos de teste ou execuções de teste.

Retorna
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Permite que os coletores ativem a coleta de métricas padrão. Quando a coleta de métricas padrão está ativada, o coletor só coleta no nível especificado.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Retorna
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

Retorna
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

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

Retorna
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Recupere o arquivo dos artefatos de teste ou do módulo e armazene em cache em um mapa para as chamadas subsequentes.

Parâmetros
`fileName`	`String`: nome do arquivo a ser pesquisado nos artefatos.

Retorna
`File`	Arquivo do artefato de teste ou do módulo. Retorna nulo se o arquivo não for encontrado.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Retorna o ITestInvocationListener original para onde estamos encaminhando os resultados.

Retorna
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Retorna
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Retorna
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

Retorna todos os dispositivos não simulados da lista getDevices().

Retorna
`List<ITestDevice>`

getRunName

public String getRunName ()

Retorna o nome da execução de teste mRunName que aciona o coletor.

Retorna
`String`	mRunName, o nome da execução de teste atual.

getTestName

public String getTestName ()

Retorna o nome do teste mTestName que aciona o coletor.

Retorna
`String`	mTestName, o nome do teste atual.

init

public final 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 deverá atualizar o contexto e o listener internos. Init nunca será chamado durante um teste, sempre antes.

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

Parâmetros
`context`	`IInvocationContext`: o `IInvocationContext` da invocação em andamento.
`listener`	`ITestInvocationListener`: o `ITestInvocationListener` onde colocar os resultados.

Retorna
`ITestInvocationListener`	o novo listener envolvendo o original.

Gera
`DeviceNotAvailableException`

invocationEnded

public final void invocationEnded (long elapsedTime)

Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
`elapsedTime`	`long`: o tempo decorrido da invocação em ms

invocationFailed

public final void invocationFailed (FailureDescription failure)

Informa uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
`failure`	`FailureDescription`: o `FailureDescription` que descreve a causa da falha

invocationFailed

public final void invocationFailed (Throwable cause)

Informa uma invocação incompleta devido a alguma condição de erro.

Será chamado automaticamente pela estrutura TradeFederation.

Parâmetros
`cause`	`Throwable`: a causa `Throwable` da falha.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que uma invocação foi ignorada.

Parâmetros
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listeners de invocação para encaminhamento

Parâmetros
`context`	`IInvocationContext`: informações sobre a invocação

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Indica se o coletor está coletando métricas como parte da coleta de métricas padrão.

Retorna
`boolean`

isDisabled

public final boolean isDisabled ()

Retorna "True" se o objeto inteiro estiver desativado (ignora a configuração e a desmontagem). Caso contrário, retorna "falso".

Retorna
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Se o IDeviceActionReceiver está desativado ou não.

Retorna
`boolean`	Retorna "true" se estiver desativado. Caso contrário, retorna "false".

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Não use na implementação do coletor de métricas internas. Isso é encaminhamento puro.

Parâmetros
`dataName`	`String`: o nome dos dados
`logFile`	`LogFile`: o `LogFile` registrado anteriormente e que precisa ser associado ao caso de teste.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback quando um caso de teste falha devido a uma falha de proposiçã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.

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 transmitidas para `testEnded(TestDescription,Map)`.

Gera
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

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 transmitidas para `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: o `TestDescription` do caso de teste em andamento.

Gera
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback 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.

Gera
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

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

Gera
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar o evento de início do módulo.

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 transmitidas para `testRunEnded(long,Map)`.

Gera
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback para eventos testRunFailed

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback quando a execução de um teste é iniciada.

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

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 devem 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 devem 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`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Define o nível em que o coletor deve coletar registros, independentemente de falhas.

O nível NULL não resulta em coleta.

Parâmetros
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` em que os registros serão coletados.

setDisable

public final void setDisable (boolean isDisabled)

Define se o objeto deve ser desativado. "Desativado" significa que as etapas de configuração e encerramento precisam ser ignoradas. Pode ser usado para desativar um objeto por padrão no construtor padrão.

Parâmetros
`isDisabled`	`boolean`: o estado em que o objeto deve ser colocado.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Define se o IDeviceActionReceiver precisa ser desativado. Desativar significa que ele não será registrado no dispositivo para receber eventos de ação do dispositivo.

Parâmetros
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Não use dentro da implementação do coletor de métricas. Isso é encaminhamento puro.

Parâmetros
`logSaver`	`ILogSaver`: o `ILogSaver`

setModuleContainsFailure

public void setModuleContainsFailure ()

Define se o módulo teve falhas (caso de teste, execução de teste).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Define o nível em que o coletor deve coletar registros durante falhas.

O nível NULL não resulta em coleta.

Parâmetros
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` em que os registros serão coletados.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`trace`	`String`: stack trace da falha

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`failure`	`FailureDescription`: `FailureDescription` que descreve a falha e o contexto dela.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternativa a testEnded(TestDescription,Map) em que podemos especificar o horário de término diretamente. Combine com testStarted(TestDescription,long) para uma medição precisa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`endTime`	`long`: o horário em que o teste terminou, medido por `System.currentTimeMillis()`
`testMetrics`	`HashMap`: uma `Map` das métricas emitidas

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Informa o fim da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna todas as métricas de chave/valor que podem ter sido emitidas durante a execução do caso de teste.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`testMetrics`	`HashMap`: uma `Map` das métricas emitidas

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`failure`	`FailureDescription`: `FailureDescription` que descreve a falha e o contexto dela.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`trace`	`String`: stack trace da falha

testIgnored

public final void testIgnored (TestDescription test)

Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

Parâmetros
`test`	`TestDescription`: identifica o teste.

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Fornece os dados de depuração ou de registro associados da invocação de teste.

Precisa ser chamado antes de ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long))

A estrutura TradeFederation chama esse método automaticamente, fornecendo o registro do host e, se aplicável, o logcat do dispositivo.

Parâmetros
`dataName`	`String`: um nome descritivo `String` dos dados, por exemplo, "device_logcat". Observação: dataName pode não ser exclusivo por invocação. Ou seja, os implementadores precisam ser capazes de processar várias chamadas com o mesmo dataName.
`dataType`	`LogDataType`: o `LogDataType` dos dados
`dataStream`	`InputStreamSource`: o `InputStreamSource` dos dados. Os implementadores precisam chamar createInputStream para começar a ler os dados e fechar o InputStream resultante quando concluído. Os autores da chamada precisam garantir que a origem dos dados permaneça presente e acessível até que o método testLog seja concluído.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Não use na implementação do coletor de métricas internas. Isso é encaminhamento puro.

Parâmetros
`dataName`	`String`: um nome descritivo `String` dos dados, por exemplo, "device_logcat". Observação: dataName pode não ser exclusivo por invocação. Ou seja, os implementadores precisam ser capazes de processar várias chamadas com o mesmo dataName.
`dataType`	`LogDataType`: o `LogDataType` dos dados
`dataStream`	`InputStreamSource`: o `InputStreamSource` dos dados. Os implementadores precisam chamar createInputStream para começar a ler os dados e fechar o InputStream resultante quando concluído.
`logFile`	`LogFile`: o `LogFile` que contém os metadados do arquivo salvo.

testModuleEnded

public final void testModuleEnded ()

Informa o fim da execução de um módulo.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Informa o início da execução de um módulo. Esse callback está associado a testModuleEnded() e é opcional na sequência. Ele só é usado durante uma execução que usa módulos: executores baseados em suítes.

Parâmetros
`moduleContext`	`IInvocationContext`: o `IInvocationContext` do módulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Informa o fim da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então precisamos usar HashMap aqui.

Parâmetros
`elapsedTime`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos
`runMetrics`	`HashMap`: pares de chave-valor informados no final de uma execução de teste com `Metric`.

testRunFailed

public final void testRunFailed (FailureDescription failure)

Não foi possível concluir o teste de execução de relatórios devido a uma falha descrita por FailureDescription.

Parâmetros
`failure`	`FailureDescription`: `FailureDescription` que descreve a falha e o contexto dela.

testRunFailed

public final void testRunFailed (String errorMessage)

A execução do teste de relatórios não foi concluída devido a um erro fatal.

Parâmetros
`errorMessage`	`String`: `String` que descreve o motivo da falha na execução.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Informa o início de um teste.

Parâmetros
`runName`	`String`: o nome da execução do teste.
`testCount`	`int`: número total de testes na execução do teste
`attemptNumber`	`int`: número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é repetido granularmente três vezes, ele precisa ter quatro execuções no mesmo runName, e o attemptNumber é de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callbacks de execução de teste

Parâmetros
`runName`	`String`: o nome da execução do teste.
`testCount`	`int`: número total de testes na execução do teste

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Informa o início de um teste.

Parâmetros
`runName`	`String`: o nome da execução do teste.
`testCount`	`int`: número total de testes na execução do teste
`attemptNumber`	`int`: número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas várias vezes. O attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é repetido granularmente três vezes e precisa ter quatro execuções no mesmo runName, e o attemptNumber é de 0 a 3.
`startTime`	`long`: o horário em que a execução começou, medido por `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

A execução de teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.

PENDENTE: não usado no momento, considere remover

Parâmetros
`elapsedTime`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não é executado por um motivo que geralmente não é esperado. Esses testes serão repetidos para tentar uma execução adequada.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(TestDescription) em que também especificamos quando o teste foi iniciado, combinado com testEnded(TestDescription,long,Map) para uma medição precisa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`startTime`	`long`: o horário em que o teste começou, medido por `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Callbacks de casos de teste

Parâmetros
`test`	`TestDescription`: identifica o teste.