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.

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

Un ITestInvocationListener que recopila resultados de un fragmento de invocación (también conocido como una división de invocación para ejecutarse en varios recursos en paralelo) y los reenvía a otro objeto de escucha.

Resumen

Constructores públicos
`ShardListener(ITestInvocationListener main)` Crea un elemento `ShardListener`.

Métodos públicos
	`getUnderlyingResultReporter()`
`void`	`invocationEnded(long elapsedTime)` Informa que la invocación finalizó, ya sea de forma correcta 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 prueba.
`void`	`logAssociation(String dataName, LogFile logFile)` En algunos casos, el registro debe estar fuertemente asociado con un caso de prueba, pero no es posible hacerlo en la devolución de llamada directa de `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`void`	`setSupportGranularResults(boolean enableGranularResults)`
`boolean`	`supportGranularResults()` Muestra True si el generador de informes admite resultados detallados y False en caso contrario.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Proporciona los datos de registro o depuración asociados de la invocación de prueba.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`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 prueba.
`void`	`testRunFailed(FailureDescription failure)` No se pudo completar la ejecución de prueba de informes debido a un error que describe `FailureDescription`.
`void`	`testRunFailed(String failureMessage)` No se pudo completar la ejecución de prueba de informes debido a un error irrecuperable.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Informa el inicio de una ejecución de prueba.

Constructores públicos

ShardListener

public ShardListener (ITestInvocationListener main)

Crea un elemento ShardListener.

Parámetros
`main`	`ITestInvocationListener`: Es el `ITestInvocationListener` al que se deben reenviar los resultados. Para evitar colisiones con otros `ShardListener`, este objeto se sincronizará en `main` cuando se reenvíen los resultados. Además, los resultados solo se enviarán una vez que se complete el fragmento de invocación.

Métodos públicos

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Muestra

invocationEnded

public void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta 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`: 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 prueba.

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

En algunos casos, el registro debe estar fuertemente asociado con un caso de prueba, pero no es posible hacerlo en la devolución de llamada directa de testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Por lo tanto, esta devolución de llamada permite proporcionar una asociación sólida de forma explícita.

Parámetros
`dataName`	`String`: Es el nombre de los datos.
`logFile`	`LogFile`: Es el `LogFile` que se registró antes y debe estar asociado con el caso de prueba.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parámetros
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Muestra True si el generador de informes admite resultados detallados y False en caso contrario.

Muestra
`boolean`

testLog

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

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

Se debe llamar antes que a ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o a ERROR(/ITestInvocationListener#invocationEnded(long)).

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

Parámetros
`dataName`	`String`: Un nombre descriptivo `String` de los datos, p. ej., "device_logcat". Nota: Es posible que dataName no sea ú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. Los emisores deben asegurarse de que la fuente de los datos permanezca presente y accesible hasta que se complete el método testLog.

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parámetros
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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 con testModuleEnded() y es opcional en la secuencia. Solo se usa durante una ejecución que usa módulos: ejecutores basados en suites.

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 prueba.

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos
`runMetrics`	: Son los pares clave-valor que se informan al final de una ejecución de prueba.

testRunFailed

public void testRunFailed (FailureDescription failure)

No se pudo completar la ejecución de prueba de informes debido a un error que describe FailureDescription.

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

testRunFailed

public void testRunFailed (String failureMessage)

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

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Informa el inicio de una ejecución de prueba.

Parámetros
`name`	`String`: Es el nombre de la ejecución de prueba.
`numTests`	`int`: Es la cantidad total de pruebas en la ejecución de prueba.
`attemptNumber`	`int`: Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El attemptNumber tiene un índice de 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el attemptNumber va de 0 a 3.
`startTime`	`long`: Es la hora en que comenzó la ejecución, medida a través de `System.currentTimeMillis()`.