A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. 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 el AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

InvocationToJUnitResultForwarder

public class InvocationToJUnitResultForwarder
extends Object implements ITestInvocationListener

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

Subclases directas conocidas

TextResultReporter

TextResultReporter Es un reportero de resultados de pruebas que reenvía los resultados a la impresora de resultados de texto de JUnit.

Clase que escucha los eventos ITestInvocationListener y los reenvía a un TestListener.

Resumen

Constructores públicos
`InvocationToJUnitResultForwarder(TestListener junitListener)`

Métodos públicos
`TestSummary`	`getSummary()` Permite que InvocationListener devuelva un resumen.
`void`	`invocationEnded(long elapsedTime)` Informa que la invocación finalizó, ya sea correctamente o debido a alguna condición de error.
`void`	`invocationFailed(Throwable cause)` Informa una invocación incompleta debido a alguna condición de error.
`void`	`invocationStarted(IInvocationContext context)` Informa el inicio de la invocación de la prueba.
`void`	`testAssumptionFailure(TestDescription testId, String trace)` Se llama cuando una prueba atómica marca que supone una condición que es falsa
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Informa el final de la ejecución de un caso de prueba individual.
`void`	`testFailed(TestDescription testId, String trace)` Informa la falla de un caso de prueba individual.
`void`	`testIgnored(TestDescription test)` Se llama cuando no se ejecutará una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType logData, InputStreamSource dataStream)` Proporciona los datos de registro o depuración asociados de la invocación de la prueba.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Informa el final de una ejecución de prueba.
`void`	`testRunFailed(String errorMessage)` Informa que no se pudo completar la ejecución de prueba debido a un error grave.
`void`	`testRunStarted(String runName, int testCount)` Informa el inicio de una ejecución de prueba.
`void`	`testRunStopped(long elapsedTime)` Se detuvo la ejecución de prueba antes de que se completara debido a una solicitud del usuario.
`void`	`testStarted(TestDescription test)` Informa el inicio de un caso de prueba individual.

Métodos protegidos
`TestListener`	`getJUnitListener()`

Constructores públicos

InvocationToJUnitResultForwarder

public InvocationToJUnitResultForwarder (TestListener junitListener)

Parámetros
`junitListener`	`TestListener`

Métodos públicos

getSummary

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Muestra
`TestSummary`	Un objeto `TestSummary` que resume la ejecución o un valor nulo

invocationEnded

public void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea correctamente o debido a alguna condición de error.

El framework de TradeFederation lo llamará automáticamente.

Parámetros
`elapsedTime`	`long`: Es el tiempo transcurrido de la invocación en ms.

invocationFailed

public void invocationFailed (Throwable cause)

Informa una invocación incompleta debido a alguna condición de error.

El framework de TradeFederation lo llamará automáticamente.

Parámetros
`cause`	`Throwable`: Es la causa `Throwable` de la falla.

invocationStarted

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de la prueba.

El framework de TradeFederation lo llamará automáticamente. Los reporteros deben anular este método para admitir informes de varios dispositivos.

Parámetros
`context`	`IInvocationContext`: Información sobre la invocación

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testEnded

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

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

Si no se invocó testFailed(TestDescription, FailureDescription), 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`	`TestDescription`: Identifica la prueba.
`testMetrics`	`HashMap`: Un `Map` de las métricas emitidas.

testFailed

public void testFailed (TestDescription testId, 
                String trace)

Informa la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

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

testIgnored

public void testIgnored (TestDescription 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`	`TestDescription`: Identifica la prueba.

testLog

public void testLog (String dataName, 
                LogDataType logData, 
                InputStreamSource dataStream)

Proporciona los datos de registro o depuración asociados de la invocación de la prueba.

Se debe llamar antes de ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long)).

El framework de TradeFederation llamará automáticamente a este método, proporcionando el registro del host y, si corresponde, el registro de logcat del dispositivo.

Parámetros
`dataName`	`String`: Es un nombre descriptivo de los datos, p. ej., "device_logcat".`String` Nota: dataName puede no ser único por invocación, es decir, los implementadores deben poder controlar varias llamadas con el mismo dataName.
`logData`	`LogDataType`: El `LogDataType` de los datos
`dataStream`	`InputStreamSource`: Es el `InputStreamSource` de los datos. Los implementadores deben llamar a createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream resultante cuando se complete la lectura. Los llamadores deben asegurarse de que la fuente de datos permanezca presente y accesible hasta que se complete el método testLog.

testRunEnded

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

Informa el final de una ejecución de prueba. FIXME: No podemos tener dos interfaces Map<> con diferentes tipos, por lo que tenemos que usar HashMap aquí.

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos.
`runMetrics`	`HashMap`: Pares clave-valor que se registran al final de una ejecución de prueba con `Metric`.

testRunFailed

public void testRunFailed (String errorMessage)

Informa que no se pudo completar la ejecución de prueba debido a un error grave.

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa el inicio de una ejecución de prueba.

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: Actualmente no se usa, considera quitarlo

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

testStarted

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. Es una interfaz más antigua. Se debe usar testStarted(TestDescription) siempre que sea posible.

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

Métodos protegidos

getJUnitListener

protected TestListener getJUnitListener ()

Muestra
`TestListener`