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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Subclases directas conocidas

AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector

AtraceCollector	Un `IMetricCollector` que ejecuta atrace durante una prueba, recopila el resultado y lo registra en la invocación.
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.
CountTestCasesCollector	Cuenta y registra la cantidad de casos de prueba para un `IRemoteTest` determinado.
DebugHostLogOnFailureCollector	Es un recopilador que recopilará y registrará los registros del host cuando se produzca un error en un caso de prueba.
DeviceTraceCollector	Es un recopilador que iniciará el registro de Perfetto cuando se inicie una ejecución de prueba y registrará el archivo de registro al final.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` que detecta la clave de métricas que proviene del dispositivo y la extrae como un archivo del dispositivo.
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.
HostStatsdMetricCollector	Un `IMetricCollector` que recopila métricas de statsd del host con comandos de la utilidad de statsd.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` que extraerá las mediciones de cobertura de Java del dispositivo y las registrará como artefactos de 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.
RebootReasonCollector	Es un recopilador que recopila el reinicio del dispositivo durante la ejecución de la prueba y los informa por motivo y recuento.
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.

Subcategorías indirectas conocidas

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

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.
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.
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.
FilePullerLogCollector	Es el registrador del archivo que informa el dispositivo.
ModuleLogcatCollector	Es la versión del recopilador de Logcat, pero para el módulo.
PerfettoPullerMetricCollector	Implementación base de `FilePullerDeviceMetricCollector` que permite extraer los archivos de perfetto del dispositivo y recopilar las métricas.
ShowmapPullerMetricCollector	Implementación básica de `FilePullerDeviceMetricCollector` que permite extraer los archivos de showmap del dispositivo y recopilar las métricas.
TraceCmdCollector	Un `IMetricCollector` que recopila seguimientos durante la prueba con trace-cmd y los registra en la invocación

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

Resumen

Campos
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Constructores públicos
`BaseDeviceMetricCollector()`

Métodos públicos
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`final`	`getBuildInfos()` Muestra la lista de información de compilación disponible en la invocación.
`final`	`getDevices()` Muestra la lista de dispositivos disponibles en la invocación.
`File`	`getFileFromTestArtifacts(String fileName)` Recupera el archivo de los artefactos de prueba o del módulo y cázalo en un mapa para las llamadas posteriores.
`final ITestInvocationListener`	`getInvocationListener()` Muestra el `ITestInvocationListener` original al que reenviamos los resultados.
`String`	`getModuleName()`
`final`	`getRealDevices()` Muestra todos los dispositivos que no son stub de la lista `getDevices()`.
`String`	`getRunName()` Muestra el nombre de la ejecución de prueba `mRunName` que activa el recopilador.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicialización del recopilador con el contexto actual y a dónde reenviar los resultados.
`final void`	`invocationEnded(long elapsedTime)` Informa que la invocación finalizó, ya sea de forma correcta o debido a alguna condición de error.
`final void`	`invocationFailed(FailureDescription failure)` Informa una invocación incompleta debido a alguna condición de error.
`final 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
`final void`	`invocationStarted(IInvocationContext context)` Objetos de escucha de invocación para el reenvío
`final boolean`	`isDisabled()` Muestra verdadero si todo el objeto está inhabilitado (se omite la configuración y el desmontaje).
`boolean`	`isDisabledReceiver()` Indica si `IDeviceActionReceiver` está inhabilitado o no.
`final void`	`logAssociation(String dataName, LogFile logFile)` No lo uses dentro de la implementación del recopilador de métricas.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Devolución de llamada cuando un caso de prueba falla con una falla de suposición.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Devolución de llamada cuando finaliza un caso de prueba.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Devolución de llamada cuando finaliza un caso de prueba.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Devolución de llamada cuando falla un caso de prueba.
`void`	`onTestModuleEnded()` Permite capturar el evento de finalización del módulo.
`void`	`onTestModuleStarted()` Permite capturar el evento de inicio del módulo.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Devolución de llamada cuando finaliza una ejecución de prueba.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Devolución de llamada para eventos testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Devolución de llamada cuando se inicia una ejecución de prueba.
`void`	`onTestStart(DeviceMetricData testData)` Devolución de llamada cuando se inicia un caso de prueba.
`void`	`rebootEnded(ITestDevice device)` Recibe una notificación cuando finaliza el reinicio en el dispositivo.
`void`	`rebootStarted(ITestDevice device)` Recibe una notificación cuando se inicia el reinicio en el dispositivo.
`final void`	`setDisable(boolean isDisabled)` Establece si se debe inhabilitar el objeto.
`void`	`setDisableReceiver(boolean isDisabled)` Establece si se debe inhabilitar `IDeviceActionReceiver`.
`final void`	`setLogSaver(ILogSaver logSaver)` No lo uses dentro de la implementación del recopilador de métricas.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Se llama cuando una prueba atómica marca que supone una condición falsa.
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Se llama cuando una prueba atómica marca que supone una condición falsa.
`final 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.
`final void`	`testEnded(TestDescription test, testMetrics)` Informa el final de la ejecución de un caso de prueba individual.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Informa el error de un caso de prueba individual.
`final void`	`testFailed(TestDescription test, String trace)` Informa el error de un caso de prueba individual.
`final 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.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Proporciona los datos de registro o depuración asociados de la invocación de prueba.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` No lo uses dentro de la implementación del recopilador de métricas.
`final void`	`testModuleEnded()` Informa el final de la ejecución de un módulo.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Informa el inicio de la ejecución de un módulo.
`final void`	`testRunEnded(long elapsedTime, runMetrics)` Informa el final de la ejecución de prueba.
`final void`	`testRunFailed(FailureDescription failure)` No se pudo completar la ejecución de prueba de informes debido a una falla que describe `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` No se pudo completar la ejecución de prueba de informes debido a un error irrecuperable.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Informa el inicio de una ejecución de prueba.
`final void`	`testRunStarted(String runName, int testCount)` Devoluciones de llamada de la ejecución de prueba
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Informa el inicio de una ejecución de prueba.
`final void`	`testRunStopped(long elapsedTime)` La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Se llama cuando se omite una prueba y no se ejecuta por un motivo que no suele esperarse.
`final 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.
`final void`	`testStarted(TestDescription test)` Devoluciones de llamada de casos de prueba

Campos

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Constructores públicos

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Métodos públicos

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildInfos

public final  getBuildInfos ()

Muestra la lista de información de compilación disponible en la invocación.

Muestra

getDevices

public final  getDevices ()

Muestra la lista de dispositivos disponibles en la invocación.

Muestra

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Recupera el archivo de los artefactos de prueba o del módulo y cázalo en un mapa para las llamadas posteriores.

Parámetros
`fileName`	`String`: Es el nombre del archivo que se buscará en los artefactos.

Muestra
`File`	Archivo del artefacto de prueba o del artefacto del módulo. Muestra un valor nulo si no se encuentra el archivo.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Muestra el ITestInvocationListener original al que reenviamos los resultados.

Muestra
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Muestra
`String`

getRealDevices

public final  getRealDevices ()

Muestra todos los dispositivos que no son stub de la lista getDevices().

Muestra

getRunName

public String getRunName ()

Muestra el nombre de la ejecución de prueba mRunName que activa el recopilador.

Muestra
`String`	mRunName, el nombre de la ejecución de prueba actual.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicializa el recopilador con el contexto actual y dónde reenviar los resultados. Solo se llamará una vez por instancia, y se espera que el recopilador actualice su contexto y objeto de escucha internos. Nunca se llamará a Init durante una ejecución de prueba.

No lo hagas a menos que sepas lo que estás haciendo.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` de la invocación en curso.
`listener`	`ITestInvocationListener`: Es el `ITestInvocationListener` en el que se deben colocar los resultados.

Muestra
`ITestInvocationListener`	el nuevo objeto de escucha que une el original.

Arroja
`DeviceNotAvailableException`

invocationEnded

public final 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 final 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 final 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 final void invocationStarted (IInvocationContext context)

Objetos de escucha de invocación para el reenvío

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

isDisabled

public final boolean isDisabled ()

Muestra verdadero si todo el objeto está inhabilitado (se omite la configuración y el desmontaje). De lo contrario, es falso.

Muestra
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Indica si IDeviceActionReceiver está inhabilitado o no.

Muestra
`boolean`	Muestra verdadero si está inhabilitado; de lo contrario, muestra falso.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

No lo uses dentro de la implementación del recopilador de métricas. Esto es un reenvío puro.

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.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Devolución de llamada cuando un caso de prueba falla con una falla de suposición.

Parámetros
`testData`	`DeviceMetricData`: El `DeviceMetricData` que contiene los datos del caso de prueba.
`test`	`TestDescription`: Es el `TestDescription` del caso de prueba en curso.

Arroja
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Devolución de llamada cuando finaliza un caso de prueba. Este debería ser el momento de la limpieza.

Parámetros
`testData`	`DeviceMetricData`: El `DeviceMetricData` que contiene los datos del caso de prueba. Será el mismo objeto que durante `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: Es el mapa actual de métricas que se pasa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: Es el `TestDescription` del caso de prueba en curso.

Arroja
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Devolución de llamada cuando finaliza un caso de prueba. Este debería ser el momento de la limpieza.

Parámetros
`testData`	`DeviceMetricData`: El `DeviceMetricData` que contiene los datos del caso de prueba. Será el mismo objeto que durante `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: Es el mapa actual de métricas que se pasa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Arroja
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Devolución de llamada cuando falla un caso de prueba.

Parámetros
`testData`	`DeviceMetricData`: El `DeviceMetricData` que contiene los datos del caso de prueba.
`test`	`TestDescription`: Es el `TestDescription` del caso de prueba en curso.

Arroja
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Permite capturar el evento de finalización del módulo.

Arroja
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Permite capturar el evento de inicio del módulo.

Arroja
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Devolución de llamada cuando finaliza una ejecución de prueba. Este debería ser el momento de limpiar.

Parámetros
`runData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos de la ejecución. Será el mismo objeto que durante `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: Es el mapa actual de métricas que se pasa a `ERROR(/#testRunEnded(long,Map))`.

Arroja
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Devolución de llamada para eventos testRunFailed

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Devolución de llamada cuando se inicia una ejecución de prueba.

Parámetros
`runData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos de la ejecución.

Arroja
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Devolución de llamada cuando se inicia un caso de prueba.

Parámetros
`testData`	`DeviceMetricData`: El `DeviceMetricData` que contiene los datos del caso de prueba.

Arroja
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Recibe una notificación cuando finaliza el reinicio en el dispositivo.

NOTA: Los receptores deben evitar reiniciarse durante esta devolución de llamada. Se ignorará cualquier intento de reinicio.

Parámetros
`device`	`ITestDevice`: `ITestDevice` donde finalizó el reinicio.

Arroja
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Recibe una notificación cuando se inicia el reinicio en el dispositivo.

NOTA: Los receptores deben evitar reiniciarse durante esta devolución de llamada. Se ignorará cualquier intento de reinicio.

Parámetros
`device`	`ITestDevice`: `ITestDevice` en el que comenzó el reinicio.

Arroja
`DeviceNotAvailableException`

setDisable

public final void setDisable (boolean isDisabled)

Establece si se debe inhabilitar el objeto. Inhabilitado significa que se deben omitir los pasos de configuración y de desinstalación. Se puede usar para inhabilitar un objeto de forma predeterminada en el constructor predeterminado.

Parámetros
`isDisabled`	`boolean`: Es el estado en el que se debe colocar el objeto.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Establece si se debe inhabilitar IDeviceActionReceiver. Si lo inhabilitas, no se registrará en el dispositivo para recibir eventos de acción del dispositivo.

Parámetros
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

No lo uses dentro de la implementación del recopilador de métricas. Este es un reenvío puro.

Parámetros
`logSaver`	`ILogSaver`: el `ILogSaver`

testAssumptionFailure

public final 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 final 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 final 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 final 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 final 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 final 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 final 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.

testLog

public final 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 terminen. 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 final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

No lo uses dentro de la implementación del recopilador de métricas. Este es un reenvío puro.

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.
`logFile`	`LogFile`: Es el `LogFile` que contiene los metadatos del archivo guardado.

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

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

Devoluciones de llamada de la 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 final 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 final 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 final 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 final 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 final void testStarted (TestDescription test)

Devoluciones de llamada de casos de prueba

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