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.

ITestLifeCycleReceptor

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 , CollectingTestListener e 76 outros.

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` .
ContandoTestResultListener	Um `TestResultListener` que rastreia o número total de testes por `TestStatus`
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.
ITestInvocationListener	Ouvinte para resultados de teste da invocação de teste.
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.
TestResultListener	Uma simplificação do ITestLifecycleListener para implementadores que se preocupam apenas com resultados de testes individuais.
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.

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

Padronizado após org.junit.runner.notification.RunListener

A sequência de chamadas será:

testRunStarted
teste iniciado
[teste falhou]
[testeAssunçãoFalha]
[testeIgnorado]
teste finalizado
....
[testRunFailed]
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)` `testEnded ( TestDescription test, long endTime, testMetrics)` Alternativa para `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` onde podemos especificar o horário de término diretamente.
`default void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Relata 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 será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`default void`	`testRunEnded (long elapsedTimeMillis, runMetrics)` `testRunEnded (long elapsedTimeMillis, runMetrics)` Informa o final 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 foi executado por um motivo que normalmente não é esperado.
`default void`	`testStarted ( TestDescription test, long startTime)` Alternativa para `testStarted(com.android.tradefed.result.TestDescription)` onde 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)` Relata o início de um caso de teste individual.

Métodos públicos

testeAssunçãoFalha

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` : rastreamento de pilha de falha

testeAssunçãoFalha

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` que descreve a falha e seu contexto.

teste finalizado

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa para ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) onde podemos especificar o horário de término diretamente. Combine com testStarted(com.android.tradefed.result.TestDescription, long) para uma medida precisa.

Parâmetros
`test`	`TestDescription` : identifica o teste
`endTime`	`long` : o horário em que o teste terminou, medido via `System.currentTimeMillis()`
`testMetrics`	: um `ERROR(/Map)` das métricas emitidas

teste finalizado

public void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) não foi invocado, este teste foi aprovado. Também retorna quaisquer métricas de chave/valor que possam 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

teste falhou

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` que descreve a falha e seu contexto.

teste falhou

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` : rastreamento de pilha de falha

testeIgnorado

public void testIgnored (TestDescription test)

Chamado quando um teste não será 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 final da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então temos que usar HashMap aqui.

Parâmetros
`elapsedTimeMillis`	`long` : tempo decorrido relatado pelo dispositivo, em milissegundos
`runMetrics`	: pares de valores-chave relatados no final de uma execução de 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` que descreve a falha e seu 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` que descreve 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 em execução de teste
`attemptNumber`	`int` : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é 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 em execução de 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 em execução de teste
`attemptNumber`	`int` : número do pedido, identificando as diferentes tentativas do mesmo runName que são executadas diversas vezes. O tryNumber é indexado em 0 e deve aumentar sempre que uma nova execução acontece. por exemplo, um teste é repetido de forma granular 3 vezes, deve ter 4 execuções totais sob o mesmo runName e o tryNumber é de 0 a 3.
`startTime`	`long` : a hora em que a execução começou, medida via `System.currentTimeMillis()`

testRunStopped

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: atualmente não utilizado, considere remover

Parâmetros
`elapsedTime`	`long` : tempo decorrido relatado pelo dispositivo, em milissegundos

teste ignorado

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não foi executado por um motivo que normalmente não é esperado. Esses testes serão tentados novamente para tentar obter uma execução adequada.

Parâmetros
`test`	`TestDescription` : identifica o teste
`reason`	`SkipReason` : `SkipReason`

teste iniciado

public void testStarted (TestDescription test, 
                long startTime)

Alternativa para testStarted(com.android.tradefed.result.TestDescription) onde 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` : a hora em que o teste começou, medido via `System.currentTimeMillis()`

teste iniciado

public void testStarted (TestDescription test)

Relata o início de um caso de teste individual. Interface mais antiga, deve usar testStarted(com.android.tradefed.result.TestDescription) sempre que possível.

Parâmetros
`test`	`TestDescription` : identifica o teste