A partir de 2026, para alinearnos con nuestro modelo de desarrollo estable de la rama principal y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en AOSP en el segundo y cuarto trimestre. Para compilar AOSP y contribuir a él, te recomendamos que utilices android-latest-release en lugar de aosp-main. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en AOSP.

ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Subcategorías indirectas conocidas

StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener

StubTestRunListener	Implementación de stub de `ITestRunListener`
TestRunResult	Contiene los resultados de una sola ejecución de prueba.
TestRunToTestInvocationForwarder	Es un reenvío de ddmlib `ITestRunListener` a `ITestLifeCycleReceiver`.
XmlTestRunListener	Escribe los resultados de JUnit en archivos XML en un formato coherente con XMLJUnitResultFormatter de Ant.

Recibe notificaciones de eventos durante las ejecuciones de pruebas de instrumentación.

Se basa en org.junit.runner.notification.RunListener.

La secuencia de llamadas será la siguiente:

testRunStarted
testStarted
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

Resumen

Métodos públicos
`abstract void`	`testAssumptionFailure(TestIdentifier test, String trace)` Se llama cuando una prueba atómica marca que supone una condición que es falsa
`abstract void`	`testEnded(TestIdentifier test, testMetrics)` Informa el final de la ejecución de un caso de prueba individual.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Informa la falla de un caso de prueba individual.
`abstract void`	`testIgnored(TestIdentifier test)` Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.
`abstract void`	`testRunEnded(long elapsedTime, runMetrics)` Informa el final de la ejecución de la prueba.
`abstract void`	`testRunFailed(String errorMessage)` No se pudo completar la ejecución de prueba de los informes debido a un error fatal.
`abstract void`	`testRunStarted(String runName, int testCount)` Informa el inicio de una ejecución de prueba.
`abstract void`	`testRunStopped(long elapsedTime)` Este método dejó de estar disponible. Nunca se invoca esta devolución de llamada. Se borrará.
`abstract void`	`testStarted(TestIdentifier test)` Informa el inicio de un caso de prueba individual.

Métodos públicos

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

Se llama cuando una prueba atómica marca que supone una condición que es falsa

Parámetros
`test`	`TestIdentifier`: Identifica la prueba.
`trace`	`String`: Es el seguimiento de pila de la falla.

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

Si no se invocó testFailed(TestIdentifier, String), esta prueba se aprobó. También devuelve las métricas de clave/valor que se hayan emitido durante la ejecución del caso de prueba.

Parámetros

test

TestIdentifier: Identifica la prueba.

testMetrics

: Es un ERROR(/Map) de las métricas emitidas durante la ejecución del caso de prueba por android.app.Instrumentation#sendStatus. Se conserva el orden de inserción, a menos que emitas la misma clave varias veces. Ten en cuenta que las claves estándar definidas en IInstrumentationResultParser.StatusKeys se filtran de este mapa. Ddmlib puede agregar métricas de prueba adicionales definidas en IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

Informa la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
`test`	`TestIdentifier`: Identifica la prueba.
`trace`	`String`: Es el seguimiento de pila de la falla.

testIgnored

public abstract void testIgnored (TestIdentifier test)

Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.

Parámetros
`test`	`TestIdentifier`: Identifica la prueba.

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de la prueba.

Parámetros

elapsedTime

long: Tiempo transcurrido informado por el dispositivo, en milisegundos

runMetrics

: Es un ERROR(/Map) de las métricas emitidas durante la ejecución del caso de prueba por android.app.Instrumentation#addResults. Se conserva el orden de inserción, a menos que emitas la misma clave varias veces. Ten en cuenta que las claves estándar definidas en IInstrumentationResultParser.StatusKeys se filtran de este mapa. Ddmlib puede agregar métricas de prueba adicionales definidas en IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error fatal.

Parámetros
`errorMessage`	`String`: `String` que describe el motivo de la falla de la ejecución.

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

Informa el inicio de una ejecución de prueba.

Parámetros
`runName`	`String`: Es el nombre de la ejecución de la prueba.
`testCount`	`int`: Es la cantidad total de pruebas en la ejecución de prueba.

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Este método dejó de estar disponible.
Nunca se invoca esta devolución de llamada. Se borrará.

Se detuvo la ejecución de prueba de los informes antes de que se completara debido a una solicitud del usuario.

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos

testStarted

public abstract void testStarted (TestIdentifier test)

Informa el inicio de un caso de prueba individual.

Parámetros
`test`	`TestIdentifier`: Identifica la prueba.