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.

Esta página se ha traducido con Cloud Translation API.

Receptor ITestLifeCycle

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Subclases indirectas conocidas

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

AgregadoPostprocesador	Un agregador de métricas que proporciona el mínimo, máximo, media, varianza, desviación estándar, total, recuento y, opcionalmente, percentiles para métricas numéricas recopiladas durante ejecuciones de pruebas de iteraciones múltiples, tratándolas como dobles.
AtraceCollector	Un `IMetricCollector` que ejecuta un rastreo durante una prueba, recopila el resultado y lo registra en la invocación.
AtraceRunMetricCollector	Recopila los seguimientos de todos los directorios de prueba en el directorio proporcionado desde el dispositivo de prueba, registra el directorio de prueba y procesa posteriormente los archivos de seguimiento en el directorio de prueba y agrega las métricas.
Postprocesador promedio	Implementación de postprocesador que calcula el promedio del listado 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))` .
BasePostprocesador	El `IPostProcessor` base que cada implementación debe extender.
BluetoothConnectionLatencyCollector	El recopilador enviará una configuración métrica de duración de estadísticas predefinida a los dispositivos y recopilará la duración de la conexión Bluetooth para cada perfil.
BluetoothConnectionStateCollector	Este recopilador recopilará métricas de BluetoothConnectionStateChanged y registrará el número de estado de conexión para cada perfil.
Conexión BluetoothTasa de éxitoPostprocesador	Implementación de postprocesador que calcula la tasa de éxito para un perfil de bluetooth. Utilice "metric-key-match" para especificar métricas que contengan estados de conexión bluetooth en una matriz numérica. Ejemplo [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Recopilador para habilitar el registro de vigilancia HCI de Bluetooth en el DUT y recopilar el registro para cada prueba.
Coleccionista de informes de errores	Un `ITestInvocationListener` de paso 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 error.
Informe de errorzOnFailureCollector	Recopile un informe de error cuando falle un caso de prueba.
Informe de errorzOnTestCaseFailureCollector	Recopile un informe de error cuando falle 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.
Recopilación de prueba de escucha	Un `ITestInvocationListener` que recopilará todos los resultados de las pruebas.
Controlador de estado de comando	Controlador que ayuda a monitorear y actualizar el estado de una invocación.
CondiciónFallaMonitor	Supervise cualquier error de la invocación.
ConsolaResultReporter	Reportero de resultados para imprimir los resultados de la prueba en la consola.
CountTestCasesCollector	Cuente e informe el número de casos de prueba para un `IRemoteTest` determinado.
ContandoTestResultListener	Un `TestResultListener` que rastrea el número total de pruebas por `TestStatus`
DebugHostLogOnFailureCollector	Recopilador que recopilará y registrará los registros del lado del host cuando se produzca una falla en el caso de prueba.
DispositivoReleaseReporter	Reportero de liberación del dispositivo que maneja la comunicación con el proceso principal de los dispositivos que se liberarán.
DispositivoTraceCollector	Recopilador que iniciará el seguimiento perfecto cuando se inicie una ejecución de prueba y registrará el archivo de seguimiento al final.
Dispositivo no disponibleMonitor	Este oyente intenta capturar únicamente una DNAE a nivel de caso de prueba.
EventosLoggerListener	Oyente que registra todos los eventos que recibe en un archivo
ArchivoProtoResultReporter	Proto reportero que vuelca `TestRecord` en un archivo.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` que escucha la clave de métricas proveniente del dispositivo y las extrae como un archivo del dispositivo.
FilePullerLogCollector	Registrador del archivo reportado por el lado del dispositivo.
Reenviador de resultados filtrados	Variante de `ResultForwarder` que solo permite informar una lista de permitidos de `TestDescription` .
FormattedGeneratorReporter	Reporter que permite generar informes en un formato particular.
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 gcov de debugfs y del dispositivo y luego finalmente las registrará como artefactos de prueba.
GranularRetriableTestWrapper.StartEndCollector	Ayudante de clase para detectar el inicio y el final de la ejecución faltante.
HostStatsdMetricCollector	Un `IMetricCollector` que recopila métricas de estadísticas del lado del host mediante comandos de la utilidad statsd.
ICommandScheduler.IScheduledInvocationListener	Escucha de eventos de invocación cuando se completa la invocación.
ILogSaverListener	Permite que los `ITestInvocationListener` escuchen cuando se guardan los archivos de registro.
IMetricCollector	Esta interfaz se agregará como decorador al informar los resultados de las pruebas para recopilar métricas coincidentes.
IPostprocesador	Los posprocesadores son un objeto de la Federación de Comercio destinado a permitir el procesamiento de métricas y registros DESPUÉS de las pruebas y ANTES de informar los resultados.
IShardableListener	Un `ITestInvocationListener` que se puede fragmentar.
ISoporteGranularResultados	Interfaz que especifica si `ITestInvocationListener` admite la recepción de resultados granulares o no.
ITestInvocationListener	Oyente de los resultados de la prueba de la invocación de prueba.
ITestSummaryListener	Interfaz que permite `ITestInvocationListener` intercambiar información limitada a través de resúmenes.
Invocación a JUnitResultForwarder	Una clase que escucha eventos `ITestInvocationListener` y los reenvía a `TestListener` .
JarHostTest.HostTestListener	Oyente contenedor que reenvía todos los eventos excepto testRunStarted() y testRunEnded() al oyente integrado.
Coleccionista de cobertura de código Java	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de Java del dispositivo y las registrará como artefactos de prueba.
JsonHttpTestResultReporter	Un reportero de resultados que codifica los resultados de las métricas de prueba y ramifica la información del dispositivo en JSON y POST en un punto final de servicio HTTP.
LUCIResultReportero	Un reportero 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.
último detector de fragmentos	Cuando ejecutamos fragmentación local, a veces solo queremos ejecutar algunas acciones cuando el último fragmento llega a `invocationEnded(long)` .
LegacySubprocessResultsReporter	Una implementación congelada del reportero de resultados del subproceso que debería seguir siendo compatible con versiones anteriores de TF/CTS (por ejemplo, 8+), a pesar de los cambios en su superclase.
LogSaverResultForwarder	Un `ResultForwarder` para guardar registros con el protector de archivos global.
LogcatCrashResultForwarder	Oyente especial: en caso de fallas (el proceso de instrumentación falla), intentará extraer del logcat la falla y lo agregará al mensaje de falla asociado con la prueba.
LogcatOnFailureCollector	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 (por ejemplo, tiempo de cambio de usuario) de logcat durante una o varias pruebas repetidas mediante el uso de patrones de expresiones regulares dados para analizar las señales de inicio y fin de un evento de las líneas de logcat.
MetricFilePostProcessor	Se utiliza para cargar el archivo de registro de métricas recopilado durante el nivel de prueba y ejecución.
MétricasXMLResultReporter	MetricsXMLResultReporter escribe métricas de prueba y ejecuta métricas en un archivo XML en una carpeta especificada por el parámetro metrics-folder en la fase invocationEnded de la prueba.
MóduloEscucha	Oyente adjunto a cada `IRemoteTest` de cada módulo para recopilar la lista de resultados.
MóduloLogcatCollector	Versión del recopilador logcat pero para módulo.
NombreMangleListener	Un escucha proxy para traducir los nombres de métodos, clases y paquetes de prueba a medida que se informan los resultados.
PasandoTestFileReporter	Un `ITestInvocationListener` que guarda la lista de casos de prueba aprobados en un archivo de prueba.
PerfettoGenericPostProcesador	Un posprocesador que procesa un archivo proto perfecto de métrica binaria/texto en pares clave-valor expandiendo recursivamente los mensajes proto y los campos con valores de cadena hasta que se encuentra el campo con valor numérico.
PerfettoPullerMetricCollector	Implementación básica de `FilePullerDeviceMetricCollector` que permite extraer los archivos perfectos del dispositivo y recopilar las métricas del mismo.
PrettyTestEventLogger	Registrador que hace coincidir los eventos y los registra para facilitar la depuración.
ProtoResultReportero	El reportero de resultados crea 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.
ReiniciarReasonCollector	Recopilador que recopila los reinicios del dispositivo durante la ejecución de la prueba y los informa por motivo y recuento.
Prueba remotaTimeOutEnforcer	Oyentes que permiten verificar el tiempo de ejecución de una configuración de prueba determinada y fallar si supera un tiempo de espera determinado.
InformeAprobadoPruebas	Informar en un archivo posibles filtros para excluir la prueba aprobada.
Agregador de resultados	Reenviador especial que agrega los resultados cuando es necesario, según la estrategia de reintento que se tomó.
Resultado y reenviador de registros	Reenviador de resultados y registros de eventos.
Reenviador de resultados	Un `ITestInvocationListener` que reenvía los resultados de la invocación a una lista de otros oyentes.
ReintentarLogSaverResultForwarder	Reenviador que también se encarga de pasar el intento actual en el que nos encontramos.
Reenviar resultados de intento	Una extensión de `ResultForwarder` que siempre envía a un número de intento determinado.
Tiempo de ejecuciónRestartCollector	Recopilador que recopila marcas de tiempo de reinicios del tiempo de ejecución (fallos del servidor del sistema) durante la ejecución de prueba, si corresponde.
Captura de pantallaOnFailureCollector	Recopilador que capturará y registrará una captura de pantalla cuando falle un caso de prueba.
Oyente de fragmentos	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 oyente.
FragmentoMainResultForwarder	Un `ResultForwarder` que combina los resultados de invocaciones de prueba fragmentadas.
Mostrar mapaPullerMetricCollector	Implementación básica de `FilePullerDeviceMetricCollector` que permite extraer los archivos showmap del dispositivo y recopilar las métricas del mismo.
EstadísticasdAntesDespuésGaugeMetricPostProcessor	Un posprocesador que procesa métricas de calibre recopiladas en un enfoque "antes/después", es decir
StatsdEventMetricPostProcessor	Un posprocesador que procesa métricas de eventos en informes statsd en pares clave-valor, utilizando los formateadores especificados en el procesador.
EstadísticasdGenericPostProcessor	Un posprocesador que procesa informes protostatsd binarios en pares clave-valor expandiendo el informe como una estructura de árbol.
StreamProtoResultReporter	Una implementación de `ProtoResultReporter`
SubprocesoResultadosReportero	Implementa `ITestInvocationListener` para especificarlo como result_reporter y reenviar desde el subproceso los resultados de las pruebas, ejecuciones de pruebas e invocaciones de pruebas.
SuiteResultReporter	Recopile resultados de pruebas para una invocación de conjunto completo y genere los resultados finales.
TestFailureListener	El oyente solía realizar acciones como capturas de pantalla, informes de errores y recopilación de logcat ante un error de prueba cuando se solicitaba.
TestResultListener	Una simplificación de ITestLifecycleListener para implementadores que solo se preocupan por los resultados de las pruebas individuales.
TestTimeoutEnforcer	Oyentes que permiten verificar el tiempo de ejecución de un caso de prueba determinado y fallarlo si supera un tiempo de espera determinado.
Reportero de resultados de texto	Un reportero de resultados de pruebas que envía los resultados a la impresora de resultados de texto JUnit.
TrazaCmdCollector	Un `IMetricCollector` que recopila seguimientos durante la prueba mediante trace-cmd y los registra en la invocación.
TradefedSandboxRunner.StubScheduledInvocationListener	Un código auxiliar `IScheduledInvocationListener` que no hace nada.
XmlFormattedGeneratorReporter	La implementación de `FormattedGeneratorReporter` que formatea la suite da como resultado un formato xml.
ReporteroXmlResultado	Escribe los resultados de JUnit en archivos XML en un formato coherente con XMLJUnitResultFormatter de Ant.

Recibe notificaciones de eventos durante las ejecuciones de pruebas de instrumentación.

Modelado según org.junit.runner.notification.RunListener

La secuencia de convocatorias será:

pruebaRunStarted
pruebaIniciada
[prueba fallida]
[pruebaAsunciónFalla]
[pruebaIgnorada]
pruebafinalizada
....
[prueba de ejecución fallida]
pruebaRunEnded

Resumen

Métodos públicos
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` Se llama cuando una prueba atómica indica que asume una condición que es falsa
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Se llama cuando una prueba atómica indica que asume una condición que es falsa
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` donde podemos especificar la hora de finalización directamente.
`default void`	`testEnded ( TestDescription test, testMetrics)` `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 va a ejecutar una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.
`default void`	`testRunEnded (long elapsedTimeMillis, runMetrics)` `testRunEnded (long elapsedTimeMillis, runMetrics)` Informa el final de la ejecución de la prueba.
`default void`	`testRunFailed ( FailureDescription failure)` La ejecución de prueba de informes no se pudo completar debido a un error descrito en `FailureDescription` .
`default void`	`testRunFailed (String errorMessage)` La ejecución de prueba de informes no se pudo completar debido a un error fatal.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Informa del inicio de una ejecución de prueba.
`default void`	`testRunStarted (String runName, int testCount)` Informa del inicio de una ejecución de prueba.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Informa del inicio de una ejecución de prueba.
`default void`	`testRunStopped (long elapsedTime)` La ejecución de la 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 normalmente no se espera.
`default void`	`testStarted ( TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)` donde también especificamos cuándo se inició la prueba, combinado con `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` para una medición precisa .
`default void`	`testStarted ( TestDescription test)` Informa el inicio de un caso de prueba individual.

Métodos públicos

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

Parámetros
`test`	`TestDescription` : identifica la prueba.
`trace`	`String` : seguimiento de pila del error

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

Parámetros
`test`	`TestDescription` : identifica la prueba.
`failure`	`FailureDescription` : `FailureDescription` que describe el error y su contexto.

pruebafinalizada

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente. Combínelo con testStarted(com.android.tradefed.result.TestDescription, long) para obtener una medida precisa.

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

pruebafinalizada

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 pasó. También devuelve cualquier métrica clave/valor que pueda haberse 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

prueba fallida

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 el error y su contexto.

prueba fallida

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 del error

pruebaIgnorado

public void testIgnored (TestDescription test)

Se llama cuando no se va a ejecutar una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.

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

pruebaRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

Parámetros
`elapsedTimeMillis`	`long` : tiempo transcurrido informado por el dispositivo, en milisegundos
`runMetrics`	: pares clave-valor informados al final de una ejecución de prueba con `Metric` .

prueba de ejecución fallida

public void testRunFailed (FailureDescription failure)

La ejecución de prueba de informes no se pudo completar debido a un error descrito en FailureDescription .

Parámetros
`failure`	`FailureDescription` : `FailureDescription` que describe el error y su contexto.

prueba de ejecución fallida

public void testRunFailed (String errorMessage)

La ejecución de prueba de informes no se pudo completar debido a un error fatal.

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

pruebaRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
`runName`	`String` : el nombre de la ejecución de prueba
`testCount`	`int` : número total de pruebas en ejecución de prueba
`attemptNumber`	`int` : número de pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo el mismo nombre de ejecución y el número de intento es de 0 a 3.

pruebaRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa del inicio de una ejecución de prueba.

Parámetros
`runName`	`String` : el nombre de la ejecución de prueba
`testCount`	`int` : número total de pruebas en ejecución de prueba

pruebaRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
`runName`	`String` : el nombre de la ejecución de prueba
`testCount`	`int` : número total de pruebas en ejecución de prueba
`attemptNumber`	`int` : número de pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo el mismo nombre de ejecución y el número de intento es de 0 a 3.
`startTime`	`long` : la hora en que comenzó la ejecución, medida mediante `System.currentTimeMillis()`

pruebaEjecutarDetenido

public void testRunStopped (long elapsedTime)

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

TODO: actualmente sin uso, considere eliminarlo

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

prueba omitida

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

pruebaIniciada

public void testStarted (TestDescription test, 
                long startTime)

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

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

pruebaIniciada

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. La interfaz anterior debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

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