A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Subclases directas conocidas

FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer

FilteredResultForwarder	Es una variante de `ResultForwarder` que solo permite informar una lista de entidades permitidas de `TestDescription`.
JarHostTest.HostTestListener	Es un objeto de escucha de wrapper que reenvía todos los eventos, excepto testRunStarted() y testRunEnded(), al objeto de escucha integrado.
LogSaverResultForwarder	Un `ResultForwarder` para guardar registros con el guardador de archivos global.
LogcatCrashResultForwarder	Es un objeto de escucha especial: En caso de fallas (si se bloquea el proceso de instrumentación), intentará extraer la falla de Logcat y la agregará al mensaje de falla asociado con la prueba.
PythonBinaryHostTest.PythonForwarder	Es un reenvío de resultados para reemplazar el nombre de la ejecución por el nombre del binario.
ResultAndLogForwarder	Es un retransmisor de eventos de registros y resultados.
RetryResultForwarder	Es una extensión de `ResultForwarder` que siempre envía a un número de intento determinado.
ShardMainResultForwarder	Es un `ResultForwarder` que combina los resultados de las invocaciones de pruebas fragmentadas.
TestTimeoutEnforcer	Son objetos de escucha que permiten verificar el tiempo de ejecución de un caso de prueba determinado y hacer que falle si supera un tiempo de espera determinado.

Subcategorías indirectas conocidas

GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Es un asistente de clase que detecta la falta de inicio y finalización de la ejecución.
ModuleResultsAndMetricsForwarder	Es una extensión de `ResultAndLogForwarder` que agrega métricas adicionales relacionadas con el módulo a los resultados de la prueba.
RemoteTestTimeOutEnforcer	Son objetos de escucha que permiten verificar el tiempo de ejecución de una configuración de prueba determinada y hacer que falle si supera un tiempo de espera determinado.
RetryLogSaverResultForwarder	Es un reenvío que también controla el paso del intento actual en el que estamos.

Un ITestInvocationListener que reenvía los resultados de la invocación a una lista de otros objetos de escucha.

Resumen

Constructores públicos
`ResultForwarder(ITestInvocationListener... listeners)` Es el constructor de argumentos de variables alternativo para `ResultForwarder`.
`ResultForwarder( listeners)` Crea un `ResultForwarder`.

Constructores protegidos
`ResultForwarder()` Crea un `ResultForwarder` con la configuración de escucha diferida.

Métodos públicos
	`getListeners()` Obtén la lista de objetos de escucha.
`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(FailureDescription failure)` Informa una invocación incompleta debido a alguna condición de error.
`void`	`invocationFailed(Throwable cause)` Informa una invocación incompleta debido a alguna condición de error.
`void`	`invocationSkipped(SkipReason reason)` Informa que se omitió una invocación
`void`	`invocationStarted(IInvocationContext context)` Informa el inicio de la invocación de la prueba.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Se llama cuando una prueba atómica marca que supone una condición que es falsa
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Se llama cuando una prueba atómica marca que supone una condición que es falsa
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Es una alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` en la que podemos especificar la hora de finalización directamente.
`void`	`testEnded(TestDescription test, testMetrics)` Informa el final de la ejecución de un caso de prueba individual.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Informa la falla de un caso de prueba individual.
`void`	`testFailed(TestDescription test, 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 dataType, InputStreamSource dataStream)` Proporciona los datos de registro o depuración asociados de la invocación de la prueba.
`void`	`testModuleEnded()` Informa el final de la ejecución de un módulo.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Informa el inicio de la ejecución de un módulo.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Informa el final de la ejecución de la prueba.
`void`	`testRunFailed(FailureDescription failure)` No se pudo completar la ejecución de prueba de los informes debido a una falla que se describe en `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` No se pudo completar la ejecución de prueba de los informes debido a un error fatal.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Informa el inicio de una ejecución de prueba.
`void`	`testRunStarted(String runName, int testCount)` Informa el inicio de una ejecución de prueba.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Informa el inicio de una ejecución de prueba.
`void`	`testRunStopped(long elapsedTime)` Se detuvo la ejecución de prueba de los informes antes de que se completara debido a una solicitud del usuario.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Se llama cuando se omite una prueba y no se ejecuta por un motivo que no se espera habitualmente.
`void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)` en la que también especificamos cuándo se inició la prueba, combinada con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para una medición precisa.
`void`	`testStarted(TestDescription test)` Informa el inicio de un caso de prueba individual.

Métodos protegidos
`void`	`setListeners(ITestInvocationListener... listeners)` Establece los objetos de escucha después de la construcción.
`void`	`setListeners( listeners)` Establece los objetos de escucha después de la construcción.

Constructores públicos

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Es el constructor de argumentos de variables alternativo para ResultForwarder.

Parámetros
`listeners`	`ITestInvocationListener`: Los `ITestInvocationListener` reales a los que se reenviarán los resultados

ResultForwarder

public ResultForwarder ( listeners)

Crea un ResultForwarder.

Parámetros
`listeners`	: Los `ITestInvocationListener` reales a los que se reenviarán los resultados

Constructores protegidos

ResultForwarder

protected ResultForwarder ()

Crea un ResultForwarder con la configuración de escucha diferida. Solo se destina al uso de subclases.

Métodos públicos

getListeners

public  getListeners ()

Obtén la lista de objetos de escucha.

Muestra
	Es la lista de `ITestInvocationListener`s.

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 (FailureDescription failure)

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

El framework de TradeFederation lo llamará automáticamente.

Parámetros
`failure`	`FailureDescription`: Es el `FailureDescription` que describe la causa de la falla.

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.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Informa que se omitió una invocación

Parámetros
`reason`	`SkipReason`

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 la generación de informes de varios dispositivos.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`failure`	`FailureDescription`: `FailureDescription` que describe la falla y su contexto.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Es una alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener una medición precisa.

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`endTime`	`long`: Es la fecha y hora en que finalizó la prueba, medida a través de `System.currentTimeMillis()`.
`testMetrics`	: Un `ERROR(/Map)` de las métricas emitidas

testEnded

public void testEnded (TestDescription test, 
                 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`	: Un `ERROR(/Map)` de las métricas emitidas

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Informa la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`failure`	`FailureDescription`: `FailureDescription` que describe la falla y su contexto.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Informa la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
`test`	`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 dataType, 
                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)) 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 logcat del dispositivo.

Parámetros
`dataName`	`String`: Es un nombre descriptivo `String` de los datos, p. ej., "device_logcat". Nota: dataName puede no ser único por invocación, es decir, los implementadores deben poder controlar varias llamadas con el mismo dataName.
`dataType`	`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.

testModuleEnded

public void testModuleEnded ()

Informa el final de la ejecución de un módulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Informa el inicio de la ejecución de un módulo. Esta devolución de llamada está asociada a testModuleEnded() y es opcional en la secuencia. Solo se usa durante una ejecución que utiliza módulos: ejecutores basados en conjuntos de pruebas.

Parámetros
`moduleContext`	`IInvocationContext`: Es el `IInvocationContext` del módulo.

testRunEnded

public 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`	: Pares clave-valor que se registran al final de una ejecución de prueba

testRunFailed

public void testRunFailed (FailureDescription failure)

No se pudo completar la ejecución de prueba de los informes debido a una falla que se describe en FailureDescription.

Parámetros
`failure`	`FailureDescription`: `FailureDescription` que describe la falla y su contexto.

testRunFailed

public 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 void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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.
`attemptNumber`	`int`: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se realice una nueva ejecución. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3.

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 la ejecución de la prueba.
`testCount`	`int`: Es la cantidad total de pruebas en la ejecución de prueba.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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.
`attemptNumber`	`int`: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se ejecute una prueba nueva. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3.
`startTime`	`long`: Es la hora en que comenzó la ejecución, medida a través de `System.currentTimeMillis()`.

testRunStopped

public void testRunStopped (long elapsedTime)

Se detuvo la ejecución de prueba de los informes 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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Se llama cuando se omite una prueba y no se ejecuta por un motivo que no se espera habitualmente. Se intentará volver a ejecutar estas pruebas para obtener una ejecución adecuada.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) en la que también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa.

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`startTime`	`long`: Es la fecha y hora en que comenzó la prueba, medida a través de `System.currentTimeMillis()`.

testStarted

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. Interfaz más antigua. Se debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

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

Métodos protegidos

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Establece los objetos de escucha después de la construcción. Solo se puede usar en subclases.

Parámetros
`listeners`	`ITestInvocationListener`: Los `ITestInvocationListener`s reales a los que se reenviarán los resultados

setListeners

protected void setListeners ( listeners)

Establece los objetos de escucha después de la construcción. Solo se puede usar en subclases.

Parámetros
`listeners`	: Los `ITestInvocationListener`s reales a los que se reenviarán los resultados