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.

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Subcategorías indirectas conocidas

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector y 81 más.

AggregatePostProcessor	Un agregador de métricas que proporciona el mínimo, el máximo, la media, la varianza, la desviación estándar, el total, el recuento y, de manera opcional, los percentiles para las métricas numéricas recopiladas durante ejecuciones de prueba de varias iteraciones, tratándolas como números dobles.
AtraceCollector	Un `IMetricCollector` que ejecuta atrace durante una prueba, recopila el resultado y lo registra en la invocación.
AtraceRunMetricCollector	Recopila los registros de todo el directorio de prueba del directorio determinado del dispositivo de prueba, registra el directorio de prueba y procesa los archivos de registro del directorio de prueba y agrega las métricas.
AveragePostProcessor	Implementación del procesador posterior que calcula el promedio de la lista de métricas.
BaseDeviceMetricCollector	Implementación base de `IMetricCollector` que permite iniciar y detener la recopilación en `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` y `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	El `IPostProcessor` base que debe extender cada implementación.
BluetoothConnectionLatencyCollector	El recopilador enviará a los dispositivos una configuración predefinida de la métrica de duración de StatsD y recopilará la duración de la conexión Bluetooth para cada perfil.
BluetoothConnectionStateCollector	Este recopilador recopilará las métricas de BluetoothConnectionStateChanged y registrará el número de estado de conexión para cada perfil.
BluetoothConnectionSuccessRatePostProcessor	Implementación de un postprocesador que calcula la tasa de éxito de un perfil de Bluetooth Usa "metric-key-match" para especificar las métricas que contienen estados de conexión Bluetooth en un array numérico. Ejemplo: [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Es un recopilador para habilitar el registro de búsqueda de HCI de Bluetooth en el DUT y recopilar el registro de cada prueba.
BugreportCollector	Un `ITestInvocationListener` de transferencia que recopila informes de errores cuando se producen eventos configurables y, luego, llama a `ITestInvocationListener.testLog` en sus elementos secundarios después de que se recopila cada informe de errores.
BugreportzOnFailureCollector	Recopila un informe de errores cuando falla un caso de prueba.
BugreportzOnTestCaseFailureCollector	Recopila un informe de errores cuando falla un caso de prueba en una ejecución.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de Clang del dispositivo y las registrará como artefactos de prueba.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura nativa y de Java del dispositivo y las registrará como artefactos de prueba.
CollectingTestListener	Un `ITestInvocationListener` que recopilará todos los resultados de la prueba.
CommandStatusHandler	Controlador que ayuda a supervisar y actualizar el estado de una invocación.
ConditionFailureMonitor	Supervisa si hay fallas en la invocación.
ConsoleResultReporter	Generador de informes de resultados para imprimir los resultados de la prueba en la consola.
CountTestCasesCollector	Cuenta y registra la cantidad de casos de prueba para un `IRemoteTest` determinado.
CountingTestResultListener	Un `TestResultListener` que realiza un seguimiento de la cantidad total de pruebas por `TestStatus`
DebugHostLogOnFailureCollector	Es un recopilador que recopilará y registrará los registros del host cuando se produzca un error en un caso de prueba.
DeviceReleaseReporter	Generador de informes de lanzamiento de dispositivos que controla la comunicación con el proceso superior de los dispositivos que se lanzarán.
DeviceTraceCollector	Es un recopilador que iniciará el registro de Perfetto cuando comience una ejecución de prueba y registrará el archivo de registro al final.
DeviceUnavailableMonitor	Este objeto de escucha intenta capturar solo un DNAE a nivel del caso de prueba.
EventsLoggerListener	Es un objeto de escucha que registra todos los eventos que recibe en un archivo.
FileProtoResultReporter	Generador de informes de proto que vuelca el `TestRecord` en un archivo.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` que detecta la clave de métricas que proviene del dispositivo y la extrae como un archivo del dispositivo.
FilePullerLogCollector	Es el registrador del archivo que informa el dispositivo.
FilteredResultForwarder	Es una variante de `ResultForwarder` que solo permite que se informe una lista de entidades permitidas de `TestDescription`.
FormattedGeneratorReporter	Generador de informes que permite generar informes en un formato determinado.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de gcov del dispositivo y las registrará como artefactos de prueba.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura del kernel de gcov de debugfs y del dispositivo y, luego, las registrará como artefactos de prueba.
GranularRetriableTestWrapper.StartEndCollector	Ayudante de clase para detectar el inicio y el final de la ejecución faltantes.
HostStatsdMetricCollector	Un `IMetricCollector` que recopila métricas de statsd del host con comandos de la utilidad de statsd.
ICommandScheduler.IScheduledInvocationListener	Objeto de escucha para eventos de invocación cuando se completa la invocación.
ILogSaverListener	Permite que los `ITestInvocationListener` detecten cuándo se guardan los archivos de registro.
IMetricCollector	Esta interfaz se agregará como decorador cuando se informen los resultados de las pruebas para recopilar métricas coincidentes.
IPostProcessor	Los procesadores posteriores son un objeto de Trade Federation que permite el procesamiento de métricas y registros DESPUÉS de las pruebas y ANTES de los informes de resultados.
IShardableListener	Un `ITestInvocationListener` que se puede particionar.
ISupportGranularResults	Interfaz que especifica si un `ITestInvocationListener` admite recibir los resultados detallados o no.
ITestInvocationListener	Objeto de escucha para los resultados de la prueba de la invocación de prueba.
ITestSummaryListener	Es una interfaz que permite que `ITestInvocationListener` intercambie cierta información limitada a través de resúmenes.
InvocationProtoResultReporter	Generadores de informes para almacenar información de almacenamiento en caché a nivel de la invocación y su lista de módulos
InvocationToJUnitResultForwarder	Una clase que escucha eventos `ITestInvocationListener` y los reenvía a un `TestListener`.
JarHostTest.HostTestListener	Objeto de escucha de wrapper que reenvía todos los eventos, excepto testRunStarted() y testRunEnded(), al objeto de escucha incorporado.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de Java del dispositivo y las registrará como artefactos de prueba.
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
LUCIResultReporter	Un generador de informes de resultados que guarda los resultados de las pruebas que necesitan ResultDB y LUCI en formato JSON (go/result-sink) y registra la ubicación del archivo en la consola.
LastShardDetector	Cuando se ejecuta el particionamiento local, a veces solo queremos ejecutar algunas acciones cuando el último fragmento llega a `invocationEnded(long)`.
LegacySubprocessResultsReporter	Una implementación inmovilizada del generador de informes de resultados de subprocesos que debería seguir siendo compatible con versiones anteriores de TF/CTS (p.ej., 8 y versiones posteriores), a pesar de los cambios en su superclase.
LogSaverResultForwarder	Un `ResultForwarder` para guardar registros con el ahorro de archivos global.
LogcatCrashResultForwarder	Objeto de escucha especial: En caso de fallas (falla del proceso de instrumentación), intentará extraer la falla de logcat y la agregará al mensaje de falla asociado con la prueba.
LogcatOnFailureCollector	Es un recopilador que capturará y registrará un logcat cuando falle un caso de prueba.
LogcatTimingMetricCollector	Un recopilador de métricas que recopila información de tiempo (p.ej., tiempo de cambio de usuario) de Logcat durante una o varias pruebas repetidas mediante el uso de patrones de regex determinados para analizar los indicadores de inicio y finalización de un evento a partir de líneas de Logcat.
MetricFilePostProcessor	Se usa para subir el archivo de registro de métricas recopilado durante el nivel de prueba y ejecución.
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.
ModuleLogcatCollector	Es la versión del recopilador de Logcat, pero para el módulo.
ModuleProtoResultReporter	Es un generador de informes de resultados diseñado para informar solo los resultados a nivel del módulo.
ModuleResultsAndMetricsForwarder	Es una extensión de `ResultAndLogForwarder` que agrega métricas adicionales relacionadas con el módulo a los resultados de la prueba.
NameMangleListener	Un objeto de escucha de proxy para traducir los nombres de método, clase y paquete de prueba a medida que se informan los resultados.
PassingTestFileReporter	Un `ITestInvocationListener` que guarda la lista de casos de prueba aprobados en un archivo de prueba
PerfettoGenericPostProcessor	Un postprocesador que procesa el archivo proto de métrica de texto o binario de perfetto en pares clave-valor expandiendo de forma recursiva los mensajes y campos de proto con valores de cadena hasta que se encuentra el campo con valor numérico.
PerfettoPullerMetricCollector	Implementación base de `FilePullerDeviceMetricCollector` que permite extraer los archivos de perfetto del dispositivo y recopilar las métricas.
PrettyTestEventLogger	El registrador coincide con los eventos y los registra para facilitar la depuración.
ProtoResultReporter	El generador de informes de resultados compila un protobuf `TestRecord` con todos los resultados dentro.
PythonBinaryHostTest.PythonForwarder	Reenviador de resultados para reemplazar el nombre de la ejecución por el nombre binario.
RebootReasonCollector	Es un recopilador que recopila el reinicio del dispositivo durante la ejecución de la prueba y los informa por motivo y recuento.
RemoteTestTimeOutEnforcer	Son objetos de escucha que permiten verificar el tiempo de ejecución de una configuración de prueba determinada y fallar si supera un tiempo de espera determinado.
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ó.
ResultAndLogForwarder	Reenvío de resultados y eventos de registro.
ResultDBReporter
ResultForwarder	Un `ITestInvocationListener` que reenvía los resultados de la invocación a una lista de otros objetos de escucha.
RetryLogSaverResultForwarder	Reenviador que también controla el paso del intento actual en el que nos encontramos.
RetryResultForwarder	Una extensión de `ResultForwarder` que siempre envía a un número de intento determinado.
RuntimeRestartCollector	Es un recopilador que recopila marcas de tiempo de los reinicios del entorno de ejecución (fallas del servidor del sistema) durante la ejecución de la prueba, si corresponde.
ScreenshotOnFailureCollector	Es un recopilador que capturará y registrará una captura de pantalla cuando falle un caso de prueba.
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.
ShardMainResultForwarder	Un `ResultForwarder` que combina los resultados de invocaciones de prueba fragmentadas.
ShowmapPullerMetricCollector	Implementación básica de `FilePullerDeviceMetricCollector` que permite extraer los archivos de showmap del dispositivo y recopilar las métricas.
StatsdBeforeAfterGaugeMetricPostProcessor	Un postprocesador que procesa las métricas de medición recopiladas en un enfoque "antes/después", es decir,
StatsdEventMetricPostProcessor	Un procesador posterior que procesa las métricas de eventos en los informes de statsd en pares clave-valor, con los formatos especificados en el procesador.
StatsdGenericPostProcessor	Un postprocesador que procesa informes de proto statsd binarios en pares clave-valor expandiendo el informe como una estructura de árbol.
StreamProtoResultReporter	Una implementación de `ProtoResultReporter`
SubprocessResultsReporter	Implementa `ITestInvocationListener` para que se especifique como un generador de informes de resultados y reenvía desde el subproceso los resultados de las pruebas, las ejecuciones de pruebas y las invocaciones de pruebas.
SuiteResultReporter	Recopila los resultados de la prueba de una invocación de paquete completa y muestra los resultados finales.
TestResultListener	Es una simplificación de ITestLifecycleListener para los implementadores que solo se preocupan por los resultados de pruebas individuales.
TestRunResultListener	Es un objeto de escucha que permite leer el estado final de la ejecución de prueba.
TestTimeoutEnforcer	Son objetos de escucha que permiten verificar el tiempo de ejecución de un caso de prueba determinado y fallarlo si supera un tiempo de espera determinado.
TextResultReporter	Es un generador de informes de resultados de pruebas que reenvía los resultados a la impresora de resultados de texto de JUnit.
TraceCmdCollector	Un `IMetricCollector` que recopila seguimientos durante la prueba con trace-cmd y los registra en la invocación
TradefedSandboxRunner.StubScheduledInvocationListener	Un stub `IScheduledInvocationListener` que no hace nada.
XmlFormattedGeneratorReporter	Implementación de `FormattedGeneratorReporter` que da formato al paquete y genera un formato XML.
XmlResultReporter	Escribe los resultados de JUnit en un archivo 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
`default void`	`testAssumptionFailure(TestDescription test, String trace)` Se llama cuando una prueba atómica marca que supone una condición falsa.
`default void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Se llama cuando una prueba atómica marca que supone una condición falsa.
`default 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.
`default void`	`testEnded(TestDescription test, testMetrics)` Informa el final de la ejecución de un caso de prueba individual.
`default void`	`testFailed(TestDescription test, FailureDescription failure)` Informa el error de un caso de prueba individual.
`default void`	`testFailed(TestDescription test, String trace)` Informa el error de un caso de prueba individual.
`default void`	`testIgnored(TestDescription test)` Se llama cuando no se ejecutará una prueba, por lo general, porque un método de prueba está anotado con org.junit.Ignore.
`default void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Informa el final de la ejecución de prueba.
`default void`	`testRunFailed(FailureDescription failure)` No se pudo completar la ejecución de prueba de informes debido a una falla que describe `FailureDescription`.
`default void`	`testRunFailed(String errorMessage)` No se pudo completar la ejecución de prueba de informes debido a un error irrecuperable.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Informa el inicio de una ejecución de prueba.
`default void`	`testRunStarted(String runName, int testCount)` Informa el inicio de una ejecución de prueba.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Informa el inicio de una ejecución de prueba.
`default void`	`testRunStopped(long elapsedTime)` La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
`default void`	`testSkipped(TestDescription test, SkipReason reason)` Se llama cuando se omite una prueba y no se ejecuta por un motivo que no suele esperarse.
`default void`	`testStarted(TestDescription test, long startTime)` Es una 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 obtener una medición precisa.
`default void`	`testStarted(TestDescription test)` Informa el inicio de un caso de prueba individual.

Métodos públicos

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`trace`	`String`: 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 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 hora en la 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 muestra cualquier métrica de par clave-valor que se haya 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 el error 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 el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

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

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa el final de la ejecución de prueba.

Parámetros
`elapsedTimeMillis`	`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 una falla que describe 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 informes debido a un error irrecuperable.

Parámetros
`errorMessage`	`String`: `String` que describe el motivo de la falla de 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 prueba.
`testCount`	`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.

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 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 prueba.
`testCount`	`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()`.

testRunStopped

public void testRunStopped (long elapsedTime)

La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.

TODO: currently unused, consider removing

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 suele esperarse. Se intentará volver a realizar 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)

Es una 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 obtener una medición precisa.

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`startTime`	`long`: Es la 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 anterior, debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

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