ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener
AggregatePostProcessor Um agregador de métricas que fornece 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 múltiplas iterações, tratando-as como duplas.
AtraceCollector Um IMetricCollector que executa umtrace durante um teste e coleta o resultado e registra-o na invocação.
Coletor AtraceRunMetric Coleta os rastreamentos de todo o diretório de teste no diretório fornecido do dispositivo de teste, registra o diretório de teste e pós-processa os arquivos de rastreamento no diretório de teste e agrega as métricas.
MédiaPós-Processador 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 parar a coleta em onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) e ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .
BasePostProcessor O IPostProcessor base que toda implementação deve estender.
BluetoothConnectionLatencyCollector O coletor enviará uma configuração de métrica de duração statsd predefinida para os dispositivos e coletará a duração da conexão Bluetooth para cada perfil.
BluetoothConnectionStateCollector Este coletor coletará métricas BluetoothConnectionStateChanged e registrará o número do estado da conexão para cada perfil.
BluetoothConnectionSuccessRatePostProcessor Implementação de pós-processador que calcula a taxa de sucesso para 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 espionagem Bluetooth HCI no DUT e coletar o registro para cada teste.
Coletor de relatórios de bugs Um ITestInvocationListener de passagem que coleta relatórios de bugs quando ocorrem eventos configuráveis ​​e, em seguida, chama ITestInvocationListener#testLog em seus filhos após cada relatório de bug ser coletado.
BugreportzOnFailureCollector Colete um bugreportz quando um caso de teste falhar.
BugreportzOnTestCaseFailureCollector Colete um bugreportz quando um caso de teste falhar em uma execução.
ClangCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá medições de cobertura Clang do dispositivo e as registrará como artefatos de teste.
ColetandoTestListener Um ITestInvocationListener que coletará todos os resultados dos testes.
CommandStatusHandler Manipulador ajudando a monitorar e atualizar o status de uma invocação.
CondiçãoFailureMonitor Monitore quaisquer falhas da invocação.
ConsoleResultReporter Reporter de resultados para imprimir os resultados do teste no console.
CountTestCasesCollector Conte e relate o número de casos de teste para um determinado IRemoteTest .
DebugHostLogOnFailureCollector Coletor que reunirá e registrará os logs do lado do host quando ocorrer uma falha no caso de teste.
DispositivoReleaseReporter Relator de liberação de dispositivo que lida com a comunicação com o processo pai do(s) dispositivo(s) a ser(em) liberado(s).
Coletor DeviceTrace Coletor que iniciará o rastreamento perfeito quando uma execução de teste for iniciada e registrará o arquivo de rastreamento no final.
DispositivoIndisponívelMonitor Este ouvinte tenta capturar apenas um DNAE de nível de caso de teste.
EventsLoggerListener Ouvinte que registra todos os eventos que recebe em um arquivo
ArquivoProtoResultReporter Repórter proto que despeja o TestRecord em um arquivo.
FilePullerDeviceMetricCollector Um BaseDeviceMetricCollector que escuta a chave de métricas proveniente do dispositivo e as extrai como um arquivo do dispositivo.
FilePullerLogCollector Registrador do arquivo relatado pelo lado do dispositivo.
FilteredResultForwarder Variante do ResultForwarder que só permite que uma lista de permissões de TestDescription seja relatada.
FormatadoGeneratorReporter Repórter que permite gerar relatórios em um formato específico.
Coletor GcovCodeCoverage Um BaseDeviceMetricCollector que extrairá medições de cobertura gcov do dispositivo e as registrará como artefatos de teste.
GcovKernelCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá medições de cobertura do kernel gcov do debugfs e do dispositivo e, finalmente, as registrará como artefatos de teste.
GranularRetriableTestWrapper.StartEndCollector Auxiliar de classe para capturar o início e o fim da execução ausente.
HostStatsdMetricCollector Um IMetricCollector que coleta métricas statsd do lado do host usando comandos do utilitário statsd.
ICommandScheduler.IScheduledInvocationListener Ouvinte para eventos de invocação quando a invocação for concluída.
ILogSaverListener Permite que ITestInvocationListener s escutem quando os arquivos de log são salvos.
Coletor IMetric Esta interface será adicionada como decorador ao relatar resultados de testes para coletar métricas correspondentes.
IPostProcessador Pós-processadores é um objeto da Federação Comercial destinado a permitir o processamento de métricas e logs APÓS os testes e ANTES do relatório de resultados.
IShardableListener Um ITestInvocationListener que pode ser fragmentado.
ISupportGranularResults Interface que especifica se um ITestInvocationListener suporta ou não o recebimento de resultados granulares.
ITestSummaryListener Interface que permite ao ITestInvocationListener trocar algumas informações limitadas por meio de resumos.
InvocationToJUnitResultForwarder Uma classe que escuta eventos ITestInvocationListener e os encaminha para um TestListener .
JarHostTest.HostTestListener Ouvinte wrapper que encaminha todos os eventos, exceto testRunStarted() e testRunEnded() para o ouvinte incorporado.
JavaCodeCoverageCollector Um BaseDeviceMetricCollector que extrairá medições de cobertura Java do dispositivo e as registrará como artefatos de teste.
JsonHttpTestResultReporter Um repórter de resultados que codifica os resultados das métricas de teste e ramifica as informações do dispositivo em JSON e POST em um terminal de serviço HTTP
LUCIResultReporter Um repórter de resultados que salva os resultados dos testes necessários para ResultDB e LUCI no formato JSON (go/result-sink) e registra o local do arquivo no console.
ÚltimoShardDetector 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 repórter de resultados do subprocesso que deve permanecer compatível com versões anteriores do TF/CTS (por exemplo, 8+), apesar das mudanças em sua superclasse.
LogSaverResultForwarder Um ResultForwarder para salvar logs com a proteção global de arquivos.
LogcatCrashResultForwarder Ouvinte especial: em caso de falhas (travamento do processo de instrumentação) ele tentará extrair do logcat a falha e adicioná-la à mensagem de falha associada ao teste.
LogcatOnFailureCollector Coletor que capturará e registrará um logcat quando um caso de teste falhar.
LogcatTimingMetricCollector Um coletor de métrica que coleta informações de tempo (por exemplo, tempo de troca do usuário) do logcat durante um ou vários testes repetidos usando determinados padrões de regex para analisar sinais de início e fim de um evento a partir de linhas de logcat.
MetricFilePostProcessor Usado para carregar o arquivo de log de métricas coletado durante o nível de teste e execução.
MétricasXMLResultReporter MetricsXMLResultReporter grava métricas de teste e executa métricas em um arquivo XML em uma pasta especificada pelo parâmetro de pasta de métricas na fase invocationEnded do teste.
MóduloListener Ouvinte anexado a cada IRemoteTest de cada módulo para coletar a lista de resultados.
MóduloLogcatCollector Versão do coletor logcat, mas para módulo.
NomeMangleListener Um ouvinte proxy para traduzir nomes de métodos de teste, classes e pacotes à medida que os resultados são relatados.
PassandoTestFileReporter Um ITestInvocationListener que salva a lista de casos de teste aprovados em um arquivo de teste
PerfettoGenericPostProcessor Um pós-processador que processa arquivo proto perfeito de métrica de texto/binária em pares de valores-chave, expandindo recursivamente as mensagens proto e os campos com valores de string até que o campo com valor numérico seja encontrado.
PerfettoPullerMetricCollector Implementação básica do FilePullerDeviceMetricCollector que permite extrair os arquivos perfeitos do dispositivo e coletar as métricas dele.
PrettyTestEventLogger Registrador combinando os eventos e registrando-os para facilitar a depuração.
ProtoResultReporter O repórter de resultados cria um protobuf TestRecord com todos os resultados dentro.
PythonBinaryHostTest.PythonForwarder Encaminhador de resultados para substituir o nome da execução pelo nome binário.
RebootReasonCollector Coletor que coleta reinicializações do dispositivo durante a execução do teste e as reporta por motivo e contagens.
RemoteTestTimeOutEnforcer Listeners que permitem verificar o tempo de execução de uma determinada configuração de teste e reprová-lo se ultrapassar um determinado tempo limite.
Relatório de testes aprovados Informar em um arquivo possíveis filtros para excluir teste aprovado.
Agregador de Resultados Forwarder especial que agrega os resultados quando necessário, com base na estratégia de repetição adotada.
ResultadoAndLogForwarder Encaminhador para resultados e eventos de log.
ResultForwarder Um ITestInvocationListener que encaminha os resultados da invocação para uma lista de outros ouvintes.
RetryLogSaverResultForwarder Encaminhador que também lida com a passagem da tentativa atual em que estamos.
RetryResultForwarder Uma extensão do ResultForwarder que sempre envia para um determinado número de tentativa.
RuntimeRestartCollector Coletor que coleta carimbos de data/hora de reinicializações de tempo de execução (travamentos do servidor do sistema) durante a execução do teste, se houver.
Captura de telaOnFailureCollector Coletor que irá capturar e registrar uma captura de tela quando um caso de teste falhar.
ShardListener 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 ouvinte.
ShardMainResultForwarder Um ResultForwarder que combina os resultados de invocações de teste fragmentadas.
ShowmapPullerMetricCollector Implementação básica do FilePullerDeviceMetricCollector que permite extrair os arquivos showmap do dispositivo e coletar as métricas dele.
StatsdBeforeAfterGaugeMetricPostProcessor Um pós-processador que processa métricas de medição coletadas em uma abordagem "antes/depois", ou seja,
StatsdEventMetricPostProcessor Um pós-processador que processa métricas de eventos em relatórios statsd em pares de valores-chave, usando os formatadores especificados no processador.
StatsdGenericPostProcessor Um pós-processador que processa relatórios proto statsd binários em pares de valores-chave, expandindo o relatório como uma estrutura em árvore.
StreamProtoResultReporter Uma implementação do ProtoResultReporter
SubprocessResultsReporter Implementa ITestInvocationListener para ser especificado como result_reporter e encaminha do subprocesso os resultados de testes, execuções de teste e invocações de teste.
SuiteResultReporter Colete os resultados dos testes para uma invocação de conjunto inteiro e produza os resultados finais.
TestFailureListener O ouvinte costumava executar ações como captura de tela, relatório de bug e coleta de logcat em caso de falha no teste, quando solicitado.
TestTimeoutEnforcer Listeners que permitem verificar o tempo de execução de um determinado caso de teste e reprová-lo caso ultrapasse um determinado tempo limite.
TextResultReporter Um repórter de resultados de teste que encaminha os resultados para a impressora de resultados de texto 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 A implementação do FormattedGeneratorReporter que formata o conjunto resulta em um formato xml.
XmlResultReporter Grava resultados JUnit em arquivos XML em um formato consistente com XMLJUnitResultFormatter do Ant.


Ouvinte para resultados de teste da invocação de teste.

Uma invocação de teste pode incluir várias execuções de teste, portanto a sequência de chamadas será

  • invocaçãoStarted(BuildInfo)
  • testRunStarted
  • teste iniciado
  • [teste falhou]
  • teste finalizado
  • ...
  • testRunEnded
  • ...
  • testRunStarted
  • ...
  • testRunEnded
  • [falha na invocação]
  • [testLog+]
  • invocaçãoEnded
  • obter Resumo

Resumo

Métodos públicos

default TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

default void invocationEnded (long elapsedTime)

Relata que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.

default void invocationFailed ( FailureDescription failure)

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

default void invocationFailed (Throwable cause)

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

default void invocationInterrupted ()

Chamado no encerramento do agendador, dá à invocação a oportunidade de fazer algo antes de encerrar.

default void invocationSkipped ( SkipReason reason)

Relata uma invocação como ignorada

default void invocationStarted ( IInvocationContext context)

Informa o início da chamada de teste.

default void testModuleEnded ()

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

default void testModuleStarted ( IInvocationContext moduleContext)

Relata o início de um módulo em execução.

Métodos públicos

obter Resumo

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Devoluções
TestSummary Um TestSummary resumindo a execução ou nulo

invocaçãoEnded

public void invocationEnded (long elapsedTime)

Relata que a invocação foi encerrada, seja com êxito ou devido a alguma condição de erro.

Será chamado automaticamente pelo framework TradeFederation.

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

invocaçãoFailed

public void invocationFailed (FailureDescription failure)

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

Será chamado automaticamente pelo framework TradeFederation.

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

invocaçãoFailed

public void invocationFailed (Throwable cause)

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

Será chamado automaticamente pelo framework TradeFederation.

Parâmetros
cause Throwable : a causa Throwable da falha

invocaçãoInterrompida

public void invocationInterrupted ()

Chamado no encerramento do agendador, dá à invocação a oportunidade de fazer algo antes de encerrar.

invocaçãoSkipped

public void invocationSkipped (SkipReason reason)

Relata uma invocação como ignorada

Parâmetros
reason SkipReason

invocaçãoiniciada

public void invocationStarted (IInvocationContext context)

Informa o início da chamada de teste.

Será chamado automaticamente pelo framework TradeFederation. Os repórteres precisam substituir esse método para oferecer suporte a relatórios de vários dispositivos.

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

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Relata o início de um módulo em execução. Este retorno de chamada está associado a testModuleEnded() e é opcional na sequência. Ele é usado apenas durante uma execução que usa módulos: executores baseados em suíte.

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