A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco 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, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Subclasses indiretas conhecidas

StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener

StubTestRunListener	Implementação de stub de `ITestRunListener`
TestRunResult	Contém resultados de uma única execução de teste.
TestRunToTestInvocationForwarder	Encaminhador de ddmlib `ITestRunListener` para `ITestLifeCycleReceiver`.
XmlTestRunListener	Grava resultados do JUnit em arquivos XML em um formato consistente com o XMLJUnitResultFormatter do Ant.

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

Baseado 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
`abstract void`	`testAssumptionFailure(TestIdentifier test, String trace)` Chamado quando um teste atômico sinaliza que pressupõe uma condição falsa.
`abstract void`	`testEnded(TestIdentifier test, testMetrics)` Informa o fim da execução de um caso de teste individual.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Informa a falha de um caso de teste individual.
`abstract void`	`testIgnored(TestIdentifier test)` Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.
`abstract void`	`testRunEnded(long elapsedTime, runMetrics)` Informa o fim da execução do teste.
`abstract void`	`testRunFailed(String errorMessage)` O teste de execução de relatórios não foi concluído devido a um erro fatal.
`abstract void`	`testRunStarted(String runName, int testCount)` Informa o início de uma execução de teste.
`abstract void`	`testRunStopped(long elapsedTime)` Esse método foi descontinuado. Esse callback nunca é invocado. A ser excluído.
`abstract void`	`testStarted(TestIdentifier test)` Informa o início de um caso de teste individual.

Métodos públicos

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

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

Se testFailed(TestIdentifier, String) 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

TestIdentifier: identifica o teste.

testMetrics

: um ERROR(/Map) das métricas emitidas durante a execução do caso de teste pelo android.app.Instrumentation#sendStatus. A ordem de inserção é preservada, a menos que você emita a mesma chave várias vezes. As chaves padrão definidas em IInstrumentationResultParser.StatusKeys são filtradas deste mapa. A Ddmlib pode adicionar métricas de teste extras definidas em IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

Informa a falha de um caso de teste individual.

Será chamado entre testStarted e testEnded.

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

testIgnored

public abstract void testIgnored (TestIdentifier test)

Chamado quando um teste não será executado, geralmente porque um método de teste é anotado com org.junit.Ignore.

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

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa o fim da execução do teste.

Parâmetros

elapsedTime

long: tempo decorrido informado pelo dispositivo, em milissegundos

runMetrics

: um ERROR(/Map) das métricas emitidas durante a execução do caso de teste pelo android.app.Instrumentation#addResults. A ordem de inserção é preservada, a menos que você emita a mesma chave várias vezes. As chaves padrão definidas em IInstrumentationResultParser.StatusKeys são filtradas deste mapa. A Ddmlib pode adicionar métricas de teste extras definidas em IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

O teste de execução de relatórios não foi concluído devido a um erro fatal.

Parâmetros
`errorMessage`	`String`: `String` descrevendo o motivo da falha na execução.

testRunStarted

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

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Esse método foi descontinuado.
Esse callback nunca é invocado. A ser excluído.

O relatório informa que a execução do teste foi interrompida antes da conclusão devido a uma solicitação do usuário.

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

testStarted

public abstract void testStarted (TestIdentifier test)

Informa o início de um caso de teste individual.

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