O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

ITestLifeCycleReceiver.

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Subclasses indiretas conhecidas

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CollectingTestListener e 77 outros.

AggregatePostProcessor	Um agregador de métricas que fornece o mínimo, máximo, média, variância, desvio padrão, total, contagem e, opcionalmente, percentis para métricas numéricas coletadas durante execuções de teste de várias iterações, tratando-as como números reais.
AtraceCollector	Um `IMetricCollector` que executa um atrace durante um teste, coleta o resultado e o registra na invocação.
AtraceRunMetricCollector	Coleta os rastros de todo o diretório de teste no diretório do dispositivo de teste, registra o diretório de teste e processa os arquivos de rastreamento no diretório de teste e agrega as métricas.
AveragePostProcessor	Implementação do pós-processador que calcula a média da lista de métricas.
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))`.
BasePostProcessor	O `IPostProcessor` básico que toda implementação precisa estender.
BluetoothConnectionLatencyCollector	O coletor vai enviar uma configuração de métrica de duração predefinida do StatsD para os dispositivos e coletar a duração da conexão Bluetooth para cada perfil.
BluetoothConnectionStateCollector (link em inglês)	Este coletor coletará métricas BluetoothConnectionStateChanged e registrará o número do estado da conexão para cada perfil.
BluetoothConnectionSuccessRatePostProcessor	Implementação de um pós-processador que calcula a taxa de sucesso de um perfil de Bluetooth Use "metric-key-match" para especificar métricas que contêm estados de conexão Bluetooth em uma matriz numérica. Exemplo [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Coletor para ativar o registro de rastreamento do HCI Bluetooth no DUT e coletar o registro de cada teste.
BugreportCollector	Um `ITestInvocationListener` de passagem que coleta relatórios de bugs quando eventos configuráveis ocorrem e, em seguida, chama `ITestInvocationListener#testLog` nos filhos após cada relatório de bug ser coletado.
BugreportzOnFailureCollector (link em inglês)	Coletar um relatório de bug quando um caso de teste falhar.
BugreportzOnTestCaseFailureCollector	Coleta um relatório de bug quando um caso de teste em uma execução falha.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do Clang do dispositivo e as registra como artefatos de teste.
CollectingTestListener (link em inglês)	Um `ITestInvocationListener` que coleta todos os resultados do teste.
CommandStatusHandler	Handler que ajuda a monitorar e atualizar o status de uma invocação.
ConditionFailureMonitor	Monitore as falhas da invocação.
ConsoleResultReporter	O Result Reporter imprime os resultados do teste no console.
CountTestCasesCollector	Contabilize e informe o número de casos de teste para um determinado `IRemoteTest`.
CountingTestResultListener	Uma `TestResultListener` que rastreia o número total de testes por `TestStatus`
DebugHostLogOnFailureCollector	Coletor que vai coletar e registrar os registros do lado do host quando ocorrer uma falha no caso de teste.
DeviceReleaseReporter	Dispositivo de lançamento do dispositivo que lida com a comunicação com o processo pai que os dispositivos serão liberados.
DeviceTraceCollector (link em inglês)	Coletor que inicia o rastreamento do perfetto quando um teste é iniciado e registra o arquivo de rastreamento no final.
DeviceUnavailableMonitor	Esse listener tenta capturar apenas uma DNAE no nível do caso de teste.
EventsLoggerListener	Listener que registra todos os eventos recebidos em um arquivo
FileProtoResultReporter (link em inglês)	Relatório de proto que despeja o `TestRecord` em um arquivo.
FilePullerDeviceMetricCollector (em inglês)	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.
FilteredResultForwarder.	Variante de `ResultForwarder` que permite apenas que uma lista de permissões de `TestDescription` seja informada.
FormattedGeneratorReporter	Repórter que permite gerar relatórios em um formato específico.
GcovCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do gcov do dispositivo e as registra como artefatos de teste.
GcovKernelCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do kernel gcov dos arquivos de depuração e do dispositivo e, por fim, registra-as como artefatos de teste.
GranularRetriableTestWrapper.StartEndCollector (link em inglês)	Ajudante de classe para detectar início e término de execução ausentes.
HostStatsdMetricCollector (em inglês)	Um `IMetricCollector` que coleta métricas do StatsD do lado do host usando comandos de utilitário do StatsD.
ICommandScheduler.IScheduledInvocationListener	Listener para eventos de invocação quando a invocação é concluída.
ILogSaverListener	Permite que `ITestInvocationListener`s detectem quando os arquivos de registro são salvos.
IMetricCollector	Essa interface será adicionada como um decorador ao relatar os resultados dos testes para coletar métricas correspondentes.
IPostProcessor	Os pós-processadores são um objeto da Trade Federation que permite o processamento de métricas e registros APÓS os testes e ANTES do relatório de resultados.
IShardableListener (link em inglês)	Um `ITestInvocationListener` que pode ser dividido.
ISupportGranularResults	Interface que especifica se um `ITestInvocationListener` oferece suporte ao recebimento dos resultados granulares ou não.
ITestInvocationListener (em inglês)	Listener para resultados de teste da invocação do teste.
ITestSummaryListener	Interface que permite que `ITestInvocationListener` troque algumas informações limitadas por resumos.
InvocationToJUnitResultForwarder	Uma classe que detecta eventos `ITestInvocationListener` e os encaminha para um `TestListener`.
JarHostTest.HostTestListener (link em inglês)	Listener de wrapper que encaminha todos os eventos, exceto testRunStarted() e testRunEnded() para o listener incorporado.
JavaCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá medições de cobertura Java do dispositivo e as registrará como artefatos de teste.
JsonHttpTestResultReporter	Um relatório de resultados que codifica os resultados das métricas de teste e a ramificação, as informações do dispositivo em JSON e POST em um endpoint de serviço HTTP
LUCIResultReporter	Um relatório de resultados que salva os resultados de teste necessários pelo ResultDB e pelo LUCI no formato JSON (go/result-sink) e registra o local do arquivo no console.
LastShardDetector	Ao executar o sharding local, às vezes queremos executar algumas ações apenas quando o último fragmento atinge `invocationEnded(long)`.
LegacySubprocessResultsReporter (em inglês)	Uma implementação congelada do sinalizador de resultados de subprocesso, que precisa permanecer compatível com versões anteriores do TF/CTS (por exemplo, 8 ou mais recente), apesar das mudanças na superclasse.
LogSaverResultForwarder	Um `ResultForwarder` para salvar registros com o armazenamento de arquivos global.
LogcatCrashResultForwarder	Listener especial: em falhas (falha no processo de instrumentação), ele tenta extrair do logcat a falha e a adiciona à mensagem de falha associada ao teste.
LogcatOnFailureCollector	Coletor que vai capturar e registrar um logcat quando um caso de teste falhar.
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 de regex específicos para analisar os sinais de início e término de um evento nas linhas do Logcat.
MetricFilePostProcessor	Usado para fazer o upload do arquivo de registro de métricas coletado durante o nível de teste e execução.
MetricsXMLResultReporter	O MetricsXMLResultReporter grava métricas de teste e executa métricas em um arquivo XML em uma pasta especificada pelo parâmetro metrics-folder na fase invocationEnded do teste.
ModuleListener	Listener anexado a cada `IRemoteTest` de cada módulo para coletar a lista de resultados.
ModuleLogcatCollector	Versão do coletor do logcat, mas para o módulo.
ModuleProtoResultReporter	Um relatório de resultados destinado a informar apenas os resultados no nível do módulo.
NameMangleListener	Um listener de proxy para traduzir os nomes de método, classe e pacote de teste conforme os resultados são informados.
PassingTestFileReporter	Um `ITestInvocationListener` que salva a lista de casos de teste aprovados em um arquivo de teste
PerfettoGenericPostProcessor	Um pós-processador que processa o arquivo proto de métrica de texto/binário do perfetto em pares de chave-valor, expandindo de forma recursiva as mensagens e os campos do proto com valores de string até encontrar o campo com valor numérico.
PerfettoPullerMetricCollector	Implementação básica de `FilePullerDeviceMetricCollector` que permite extrair os arquivos do perfetto do dispositivo e coletar as métricas dele.
PrettyTestEventLogger (link em inglês)	O logger faz a correspondência dos eventos e os registra para facilitar a depuração.
ProtoResultReporter (link em inglês)	O Result Reporter cria um protobuf `TestRecord` com todos os resultados.
PythonBinaryHostTest.PythonForwarder (link em inglês)	Encaminhador de resultados para substituir o nome da execução pelo nome binário.
RebootReasonCollector	Coletor que coleta a reinicialização do dispositivo durante a execução do teste e informa o motivo e a contagem.
RemoteTestTimeOutEnforcer	Listeners que permitem verificar o tempo de execução de uma determinada configuração de teste e falhar se ela ultrapassar um determinado tempo limite.
ReportPassedTests (link em inglês)	Informe em um arquivo os possíveis filtros para excluir o teste aprovado.
ResultAggregator (link em inglês)	Encaminhador especial que agrega os resultados quando necessário, com base na estratégia de nova tentativa usada.
ResultAndLogForwarder	Encaminhador para resultados e eventos de registros.
ResultForwarder (link em inglês)	Um `ITestInvocationListener` que encaminha os resultados de invocação para uma lista de outros listeners.
RetryLogSaverResultForwarder	Encaminhador que também processa a tentativa atual em que estamos.
RetryResultForwarder.	Uma extensão de `ResultForwarder` que sempre envia para um determinado número de tentativas.
RuntimeRestartCollector	Coletor que coleta carimbos de data/hora de reinicializações de execução (falhas do servidor do sistema) durante a execução do teste, se houver.
Captura de telaOnFailureCollector	Coletor que vai capturar e registrar uma captura de tela quando um caso de teste falhar.
ShardListener (link em inglês)	Um `ITestInvocationListener` que coleta resultados de um fragmento de invocação (também conhecido como divisão de invocação para execução em vários recursos em paralelo) e os encaminha para outro listener.
ShardMainResultForwarder (link em inglês)	Um `ResultForwarder` que combina os resultados de invocações de teste fragmentadas.
ShowmapPullerMetricCollector	Implementação básica de `FilePullerDeviceMetricCollector` que permite extrair os arquivos do showmap do dispositivo e coletar as métricas dele.
StatsdBeforeAfterGaugeMetricPostProcessor	Um pós-processador que processa as métricas de medição coletadas em uma abordagem "antes/depois", ou seja,
StatsdEventMetricPostProcessor	Um pós-processador que processa as métricas de eventos em relatórios de statsd em pares de chave-valor, usando os formatadores especificados no processador.
StatsdGenericPostProcessor	Um pós-processador que processa relatórios binários protostatsd em pares de chave-valor expandindo o relatório como uma estrutura de árvore.
StreamProtoResultReporter (link em inglês)	Uma implementação de `ProtoResultReporter`
SubprocessResultsReporter	Implementa `ITestInvocationListener` a ser especificado como um result_reporter e encaminha a partir do subprocesso os resultados de testes, execuções de teste e invocações de teste.
SuiteResultReporter	Colete os resultados do teste de uma invocação de conjunto inteira e gere os resultados finais.
TestResultListener (link em inglês)	Uma simplificação de ITestLifecycleListener para implementadores que se preocupam apenas com resultados de teste individuais.
TestRunResultListener	Listener que permite ler o status final da execução do teste.
TestTimeoutEnforcer (em inglês)	Listeners que permitem verificar o tempo de execução de um determinado caso de teste e falhar se ele exceder um determinado tempo limite.
TextResultReporter (link em inglês)	Um repórter de resultados de teste que encaminha resultados para a impressora de resultados de texto do JUnit.
TraceCmdCollector	Um `IMetricCollector` que coleta rastros durante o teste usando o trace-cmd e os registra na invocação.
TradefedSandboxRunner.StubScheduledInvocationListener	Um `IScheduledInvocationListener` stub que não faz nada.
XmlFormattedGeneratorReporter (link em inglês)	Implementação do `FormattedGeneratorReporter` que formata os resultados do pacote em um formato XML.
XmlResultReporter	Grava os resultados do JUnit em arquivos XML em um formato consistente com o XMLJUnitResultFormatter do Ant.

Recebe notificações de eventos durante as execuções de teste de instrumentação.

Com base em org.junit.runner.notification.RunListener

A sequência de chamadas será:

testRunStarted
testStarted
[Falha no teste]
[Falha em testeAssumption]
[teste ignorado]
testEnded
....
[testRunFailed]
testRunEnded

Resumo

Métodos públicos
`default void`	`testAssumptionFailure(TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que assume uma condição falsa
`default void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chamada quando um teste atômico sinaliza que assume uma condição falsa
`default void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, em que podemos especificar o horário de término diretamente.
`default void`	`testEnded(TestDescription test, testMetrics)` Informa o fim da execução de um caso de teste individual.
`default void`	`testFailed(TestDescription test, FailureDescription failure)` Informa a falha de um caso de teste individual.
`default void`	`testFailed(TestDescription test, String trace)` Relata a falha de um caso de teste individual.
`default void`	`testIgnored(TestDescription test)` Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`default void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Informa o fim da execução do teste.
`default void`	`testRunFailed(FailureDescription failure)` A execução do teste de relatórios não foi concluída devido a uma falha descrita por `FailureDescription`.
`default void`	`testRunFailed(String errorMessage)` A execução do teste de relatórios não foi concluída devido a um erro fatal.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Informa o início de uma execução de teste.
`default void`	`testRunStarted(String runName, int testCount)` Informa o início de uma execução de teste.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Informa o início de uma execução de teste.
`default void`	`testRunStopped(long elapsedTime)` A execução do teste de relatórios foi interrompida antes da conclusão devido a uma solicitação do usuário.
`default void`	`testSkipped(TestDescription test, SkipReason reason)` É chamado quando um teste é pulado e não é executado por um motivo que não é esperado.
`default void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)`, em que também especificamos quando o teste foi iniciado, combinado com `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para uma medida precisa.
`default void`	`testStarted(TestDescription test)` Informa o início de um caso de teste individual.

Métodos públicos

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chamada quando um teste atômico sinaliza que assume uma condição falsa

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chamada quando um teste atômico sinaliza que assume uma condição falsa

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

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

Parâmetros
`test`	`TestDescription`: identifica o teste
`endTime`	`long`: o tempo em que o teste foi concluído, medido por `System.currentTimeMillis()`
`testMetrics`	: uma `ERROR(/Map)` das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Informa o término da execução de um caso de teste individual.

Se testFailed(TestDescription, FailureDescription) não foi invocado, o teste foi aprovado. Também retorna 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`	: uma `ERROR(/Map)` das métricas emitidas

testFailed

public 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 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 de falha

testIgnored

public 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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros
`elapsedTimeMillis`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos
`runMetrics`	: pares de chave-valor informados ao final de uma execução de teste

testRunFailed

public void testRunFailed (FailureDescription failure)

A execução do teste não foi concluída devido a uma falha descrita por FailureDescription.

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

testRunFailed

public 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` descrevendo o motivo da falha na execução.

testRunStarted

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

Informa o início de uma 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
`attemptNumber`	`int`: número de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O tryNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução é realizada. Por exemplo, um teste é repetido granular três vezes, ele precisa ter quatro execuções no total com o mesmo runName, e o tryNumber é de 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa o início de uma 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 void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Informa o início de uma 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
`attemptNumber`	`int`: número de pedido, que identifica as diferentes tentativas do mesmo runName que são executadas várias vezes. O tryNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução é feita. Por exemplo, um teste é repetido granular três vezes, ele precisa ter quatro execuções no total com o mesmo runName, e o tryNumber é de 0 a 3.
`startTime`	`long`: o horário de início da corrida, medida usando `System.currentTimeMillis()`.

testRunStopped

public void testRunStopped (long elapsedTime)

Informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.

TODO: não usado no momento, considere remover

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não executado por um motivo que normalmente não é esperado. Tentaremos realizar esses testes novamente para tentar obter uma execução adequada.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), em que também especificamos quando o teste foi iniciado, combinado com ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para uma medida precisa.

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

testStarted

public void testStarted (TestDescription test)

Informa o início de um caso de teste individual. Interface mais antiga, use testStarted(com.android.tradefed.result.TestDescription) sempre que possível.

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