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.

CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

Subclases directas conocidas

JsonHttpTestResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

JsonHttpTestResultReporter	Un generador de informes de resultados que codifica los resultados de las métricas de prueba y la información de la rama y el dispositivo en JSON y los envía a un extremo de servicio HTTP.
MetricsXMLResultReporter	MetricsXMLResultReporter escribe métricas de prueba y ejecuta métricas en un archivo en formato XML en una carpeta especificada por el parámetro metrics-folder en la fase invocationEnded de la prueba.
ModuleListener	Objeto de escucha conectado a cada `IRemoteTest` de cada módulo para recopilar la lista de resultados.
ReportPassedTests	Informa en un archivo los posibles filtros para excluir la prueba aprobada.
ResultAggregator	Reenviador especial que agrega los resultados cuando es necesario, según la estrategia de reintento que se implementó.
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.
SuiteResultReporter	Recopila los resultados de la prueba de una invocación de paquete completa y muestra los resultados finales.
XmlResultReporter	Escribe los resultados de JUnit en un archivo XML en un formato coherente con XMLJUnitResultFormatter de Ant.

Subcategorías indirectas conocidas

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	Generador de informes que permite generar informes en un formato determinado.
XmlFormattedGeneratorReporter	Implementación de `FormattedGeneratorReporter` que da formato al paquete y genera un formato XML.

Un ITestInvocationListener que recopilará todos los resultados de la prueba.

Aunque las estructuras de datos que se usan en este objeto son seguras para subprocesos, se debe llamar a las devoluciones de llamada de ITestInvocationListener en el orden correcto.

Resumen

Constructores públicos
`CollectingTestListener()`

Métodos públicos
`IBuildInfo`	`getBuildInfo()` Este método dejó de estar disponible. depende del `IBuildInfo` de `getInvocationContext()`.
`TestRunResult`	`getCurrentRunResults()` Obtiene los resultados de la ejecución de prueba actual.
`int`	`getExpectedTests()` Muestra la cantidad de pruebas esperadas.
`IInvocationContext`	`getInvocationContext()` Muestra el contexto de invocación que se informó a través de `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getMergedTestRunResults()` Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` Muestra el `IInvocationContext` del módulo asociado con los resultados.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` Muestra una copia del mapa que contiene todos los archivos registrados asociados con el módulo.
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` Muestra una copia del mapa que contiene todo el archivo registrado que no está asociado con una ejecución de prueba o un módulo.
`int`	`getNumAllFailedTestRuns()` Muestra la cantidad total de ejecuciones de prueba en un estado de error.
`int`	`getNumAllFailedTests()` Muestra la cantidad total de pruebas en un estado de error (solo las pruebas fallidas, las fallas de suposición no se tienen en cuenta).
`int`	`getNumTestsInState(TestResult.TestStatus status)` Muestra la cantidad de pruebas en un estado determinado para esta ejecución.
`int`	`getNumTotalTests()` Muestra la cantidad total de pruebas completas de todas las ejecuciones.
`IBuildInfo`	`getPrimaryBuildInfo()` Muestra la información de compilación principal que se informó a través de `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getRunResults()` Este método dejó de estar disponible. Usa `getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` Muestra el `TestRunResult` para un solo intento.
`int`	`getTestRunAttemptCount(String testRunName)` Muestra la cantidad de intentos de una ejecución de prueba determinada.
	`getTestRunAttempts(String testRunName)` Obtiene todos los intentos de un `TestRunResult` de una ejecución de prueba determinada.
	`getTestRunForAttempts(int attempt)` Obtiene todos los resultados de un intento determinado.
	`getTestRunNames()` Muestra todos los nombres de todas las ejecuciones de prueba.
`boolean`	`hasFailedTests()` Muestra si la invocación tuvo pruebas fallidas o de suposición fallida.
`boolean`	`hasTestRunResultsForName(String testRunName)` Muestra si un nombre de ejecución de prueba determinado tiene algún resultado.
`void`	`invocationEnded(long elapsedTime)`
`void`	`invocationFailed(Throwable cause)`
`void`	`invocationStarted(IInvocationContext context)`
`void`	`logAssociation(String dataName, LogFile logFile)`
`void`	`setBuildInfo(IBuildInfo buildInfo)` Este método dejó de estar disponible. Ya no es necesario para las pruebas.
`void`	`setMergeStrategy(MergeStrategy strategy)` Establece el `MergeStrategy` que se usará cuando se combinen los resultados.
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testModuleEnded()`
`void`	`testModuleStarted(IInvocationContext moduleContext)`
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failure)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber)`
`void`	`testRunStarted(String name, int numTests)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped(long elapsedTime)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Métodos protegidos
`final void`	`clearModuleLogFiles()` Permite limpiar el archivo del módulo para evitar que se cargue durante demasiado tiempo.
`final void`	`clearResultsForName(String testRunName)` Permite borrar los resultados de un nombre de ejecución determinado.
`void`	`setIsAggregrateMetrics(boolean aggregate)` Activa o desactiva la opción "métricas agregadas"

Constructores públicos

CollectingTestListener

public CollectingTestListener ()

Métodos públicos

getBuildInfo

public IBuildInfo getBuildInfo ()

Este método dejó de estar disponible.
depende de IBuildInfo de getInvocationContext().

Muestra la información de compilación.

Muestra
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Obtiene los resultados de la ejecución de prueba actual.

Ten en cuenta que los resultados pueden no estar completos. Se recomienda probar el valor de TestRunResult.isRunComplete() o (@link TestRunResult#isRunFailure()} según corresponda antes de procesar los resultados.

Muestra
`TestRunResult`	el `TestRunResult` que representa los datos recopilados durante la última ejecución de prueba

getExpectedTests

public int getExpectedTests ()

Muestra la cantidad de pruebas esperadas. Puede diferir de getNumTotalTests() si algunas pruebas no se ejecutaron.

Muestra
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

Muestra el contexto de invocación que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext).

Muestra
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

Muestra la colección combinada de resultados de todas las ejecuciones en diferentes intentos.

Si hay varios resultados, se combinan cada ejecución de prueba, y el resultado más reciente reemplaza los resultados de las ejecuciones anteriores. Las ejecuciones de prueba se ordenan por número de intento.

Las métricas del mismo intento se combinarán según la preferencia establecida por aggregate-metrics. Las métricas finales serán las del último intento.

Muestra

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Muestra el IInvocationContext del módulo asociado con los resultados.

Parámetros
`testRunName`	`String`: Es el nombre que se le asignó a {`testRunStarted(String, int)`.

Muestra
`IInvocationContext`	El `IInvocationContext` del módulo para un nombre de ejecución de prueba determinado `null` si no hay resultados para ese nombre.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Muestra una copia del mapa que contiene todo el archivo registrado asociado con el módulo.

Muestra
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Muestra una copia del mapa que contiene todo el archivo registrado que no está asociado con una ejecución de prueba o un módulo.

Muestra
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Muestra la cantidad total de ejecuciones de prueba en un estado de error.

Muestra
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

Muestra la cantidad total de pruebas en un estado de error (solo las pruebas fallidas, las fallas de suposición no se tienen en cuenta).

Muestra
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Muestra la cantidad de pruebas en un estado determinado para esta ejecución.

Parámetros
`status`	`TestResult.TestStatus`

Muestra
`int`

getNumTotalTests

public int getNumTotalTests ()

Muestra la cantidad total de pruebas completas de todas las ejecuciones.

Muestra
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Muestra la información de compilación principal que se informó a través de invocationStarted(com.android.tradefed.invoker.IInvocationContext). La compilación principal es la que muestra el primer proveedor de compilación de la configuración en ejecución. Devuelve un valor nulo si no hay contexto (no hay compilación para el caso de prueba).

Muestra
`IBuildInfo`

getRunResults

public  getRunResults ()

Este método dejó de estar disponible.
Usa getMergedTestRunResults()

Muestra los resultados de todas las ejecuciones de prueba.

Muestra

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Muestra el TestRunResult para un solo intento.

Parámetros
`testRunName`	`String`: Es el nombre que se le asignó a {`testRunStarted(String, int)`.
`attempt`	`int`: Es el ID del intento.

Muestra
`TestRunResult`	El `TestRunResult` para el nombre determinado y el ID de intento, o `null` si no existe.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Muestra la cantidad de intentos de una ejecución de prueba determinada.

Parámetros
`testRunName`	`String`: Es el nombre que se le asignó a {`testRunStarted(String, int)`.

Muestra
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Obtiene todos los intentos de un TestRunResult de una ejecución de prueba determinada.

Parámetros
`testRunName`	`String`: Es el nombre que se le asignó a {`testRunStarted(String, int)`.

Muestra
	Todos los `TestRunResult` de una ejecución de prueba determinada, ordenados por intentos.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Obtiene todos los resultados de un intento determinado.

Parámetros
`attempt`	`int`: Es el intento para el que queremos obtener resultados.

Muestra
	Todos los `TestRunResult` de un intento determinado.

getTestRunNames

public  getTestRunNames ()

Muestra todos los nombres de todas las ejecuciones de prueba.

Es posible que estas ejecuciones de prueba se hayan ejecutado varias veces con diferentes intentos.

Muestra

hasFailedTests

public boolean hasFailedTests ()

Muestra si la invocación tuvo pruebas fallidas o de suposición fallida.

Muestra
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Muestra si un nombre de ejecución de prueba determinado tiene algún resultado.

Parámetros
`testRunName`	`String`: Es el nombre que se le asignó a {`testRunStarted(String, int)`.

Muestra
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

Parámetros
`elapsedTime`	`long`

invocationFailed

public void invocationFailed (Throwable cause)

Parámetros
`cause`	`Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Parámetros
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Parámetros
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Este método dejó de estar disponible.
Ya no es necesario para las pruebas.

Establece la información de compilación. Solo se debe usar para pruebas.

Parámetros
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Establece el MergeStrategy que se usará cuando se combinen los resultados.

Parámetros
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Parámetros
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parámetros
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

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

Parámetros
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Parámetros
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Parámetros
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Parámetros
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Parámetros
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Parámetros
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Parámetros
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

Parámetros
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Parámetros
`errorMessage`	`String`

testRunStarted

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

Parámetros
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Parámetros
`name`	`String`
`numTests`	`int`

testRunStarted

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

Parámetros
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

Parámetros
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Parámetros
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Parámetros
`test`	`TestDescription`

Métodos protegidos

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Permite limpiar el archivo del módulo para evitar que se cargue durante demasiado tiempo.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Permite borrar los resultados de un nombre de ejecución determinado. Solo se debe usar en algunos casos, como el agregador de resultados.

Parámetros
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Activa o desactiva la opción "métricas agregadas"

Parámetros
`aggregate`	`boolean`