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.

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, CodeCoverageCollector e 81 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 atrace durante um teste, coleta o resultado e registra ele 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 de um 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	Esse coletor vai coletar métricas de BluetoothConnectionStateChanged e registrar o número do estado de 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 de Bluetooth em um exemplo de matriz numérica [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	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.
CodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrai medições de cobertura nativa e do Java do dispositivo e as registra como artefatos de teste.
CollectingTestListener	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 falhas na invocação.
ConsoleResultReporter	O Result Reporter imprime os resultados do teste no console.
CountTestCasesCollector	Contar e informar 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 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	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 uma DNAE no nível do caso de teste.
EventsLoggerListener	Listener que registra todos os eventos recebidos em um arquivo
FileProtoResultReporter	Relatório de proto que despeja o `TestRecord` em um arquivo.
FilePullerDeviceMetricCollector	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	Relatório 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	Auxílio de classe para detectar início e término de execução ausentes.
HostStatsdMetricCollector	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 informar os resultados dos testes para coletar as 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	Um `ITestInvocationListener` que pode ser dividido.
ISupportGranularResults	Interface que especifica se um `ITestInvocationListener` oferece suporte ao recebimento dos resultados granulares ou não.
ITestInvocationListener	Listener para resultados de teste da invocação do teste.
ITestSummaryListener	Interface que permite que `ITestInvocationListener` troque algumas informações limitadas por meio de resumos.
InvocationProtoResultReporter	Geradores de relatórios para armazenar informações de armazenamento em 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 as medições de cobertura do Java do dispositivo e as registra 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	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 (processo de instrumentação com falha), ele tenta extrair a falha do logcat 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 de logcat, mas para o módulo.
ModuleProtoResultReporter	Um relatório 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 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 registrador que corresponde aos eventos e os registra para facilitar a depuração.
ProtoResultReporter	O Result Reporter 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 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 exceder um determinado tempo limite.
ReportPassedTests	Informe 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 usada.
ResultAndLogForwarder	Encaminhador de resultados e eventos de registro.
ResultDBReporter
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.
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.
ScreenshotOnFailureCollector	Coletor que vai 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 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 do 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 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 de statsd proto binários em pares de chave-valor expandindo o relatório como uma estrutura em á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	Colete os resultados do teste de uma invocação de conjunto inteiro e gere os resultados finais.
TestResultListener	Uma simplificação de ITestLifecycleListener para implementadores que se importam apenas de resultados de teste 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 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	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
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

Resumo

Métodos públicos
`default void`	`testAssumptionFailure(TestDescription test, String trace)` Chamada 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)` 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, runMetrics)` Informa o fim da execução do teste.
`default void`	`testRunFailed(FailureDescription failure)` A execução do teste 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)` Informa que a execução do teste 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 encerrado, medido por `System.currentTimeMillis()`
`testMetrics`	: uma `ERROR(/Map)` das métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 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 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 no 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 attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado granularmente três vezes, precisa ter quatro execuções no total com o mesmo runName e o attemptNumber 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 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 attemptNumber é indexado em 0 e precisa ser incrementado sempre que uma nova execução acontece. Por exemplo, um teste é tentado três vezes, então precisa ter quatro execuções no total com o mesmo runName e o attemptNumber varia 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)

Informa que a execução do teste 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 é pulado e não é executado por um motivo que não é esperado. Esses testes serão tentados novamente 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(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