ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Subclasses indiretas conhecidas AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector e mais 90. AggregatePostProcessor Um agregador de métricas que fornece o mínimo, o máximo, a média, a variância, o desvio padrão, o total, a contagem e, opcionalmente, os percentis para métricas numéricas coletadas durante execuções de teste de várias iterações, tratando-as como números de ponto flutuante de precisão dupla.  AndroidBuildResultReporter Envia os resultados do teste para a API Android Build.  AtraceCollector Um IMetricCollector que executa um rastreamento durante um teste e coleta o resultado e o registro para a invocação.  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.  AveragePostProcessor Implementação de 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(DeviceMetricData) e onTestRunEnd(DeviceMetricData,Map).  BasePostProcessor A IPostProcessor básica que toda implementação precisa estender.  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.  BluetoothConnectionSuccessRatePostProcessor Implementação de um pós-processador que calcula a taxa de sucesso de um perfil 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 chama ITestInvocationListener.testLog nos filhos depois que cada relatório de bug é coletado.  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.  CollectingTestListener Um ITestInvocationListener que vai coletar todos os resultados do teste.  CommandStatusHandler Handler que ajuda a monitorar e atualizar o status de uma invocação.  ConditionFailureMonitor Monitore falhas na invocação.  ConsoleResultReporter Gerador de relatórios de resultados para imprimir os resultados do teste no console.  CountTestCasesCollector Conta e informa o número de casos de teste para um determinado IRemoteTest.  CountingTestResultListener Um TestResultListener que rastreia o número total de testes por TestStatus  CoverageMetadataCollector Um ILogSaverListener que coleta medições de cobertura registradas e gera um CoverageMetadataProto para processamento pelo serviço de cobertura de código do Android.  DebugHostLogOnFailureCollector Coletor que vai reunir e registrar os registros do lado do host quando ocorrer uma falha no caso de teste.  DeviceReleaseReporter Reporter de liberação de dispositivo que lida com a comunicação com o processo principal dos dispositivos a serem liberados.  DeviceTraceCollector Coletor que inicia o rastreamento do Perfetto quando uma execução de teste começa e registra o arquivo de rastreamento no final.  DeviceUnavailableMonitor Esse listener tenta capturar apenas um DNAE no nível do caso de teste.  EventsLoggerListener Listener que registra todos os eventos recebidos em um arquivo. FileProtoResultReporter Gerador de relatórios proto que despeja o TestRecord em um arquivo.  FilePullerDeviceMetricCollector Um BaseDeviceMetricCollector que detecta a chave de métricas do dispositivo e as extrai como um arquivo.  FilePullerLogCollector Registrador do arquivo informado pelo lado do dispositivo.  FilteredResultForwarder Variante de ResultForwarder que permite apenas que uma lista de permissão de TestDescription seja informada.  FormattedGeneratorReporter Reporter que permite gerar relatórios em um formato específico.  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.  GeminiDebuggingPostProcessor Pós-processador criando consultas de comandos para depurar erros.  GranularRetriableTestWrapper.StartEndCollector Classe auxiliar para detectar o início e o fim de execuções ausentes.  HostStatsdMetricCollector Um IMetricCollector que coleta métricas do statsd do lado do host usando comandos do utilitário statsd.  ICommandScheduler.IScheduledInvocationListener Listener para eventos de invocação quando a invocação é concluída.  ILogSaverListener Permite que ITestInvocationListeners detectem quando os arquivos de registro são salvos.  IMetricCollector Essa interface será adicionada como um decorador ao informar os resultados dos testes para coletar métricas correspondentes.  IPostProcessor Os pós-processadores são um objeto do Trade Federation destinado a permitir o processamento de métricas e registros APÓS os testes e ANTES da geração de relatórios de resultados.  IShardableListener Um ITestInvocationListener que pode ser fragmentado.  ISupportGranularResults Interface que especifica se um ITestInvocationListener é compatível com o recebimento de resultados granulares ou não.  ITestInvocationListener Listener para resultados de teste da invocação de teste.  ITestSummaryListener Interface que permite que o ITestInvocationListener troque algumas informações limitadas por resumos.  InvocationProtoResultReporter Repórteres para armazenar informações de cache no nível da invocação e a lista de módulos. InvocationToJUnitResultForwarder Uma classe que detecta eventos ITestInvocationListener e os encaminha para um TestListener.  JarHostTest.HostTestListener Listener de wrapper que encaminha todos os eventos, exceto testRunStarted() e testRunEnded(), para o listener incorporado.  JavaCodeCoverageCollector Um BaseDeviceMetricCollector que extrai medições de cobertura do Java do dispositivo e as registra como artefatos de teste.  JsonHttpTestResultReporter Um criador de relatórios de resultados que codifica os resultados das métricas de teste e as informações de ramificação e dispositivo em JSON e POST em um endpoint de serviço HTTP. LUCIResultReporter Um gerador de relatórios de resultados que salva os resultados de teste necessários para o ResultDB e o LUCI no formato JSON (go/result-sink) e registra o local do arquivo no console.  LastShardDetector Ao executar o sharding local, às vezes só queremos executar algumas ações quando o último shard atingir invocationEnded(long).  LegacySubprocessResultsReporter Uma implementação congelada do gerador de relatórios de resultados de subprocessos que deve permanecer compatível com versões anteriores do TF/CTS (por exemplo, 8 ou mais), apesar das mudanças na superclasse.  LogSaverResultForwarder Um ResultForwarder para salvar registros com o salvador de arquivos global.  LogcatCrashResultForwarder Listener especial: em caso de 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 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.  MetricFilePostProcessor Usado para fazer upload do arquivo de registro de métricas coletado durante o teste e o nível de execução.  MetricsXMLResultReporter O MetricsXMLResultReporter grava métricas de teste e de execução 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 logcat, mas para o módulo.  ModulePerfettoCollector Coletor que inicia o rastreamento do perfetto quando um módulo de teste começa e termina e o dispositivo é reiniciado.  ModuleProtoResultReporter Um criador de relatórios de resultados destinado a informar apenas os resultados no nível do módulo.  ModuleResultsAndMetricsForwarder Uma extensão de ResultAndLogForwarder que adiciona métricas extras relacionadas ao módulo aos resultados do teste.  NameMangleListener Um listener de proxy para traduzir nomes de métodos, classes e pacotes de teste à medida que os resultados são informados.  PassingTestFileReporter Um ITestInvocationListener que salva a lista de casos de teste aprovados em um arquivo de teste  PerfettoFilePullerCollector Um coletor que extrai arquivos de rastreamento do Perfetto do dispositivo, compacta-os (opcionalmente) e os adiciona aos registros de teste.  PerfettoGenericPostProcessor Um pós-processador que processa o arquivo proto do perfetto de métrica de texto/binário em pares de chave-valor expandindo recursivamente as mensagens e os campos proto com valores de string até encontrar o campo com valor numérico.  PerfettoPullerMetricCollector Essa classe foi descontinuada. Use PerfettoFilePullerCollector e ERROR(/PerfettoTracePostProcessor) em vez disso.  PerfettoTracePostProcessor Um pós-processador que recupera arquivos de rastreamento do Perfetto dos registros de teste e executa o processador de rastreamento neles para produzir um proto de métrica do Perfetto.  PrettyTestEventLogger Registrador correspondente aos eventos e registro deles para facilitar a depuração.  ProtoResultReporter O criador de relatórios de resultados cria um protobuf TestRecord com todos os resultados.  PythonBinaryHostTest.PythonForwarder Encaminhador de resultados para substituir o nome da execução pelo nome binário.  RebootReasonCollector Coletor que coleta reinicializações de dispositivos durante o teste e as informa por motivo e contagem.  RemoteTestTimeOutEnforcer Listeners que permitem verificar o tempo de execução de uma determinada configuração de teste e falhar se ele exceder um determinado tempo limite.  ReportPassedTests Informar em um arquivo os possíveis filtros para excluir o teste aprovado.  ResultAggregator Encaminhador especial que agrega os resultados quando necessário, com base na estratégia de nova tentativa adotada.  ResultAndLogForwarder Encaminhador de resultados e eventos de registro.  ResultDBReporter Gerador de relatórios de resultados que faz upload dos resultados do teste para o ResultDB.  ResultForwarder Um ITestInvocationListener que encaminha resultados de invocação para uma lista de outros listeners.  ResultReporter   RetryLogSaverResultForwarder Encaminhador que também processa a transmissão da tentativa atual.  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 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.  ShardListener Um ITestInvocationListener que coleta resultados de um fragmento de invocação (ou seja, uma divisão de invocação para ser executada em vários recursos em paralelo) e os encaminha para outro listener.  ShardMainResultForwarder Um ResultForwarder que combina os resultados de invocações de teste fragmentadas.  ShowmapPullerMetricCollector Implementação básica de FilePullerDeviceMetricCollector que permite extrair os arquivos showmap do dispositivo e coletar as métricas dele.  SimpleperfProfilePostProcessor Um pós-processador que encontra dados de criação de perfil do simpleperf e gera um perfil pprof.  StatsdBeforeAfterGaugeMetricPostProcessor Um pós-processador que processa métricas de indicador coletadas em uma abordagem "antes/depois", ou seja, StatsdEventMetricPostProcessor Um pós-processador que processa métricas de eventos em relatórios do statsd em pares de chave-valor, usando os formatadores especificados no processador.  StatsdGenericPostProcessor Um pós-processador que processa relatórios binários do proto statsd em pares de chave-valor expandindo o relatório como uma estrutura de árvore.  StreamProtoResultReporter Uma implementação de ProtoResultReporter SubprocessResultsReporter Implementa ITestInvocationListener para ser especificado como um result_reporter e encaminha do subprocess os resultados de testes, execuções de teste e invocações de teste.  SuiteResultReporter Coletar resultados de testes para uma invocação de pacote inteiro e gerar os resultados finais.  TestResultListener Uma simplificação de ITestLifecycleListener para implementadores que se preocupam apenas com resultados de testes individuais.  TestRunResultListener Listener que permite ler o status final da execução do teste.  TestTimeoutEnforcer 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 Um criador de relatórios de resultados de testes que encaminha os resultados para a impressora de resultados de texto do JUnit.  TraceCmdCollector Um IMetricCollector que coleta rastreamentos durante o teste usando trace-cmd e os registra na invocação.  TradefedSandboxRunner.StubScheduledInvocationListener Um stub IScheduledInvocationListener que não faz nada.  XmlFormattedGeneratorReporter Implementação do FormattedGeneratorReporter que formata os resultados do conjunto em um formato XML.  XmlResultReporter Grava resultados do JUnit em arquivos XML em um formato consistente com XMLJUnitResultFormatter do Ant.

---

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

Baseado em org.junit.runner.notification.RunListener

A sequência de chamadas será:

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

Resumo

Métodos públicos
default void	testAssumptionFailure(TestDescription test, String trace) Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.
default void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) Informa o fim da execução de um caso de teste individual.
default void	testEnded(TestDescription test, long endTime, Map<String, String> testMetrics) Alternativa a testEnded(TestDescription,Map) em que podemos especificar o horário de término diretamente.
default 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.
default void	testEnded(TestDescription test, Map<String, String> 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) Informa 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, HashMap<String, MetricMeasurement.Metric> runMetrics) Informa o fim da execução do teste.
default void	testRunEnded(long elapsedTimeMillis, Map<String, String> runMetrics) Informa o fim da execução do teste.
default 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.
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 um teste.
default void	testRunStarted(String runName, int testCount) Informa o início de um teste.
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Informa o início de um teste.
default 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.
default void	testSkipped(TestDescription test, SkipReason reason) Chamado quando um teste é ignorado e não é executado por um motivo que geralmente não é esperado.
default 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.
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 ele pressupõe uma condição falsa.

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

testAssumptionFailure

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                Map<String, String> 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	Map: uma Map das métricas emitidas

testEnded

public 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 void testEnded (TestDescription test, 
                Map<String, String> 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	Map: uma 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 da 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, 
                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
elapsedTimeMillis	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.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                Map<String, String> runMetrics)

Informa o fim da execução do teste.

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

testRunFailed

public 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 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 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 void testRunStarted (String runName, 
                int testCount)

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

testRunStarted

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

TODO: atualmente não usado, 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 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 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 void testStarted (TestDescription test)

Informa o início de um caso de teste individual. Interface mais antiga. Use testStarted(TestDescription) sempre que possível.

Parâmetros
test	TestDescription: identifica o teste.