Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

TestResultListener

public abstract class TestResultListener
extends Object implements ITestLifeCycleReceiver

java.lang.Object
↳	com.android.tradefed.result.TestResultListener

Subclasses diretas conhecidas

ConsoleResultReporter, CountingTestResultListener, PassingTestFileReporter

ConsoleResultReporter	Gerador de relatórios de resultados para imprimir os resultados do teste no console.
CountingTestResultListener	Um `TestResultListener` que rastreia o número total de testes por `TestStatus`
PassingTestFileReporter	Um `ITestInvocationListener` que salva a lista de casos de teste aprovados em um arquivo de teste

Uma simplificação de ITestLifecycleListener para implementadores que se preocupam apenas com resultados de testes individuais.

Ele filtra os vários eventos do ciclo de vida até um método testResult.

Ele NÃO é seguro para linhas de execução e, em particular, pressupõe que os eventos ITestLifecycleListener sejam recebidos em ordem.

Resumo

Construtores públicos
`TestResultListener()`

Métodos públicos
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.
`final void`	`testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)` Alternativa a `testEnded(TestDescription,Map)` em que podemos especificar o horário de término diretamente.
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternativa a `testEnded(TestDescription,Map)` em que podemos especificar o horário de término diretamente.
`final void`	`testEnded(TestDescription test, Map<String, String> testMetrics)` Informa o fim da execução de um caso de teste individual.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Informa o fim da execução de um caso de teste individual.
`final void`	`testFailed(TestDescription test, String trace)` Informa a falha de um caso de teste individual.
`final void`	`testIgnored(TestDescription test)` Chamado quando um teste não é executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`abstract void`	`testResult(TestDescription test, TestResult result)`
`void`	`testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)` Informa o fim da execução do teste.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Chamado quando um teste é ignorado e não é executado por um motivo que geralmente não é esperado.
`final void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(TestDescription)` em que também especificamos quando o teste foi iniciado, combinado com `testEnded(TestDescription,long,Map)` para uma medição precisa.
`final void`	`testStarted(TestDescription test)` Informa o início de um caso de teste individual.

Construtores públicos

TestResultListener

public TestResultListener ()

Métodos públicos

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Chamado quando um teste atômico sinaliza que ele pressupõe uma condição falsa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`trace`	`String`: stack trace da falha

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                Map<String, String> testMetrics)

Alternativa a testEnded(TestDescription,Map) em que podemos especificar o horário de término diretamente. Combine com testStarted(TestDescription,long) para uma medição precisa.

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

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternativa a testEnded(TestDescription,Map) em que podemos especificar o horário de término diretamente. Combine com testStarted(TestDescription,long) para uma medição precisa.

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

testEnded

public final void testEnded (TestDescription test, 
                Map<String, String> 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 todas 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`	`Map`: uma `Map` das métricas emitidas

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Informa o fim da execução de um caso de teste individual.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`testMetrics`	`HashMap`: uma `Map` das métricas emitidas

testFailed

public final 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 da falha

testIgnored

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

testResult

public abstract void testResult (TestDescription test, 
                TestResult result)

Parâmetros
`test`	`TestDescription`
`result`	`TestResult`

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Informa o fim da execução do teste. FIXME: Não podemos ter duas interfaces Map<> com tipos diferentes, então precisamos usar HashMap aqui.

Parâmetros
`elapsedTimeMillis`	`long`: tempo decorrido informado pelo dispositivo, em milissegundos
`runMetrics`	`HashMap`: pares de chave-valor informados no final de uma execução de teste com `Metric`.

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chamado quando um teste é ignorado e não é executado por um motivo que geralmente não é esperado. Esses testes serão repetidos para tentar uma execução adequada.

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

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(TestDescription) em que também especificamos quando o teste foi iniciado, combinado com testEnded(TestDescription,long,Map) para uma medição precisa.

Parâmetros
`test`	`TestDescription`: identifica o teste.
`startTime`	`long`: o horário em que o teste começou, medido por `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Informa o início de um caso de teste individual. Interface mais antiga. Use testStarted(TestDescription) sempre que possível.

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