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 , CollectingTestListener , and 75 others.

AggregatePostProcessor	Um agregador de métrica 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 duplas.
AtraceCollectorName	Um `IMetricCollector` que executa um rastreamento durante um teste e coleta o resultado e os registra na invocação.
AtraceRunMetricCollectorName	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.
AveragePostProcessor	Implementação de pós-processador que calcula a média da lista de métricas.
BaseDeviceMetricCollector	Implementação base do `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 estatística predefinida aos dispositivos e coletará a duração da conexão Bluetooth para cada perfil.
BluetoothConnectionStateCollector	Esse 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 taxa de sucesso para um perfil bluetooth Use "metric-key-match" para especificar as métricas que contêm estados de conexão bluetooth no array numérico Exemplo [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Coletor para habilitar o registro de espionagem Bluetooth HCI no DUT e para coletar o log para cada teste.
BugreportCollector	Um `ITestInvocationListener` de passagem que coleta relatórios de bug quando ocorrem eventos configuráveis e, em seguida, chama `ITestInvocationListener#testLog` em seus filhos após a coleta de cada relatório de bug.
BugreportzOnFailureCollector	Colete um relatório de bug quando um caso de teste falhar.
BugreportzOnTestCaseFailureCollector	Colete um bugreportz quando um caso de teste em uma execução falhar.
ClangCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá as medições de cobertura Clang do dispositivo e as registrará como artefatos de teste.
CollectingTestListener	Um `ITestInvocationListener` que coletará todos os resultados do teste.
CommandStatusHandler	Manipulador que ajuda a monitorar e atualizar o status de uma invocação.
ConditionFailureMonitor	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` .
CountingTestResultListener	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 de caso de teste.
DeviceReleaseReporter	Reporter de liberação de dispositivo que lida com a comunicação com o processo pai do(s) dispositivo(s) a ser(em) liberado(s).
DeviceTraceCollector	Coletor que iniciará o rastreamento perfeito quando uma execução de teste for iniciada e o arquivo de rastreamento de log no final.
DispositivoIndisponivelMonitor	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	Proto repórter 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.
FilePullerLogCollectorName	Logger do arquivo reportado pelo device-side.
FilteredResultForwarder	Variante de `ResultForwarder` que permite apenas que uma lista de permissões de `TestDescription` seja relatada.
GeradorReporter Formatado	Reporter que permite gerar relatórios em um formato particular.
GcovCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá as medições de cobertura gcov do dispositivo e as registrará como artefatos de teste.
GcovKernelCodeCoverageCollector	Um `BaseDeviceMetricCollector` que extrairá as medições de cobertura do kernel gcov dos 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 é concluída.
ILogSaverListener	Permite que `ITestInvocationListener` s escute quando os arquivos de log são salvos.
IMetricCollector	Essa interface será adicionada como um decorador ao relatar os resultados dos testes para coletar métricas correspondentes.
IPostProcessor	Os pós-processadores são um objeto da Trade Federation destinado a permitir o processamento de métricas e logs DEPOIS dos testes e ANTES do relatório de resultados.
IShardableListenerName	Um `ITestInvocationListener` que pode ser fragmentado.
ISupportGranularResults	Interface especificando se um `ITestInvocationListener` dá suporte ao recebimento de resultados granulares ou não.
ITestInvocationListener	Ouvinte para resultados de teste da chamada de teste.
ITestSummaryListener	Interface que permite que `ITestInvocationListener` troque 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 resultados de métricas de teste e ramifica, informações do dispositivo em JSON e POST em um terminal de serviço HTTP
LastShardDetector	Ao executar o sharding local, às vezes queremos apenas executar algumas ações quando o último shard atingir `invocationEnded(long)` .
LegacySubprocessResultsReporter	Uma implementação congelada do subprocess results reporter 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 o protetor de arquivo global.
LogcatCrashResultForwarder	Ouvinte especial: em caso de falha (travamento do processo de instrumentação), ele tentará extrair do logcat o travamento e adicioná-lo à mensagem de falha associada ao teste.
LogcatOnFailureCollector	Coletor que irá 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 regex para analisar os sinais de início e fim de um evento das linhas do logcat.
MetricFilePostProcessor	Usado para fazer upload do arquivo de log de métricas coletado durante o nível de teste e execução.
MetricsXMLResultReporter	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.
ModuleListener	Ouvinte 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.
NomeMangleListener	Um ouvinte proxy para traduzir nomes de método de teste, classe e pacote conforme os resultados são relatados.
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 perfetto de métrica binária/texto em pares chave-valor 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 base do `FilePullerDeviceMetricCollector` que permite extrair os arquivos perfetto do dispositivo e coletar as métricas dele.
PrettyTestEventLogger	Logger 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 a reinicialização do dispositivo durante a execução do teste e os relata por motivo e contagens.
RemoteTestTimeOutEnforcer	Ouvintes que permitem verificar o tempo de execução de uma determinada configuração de teste e reprová-la se ultrapassar um determinado tempo limite.
ReportPassedTests	Relate em um arquivo possíveis filtros para excluir o teste aprovado.
ResultAggregator	Forwarder especial que agrega os resultados quando necessário, com base na estratégia de repetição que foi tomada.
ResultAndLogForwarder	Encaminhador para resultados e eventos de logs.
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 do 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.
ShardListenerGenericName	Um `ITestInvocationListener` que coleta resultados de um estilhaço de invocação (também conhecido como uma divisão de invocação para executar em vários recursos em paralelo) e os encaminha para outro ouvinte.
ShardMainResultForwarder	Um `ResultForwarder` que combina os resultados de invocações de teste fragmentado.
ShowmapPullerMetricCollector	Implementação base 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 chave-valor, usando os formatadores especificados no processador.
StatsdGenericPostProcessor	Um pós-processador que processa relatórios proto statsd binários em pares chave-valor, expandindo o relatório como uma estrutura de árvore.
StreamProtoResultReporter	Uma implementação do `ProtoResultReporter`
SubprocessResultsReporter	Implementa `ITestInvocationListener` para ser especificado como um result_reporter e encaminhar do subprocesso os resultados dos testes, execuções de teste, invocações de teste.
SuiteResultReporter	Colete resultados de teste para uma invocação de conjunto inteira e gere os resultados finais.
TestFailureListener	Ouvinte usado para executar ações como captura de tela, relatório de bug, coleta de logcat após uma falha de teste quando solicitado.
TestResultListener	Uma simplificação de ITestLifecycleListener para implementadores que se preocupam apenas com resultados de testes individuais.
TestTimeoutEnforcer	Ouvintes que permitem verificar o tempo de execução de um determinado caso de teste e rejeitá-lo se ultrapassar um determinado tempo limite.
TextResultReporter	Um relator 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	Implementação do `FormattedGeneratorReporter` que formata os resultados da suite em formato xml.
XmlResultReporterName	Grava os resultados do JUnit em arquivos XML em um formato consistente com o XMLJUnitResultFormatter do Ant.

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

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

A sequência de chamadas será:

testRunStarted
testStarted
[teste falhou]
[testAssumptionFailure]
[testeIgnorado]
testeFinalizado
....
[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)` Informa o fim 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 fim da execução do teste.
`default void`	`testRunFailed ( FailureDescription failure)` A execução do teste de relatórios falhou 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`	`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 medição precisa .
`default void`	`testStarted ( TestDescription test)` Relata 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 assume uma condição falsa

Parâmetros
`test`	`TestDescription` : identifica o teste
`trace`	`String` : rastreamento de pilha de falha

testAssumptionFailure

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

testeFinalizado

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` : a hora em que o teste terminou, medido via `ERROR(/System#currentTimeMillis())`
`testMetrics`	: um `ERROR(/Map)` das métricas emitidas

testeFinalizado

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 chamado, esse 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` descrevendo 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 fim 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 chave-valor 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 falhou devido a uma falha descrita por FailureDescription .

Parâmetros
`failure`	`FailureDescription` : `FailureDescription` descrevendo 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` : `ERROR(/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 do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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 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 do pedido, identificando as diferentes tentativas do mesmo runName que executam várias vezes. O tryNumber é indexado em 0 e deve ser incrementado toda vez que uma nova execução ocorrer. Por exemplo, um teste é repetido granularmente 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 `ERROR(/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

testStarted

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 medição precisa .

Parâmetros
`test`	`TestDescription` : identifica o teste
`startTime`	`long` : a hora em que o teste começou, medido via `ERROR(/System#currentTimeMillis())`

testStarted

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