ITestLifeCycleReceiver.

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Subclasses indiretas conhecidas AggregatePostProcessor (em inglês) Um agregador de métricas que fornece os valores mínimo, máximo, média, variância, desvio padrão, total, contagem e percentis opcionais para métricas numéricas coletadas durante execuções de testes de várias iterações, tratando-as como duplas.  AtraceCollector (link em inglês) Um IMetricCollector que executa um trace durante um teste e coleta o resultado e o registro à invocação.  AtraceRunMetricCollector (link em inglês) Coleta os rastros de todo o diretório de teste no diretório especificado no dispositivo de teste, registre o diretório de teste e faça o pós-processamento dos arquivos de rastreamento. no diretório de teste e agregar as métricas.  AveragePostProcessor (link em inglês) Implementação do pós-processador que calcula a média da lista de métricas.  BaseDeviceMetricCollector (em inglês) 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 (link em inglês) A IPostProcessor base que todas as implementações precisam estender.  BluetoothConnectionLatencyCollector (em inglês) O coletor envia uma configuração de métrica predefinida de duração das estatísticas para os dispositivos e coleta Duração da conexão Bluetooth de cada perfil.  BluetoothConnectionStateCollector (link em inglês) Este coletor coletará métricas BluetoothConnectionStateChanged e registrará o estado da conexão para cada perfil.  BluetoothConnectionSuccessRatePostProcessor (link em inglês) Implementação do pós-processador que calcula a taxa de sucesso de um perfil Bluetooth Usar "metric-key-match" para especificar métricas que contêm estados de conexão Bluetooth em valores numéricos Exemplo de matriz [0, 1, 2, 3, 0, 1, 2, 3].  BluetoothHciSnoopLogCollector (em inglês) Coletor para ativar a geração de registros de espionagem de HCI Bluetooth no DUT e coletar o registro de cada teste.  BugreportCollector (link em inglês) Um ITestInvocationListener de passagem que coleta relatórios de bugs quando eventos configuráveis ocorre e chama ITestInvocationListener#testLog nos filhos após cada o relatório do bug seja coletado.  BugreportzOnFailureCollector (link em inglês) Colete um relatório de bugs quando um caso de teste falhar.  BugreportzOnTestCaseFailureCollector (link em inglês) Colete um bugreportz quando um caso de teste em uma execução falhar.  ClangCodeCoverageCollector (link em inglês) Uma BaseDeviceMetricCollector que extrairá o Clang medições de cobertura fora do dispositivo e registrá-las como artefatos de teste.  CollectingTestListener (link em inglês) Um ITestInvocationListener que vai coletar todos os resultados do teste.  CommandStatusHandler (link em inglês) Gerenciador que ajuda a monitorar e atualizar o status de uma invocação.  ConditionFailureMonitor (link em inglês) Monitore as falhas da invocação.  ConsoleResultReporter (link em inglês) Gerador de resultados para imprimir os resultados do teste no console.  CountTestCasesCollector (link em inglês) Contabilize e informe o número de casos de teste para um determinado IRemoteTest.  CountingTestResultListener. Um TestResultListener que rastreia o número total de testes por TestStatus DebugHostLogOnFailureCollector (link em inglês) Coletor que coletará e registrará os registros do lado do host quando ocorrer uma falha no caso de teste.  DeviceReleaseReporter (link em inglês) Informante de versão do dispositivo que gerencia a comunicação com o processo pai em que os dispositivos serão lançado.  DeviceTraceCollector (link em inglês) Coletor que inicia o rastreamento do Perfeito quando um teste é iniciado e registra o arquivo de rastreamento no final.  DeviceUnavailableMonitor (link em inglês) Esse listener tenta capturar apenas o DNAE do nível de um caso de teste.  EventsLoggerListener (em inglês) Listener que registra todos os eventos recebidos em um arquivo FileProtoResultReporter (link em inglês) Gerador de relatório proto que despeja o TestRecord em um arquivo.  FilePullerDeviceMetricCollector (em inglês) Um BaseDeviceMetricCollector que detecta chaves de métricas provenientes do dispositivo e extrai como um arquivo no dispositivo.  FilePullerLogCollector (em inglês) logger do arquivo informado pelo lado do dispositivo.  FilteredResultForwarder. Variante de ResultForwarder que permite que apenas uma lista de permissões do TestDescription seja relatadas.  FormattedGeneratorReporter (link em inglês) Repórter que permite gerar relatórios em um formato específico.  GcovCodeCoverageCollector Um BaseDeviceMetricCollector que vai extrair gcov medições de cobertura fora do dispositivo e registrá-las como artefatos de teste.  GcovKernelCodeCoverageCollector (em inglês) Um BaseDeviceMetricCollector que vai extrair o kernel gcov medições de cobertura fora de debugfs e fora do dispositivo e, em seguida, registrá-las como teste artefatos.  GranularRetriableTestWrapper.StartEndCollector (link em inglês) Assistente de classe para detectar o início e o fim da execução ausentes.  HostStatsdMetricCollector (em inglês) Um IMetricCollector que coleta métricas do StatsD do lado do host usando o utilitário StatsD. comandos  ICommandScheduler.IScheduledInvocationListener (link em inglês) Listener de eventos de invocação quando a invocação é concluída.  ILogSaverListener (em inglês) Permite que ITestInvocationListeners detectem quando os arquivos de registro forem salvos.  IMetricCollector (em inglês) Esta interface será adicionada como um decorador ao relatar os resultados dos testes para coletar e métricas correspondentes.  IPostProcessor (em inglês) Os pós-processadores são um objeto da Trade Federation destinado a permitir o processamento de métricas e registros DEPOIS dos testes e ANTES do relatório de resultados.  IShardableListener (link em inglês) Um ITestInvocationListener que pode ser fragmentado.  ISupportGranularResults (em inglês) Interface que especifica se um ITestInvocationListener oferece suporte ao recebimento do resultados ou não.  ITestInvocationListener (em inglês) Listener para resultados de teste da invocação do teste.  ITestSummaryListener (link em inglês) Interface que permite que ITestInvocationListener troque algumas informações limitadas via 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á Java medições de cobertura fora do dispositivo e registrá-las como artefatos de teste.  JsonHttpTestResultReporter (link em inglês) Um gerador de relatórios de resultados que codifica os resultados das métricas de teste e as informações do dispositivo em ramificações e JSON e POST. em um endpoint do serviço HTTP LUCIResultReporter (link em inglês) Um gerador de relatórios de resultados que salva os resultados necessários para o ResultDB e a LUCI. no formato JSON (go/result-sink) e registra a localização do arquivo no console.  LastShardDetector (link em inglês) Na fragmentação local, às vezes, só queremos executar algumas ações quando o último fragmento chega a invocationEnded(long).  LegacySubprocessResultsReporter (em inglês) Uma implementação congelada do gerador de relatórios de resultados do subprocesso que deve permanecer compatível com versões anteriores do TF/CTS (por exemplo, o 8+), apesar das mudanças na superclasse.  LogSaverResultForwarder. Um ResultForwarder para salvar registros com o protetor de arquivos global.  LogcatCrashResultForwarder. Listener especial: em falhas (falha no processo de instrumentação), ele tentará extrair do ao logcat da falha e o adiciona à mensagem de falha associada ao teste.  LogcatOnFailureCollector (link em inglês) 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, o horário da troca do usuário) do Logcat durante um ou vários testes repetidos usando determinados padrões de regex para analisar os indicadores inicial e final de um das linhas do Logcat.  MetricFilePostProcessor Usado para fazer upload do arquivo de registro de métricas coletado durante o teste e o nível de execução.  MetricsXMLResultReporter (em inglês) MetricsXMLResultReporter grava métricas de teste e executa métricas em um arquivo XML na pasta especificada. pelo parâmetro metrics-folder na fase invocationEnded do teste.  ModuleListener (link em inglês) Listener anexado a cada IRemoteTest de cada módulo para coletar a lista de resultados.  ModuleLogcatCollector (link em inglês) Versão do coletor do logcat, mas para o módulo.  NameMangleListener (em inglês) Um listener de proxy para traduzir métodos de teste, classes e nomes de pacotes conforme os resultados são informados.  PassingTestFileReporter (link em inglês) Um ITestInvocationListener que salva a lista de casos de teste aprovados em um arquivo de teste PerfettoGenericPostProcessor (em inglês). Um pós-processador que processa um arquivo proto de métrica de texto/binária em pares de chave-valor expandir recursivamente as mensagens e os campos proto com valores de string até que o campo com um valor numérico for encontrado.  PerfettoPullerMetricCollector (link em inglês) Implementação básica de FilePullerDeviceMetricCollector que permite extrair os arquivos do Perfeito 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 informante de resultados 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.  ReiniciarReasonCollector Coletor que coleta a reinicialização do dispositivo durante a execução do teste e informa o motivo e as contagens.  RemoteTestTimeOutEnforcer (em inglês) Listeners que permitem verificar o tempo de execução de uma determinada configuração de teste e falhar se ela falhar durante um determinado tempo limite.  ReportPassedTests (link em inglês) Informe em um arquivo possíveis filtros para excluir a aprovação no teste.  ResultAggregator (link em inglês) Encaminhador especial que agrega os resultados quando necessário, com base na estratégia de repetição que foi tomadas.  ResultAndLogForwarder (link em inglês) Encaminhador para resultados e eventos de registros.  ResultForwarder (link em inglês) Um ITestInvocationListener que encaminha os resultados da 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 tentativa.  RuntimeRestartCollector (link em inglês) Coletor que coleta carimbos de data/hora de reinicializações durante o teste (falhas no servidor do sistema) executar, 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 ser executada em vários recursos em paralelo) e os encaminha para outro ouvinte.  ShardMainResultForwarder (link em inglês) Um ResultForwarder que combina os resultados de invocações de teste fragmentadas.  ShowmapPullerMetricCollector (em inglês) Implementação básica de FilePullerDeviceMetricCollector que permite extrair o mapa de exibição. do dispositivo e coletar as métricas dele.  StatsdBeforeAfterGaugeMetricPostProcessor Um pós-processador que processa as métricas coletadas em um estágio abordagem, ou seja, StatsdEventMetricPostProcessor Um pós-processador que processa métricas de eventos em relatórios do StatsD em pares de chave-valor, usando o método formatadores especificados no processador.  StatsdGenericPostProcessor (em inglês) Um pós-processador que processa relatórios binários protoStatsd em pares de chave-valor expandindo o como uma estrutura de árvore.  StreamProtoResultReporter (link em inglês) Uma implementação de ProtoResultReporter SubprocessResultsReporter (em inglês) Implementa ITestInvocationListener a ser especificado como um result_reporter e encaminhado de o subprocesso, os resultados de testes, execuções de teste, invocações de teste.  SuiteResultReporter (link em inglês) 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 do ITestLifecycleListener para implementadores que se preocupam apenas com testes individuais. resultados.  TestTimeoutEnforcer (em inglês) Listeners que permitem verificar o tempo de execução de um determinado caso de teste e falhar se ocorrer durante um determinado tempo limite.  TextResultReporter (link em inglês) Um gerador de relatórios de resultados de teste que encaminha os resultados para a impressora de resultados de texto JUnit.  TraceCmdCollector (link em inglês) Um IMetricCollector que coleta traces durante o teste usando trace-cmd e os registra em da invocação.  TradefedSandboxRunner.StubScheduledInvocationListener (link em inglês) Um stub IScheduledInvocationListener que não faz nada.  XmlFormattedGeneratorReporter (link em inglês) Implementação do FormattedGeneratorReporter, que formata o pacote resulta em um XML .  XmlResultReporter (link em inglês) Grava resultados do JUnit em um arquivo XML em um formato consistente com XMLJUnitResultFormatter do Ant.

---

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

Com o padrão org.junit.runner.notification.RunListener

A sequência de chamadas será:

• testRunStarted
• testStarted
• [Falha no teste]
• [Falha em testeAssumption]
• [teste ignorado]
• testEnded
• ....
• [Falha no teste]
• 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) Chamado 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 final da execução de um caso de teste individual.
default void	testFailed(TestDescription test, FailureDescription failure) Relata 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 é ignorado e não executado por um motivo que normalmente 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 medição 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)

Chamado 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)

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

Parâmetros
test	TestDescription: identifica o teste.
failure	FailureDescription: FailureDescription descrevendo a falha e o contexto.

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 horário de término do teste, medido por System.currentTimeMillis().
testMetrics	: um ERROR(/Map) das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

Parâmetros
test	TestDescription: identifica o teste.
testMetrics	: um ERROR(/Map) das métricas emitidas

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Relata a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

Parâmetros
test	TestDescription: identifica o teste.
failure	FailureDescription: FailureDescription descrevendo a falha e o contexto.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Relata 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

testIgnorado

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. FIXME: não podemos ter dois Map<> interfaces com tipos diferentes, então precisamos usar o HashMap aqui.

Parâmetros
elapsedTimeMillis	long: tempo decorrido informado pelo dispositivo, em milissegundos.
runMetrics	: pares de chave-valor informados no final de um teste com Metric.

testRunFailed

public void testRunFailed (FailureDescription failure)

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

Parâmetros
failure	FailureDescription: FailureDescription descrevendo a falha e o contexto.

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 de 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 executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado todas as vezes ocorre uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro no total é executado com o mesmo runName, e o tryNumber varia 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 de 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 de 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 executados várias vezes. O "tryNumber" tem índice 0 e deve ser incrementado sempre que um uma nova execução. Por exemplo: Um teste é repetido de forma granular três vezes, deve ter quatro execuções no total com o mesmo runName, e o tryNumber vai de 0 a 3.
startTime	long: o horário de início da corrida, medida usando System.currentTimeMillis().

testRunSStop

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

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 medição precisa.

Parâmetros
test	TestDescription: identifica o teste.
startTime	long: o horário de início do teste, medido por System.currentTimeMillis().

testStarted

public void testStarted (TestDescription test)

Informa o início de um caso de teste individual. A interface mais antiga precisa usar testStarted(com.android.tradefed.result.TestDescription) sempre que possível.

Parâmetros
test	TestDescription: identifica o teste.