A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.

Esta página foi traduzida pela API Cloud Translation.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

Subclasses indiretas conhecidas

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector e mais 81.

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.
AtraceCollector	Um `IMetricCollector` que executa um rastreamento durante um teste e coleta o resultado e o registra na invocação.
AtraceRunMetricCollector	Coleta os rastreamentos 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 rastreamento 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(com.android.tradefed.device.metric.DeviceMetricData)` e `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.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 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 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	Coletar um bugreportz quando um caso de teste falhar.
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 do dispositivo as medições de cobertura nativa e em Java 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`.
DebugHostLogOnFailureCollector	Coletor que vai reunir e registrar os registros do lado do host quando uma falha de caso de teste ocorrer.
DeviceReleaseReporter	Gerenciador de relatórios de liberação de dispositivos 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 do 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 registrar como artefatos de teste.
GcovKernelCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai as medições de cobertura do kernel gcov de debugfs e do dispositivo e, por fim, as registra como artefatos de teste.
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 `ITestInvocationListener`s 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 que permite 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.
ITestSummaryListener	Interface que permite ao `ITestInvocationListener` trocar algumas informações limitadas por resumos.
InvocationProtoResultReporter	Repórteres para armazenar informações de cache no nível de 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 testes 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 fragmento atinge `invocationEnded(long)`.
LegacySubprocessResultsReporter	Uma implementação congelada do gravador de resultados de subprocesso 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 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.
ModuleProtoResultReporter	Um gerador 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 arquivos proto do Perfetto de métricas 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étricas do Perfetto.
PrettyTestEventLogger	Registrador correspondente aos eventos e registro deles para facilitar a depuração.
ProtoResultReporter	O ResultReporter 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 ela 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 os carimbos de data/hora das reinicializações de tempo de execução (falhas do servidor do sistema) durante a execução do teste, se houver.
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.
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 subprocesso 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.
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.

Listener 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á

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
…
testRunEnded
…
testRunStarted
…
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

Resumo

Métodos públicos
`default TestSummary`	`getSummary()` Permite que o InvocationListener retorne um resumo.
`default void`	`invocationEnded(long elapsedTime)` Informa que a invocação foi encerrada, seja com sucesso ou devido a alguma condição de erro.
`default void`	`invocationFailed(FailureDescription failure)` Informa uma invocação incompleta devido a alguma condição de erro.
`default void`	`invocationFailed(Throwable cause)` Informa uma invocação incompleta devido a alguma condição de erro.
`default void`	`invocationInterrupted()` Chamado no encerramento do scheduler, dá à invocação a oportunidade de fazer algo antes de terminar.
`default void`	`invocationSkipped(SkipReason reason)` Informa que uma invocação foi ignorada
`default void`	`invocationStarted(IInvocationContext context)` Informa o início da invocação do teste.
`default void`	`testModuleEnded()` Informa o fim da execução de um módulo.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Informa o início da execução de um módulo.

Métodos públicos

getSummary

public TestSummary getSummary ()

Permite que o InvocationListener retorne um resumo.

Retorna
`TestSummary`	Um `TestSummary` que resume a execução ou nulo

invocationEnded

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

invocationInterrupted

public void invocationInterrupted ()

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que uma invocação foi ignorada

Parâmetros
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa o início da invocação do teste.

Será chamado automaticamente pela estrutura 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)

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

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