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 y recopila el resultado y lo registra en la invocación.
BugreportzOnFailureCollector	Recopila un bugreportz cuando falla un caso de prueba.
BugreportzOnTestCaseFailureCollector	Recopila un bugreportz 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 el recopilador que reunirá y registrará los registros del host cuando se produzca una falla en un caso de prueba.
DeviceTraceCollector	Es el recopilador que iniciará el registro de perfetto cuando comience una ejecución de prueba y registrará el archivo de registro al final.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` que escucha la clave de métricas proveniente del dispositivo y las 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	Es 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 el recopilador que capturará y registrará un logcat cuando falle un caso de prueba.
LogcatTimingMetricCollector	Es 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 con patrones de regex determinados para analizar los indicadores de inicio y finalización de un evento a partir de las líneas de logcat.
RebootReasonCollector	Es un recopilador que recopila los reinicios del dispositivo durante la ejecución de la prueba y los informa por motivo y recuento.
RuntimeRestartCollector	Es el recopilador que recopila las marcas de tiempo de los reinicios del entorno de ejecución (fallas del servidor del sistema) durante la ejecución de la prueba, si los hay.
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, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

AtraceRunMetricCollector	Recopila los registros de todos los directorios 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á una configuración de métricas de duración de statsd 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.
BluetoothHciSnoopLogCollector	Es el recopilador que habilita el registro de búsqueda de HCI de Bluetooth en el DUT y recopila el registro para cada prueba.
FilePullerLogCollector	Es el registrador del archivo que informa el lado del dispositivo.
ModuleLogcatCollector	Es la versión del recopilador de logcat, pero para el módulo.
PerfettoFilePullerCollector	Es un recopilador que extrae archivos de registro de Perfetto del dispositivo, los comprime de forma opcional y los agrega a los registros de prueba.
PerfettoPullerMetricCollector	Esta clase dejó de estar disponible. En su lugar, usa `PerfettoFilePullerCollector` y `ERROR(/PerfettoTracePostProcessor)`.
ShowmapPullerMetricCollector	Implementación básica de `FilePullerDeviceMetricCollector` que permite extraer los archivos de showmap del dispositivo y recopilar las métricas correspondientes.
TraceCmdCollector	Un `IMetricCollector` que recopila registros 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

Constantes
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Constructores públicos
`BaseDeviceMetricCollector()`

Métodos públicos
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`final`	`getBuildInfos()` Devuelve la lista de información de compilación disponible en la invocación.
`final`	`getDevices()` Devuelve 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 guárdalo en caché en un mapa para las llamadas posteriores.
`final ITestInvocationListener`	`getInvocationListener()` Devuelve el `ITestInvocationListener` original al que reenviamos los resultados.
`String`	`getModuleName()`
`final`	`getRealDevices()` Devuelve todos los dispositivos que no son de prueba de la lista de `getDevices()`.
`String`	`getRunName()` Devuelve el nombre de la ejecución de prueba `mRunName` que activa el recopilador.
`String`	`getTestName()` Devuelve el nombre de la prueba `mTestName` que activa el recopilador.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicialización del recopilador con el contexto actual y el lugar al que se deben reenviar los resultados.
`final void`	`invocationEnded(long elapsedTime)` Informa que la invocación finalizó, ya sea correctamente 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()` Devuelve True si todo el objeto está inhabilitado (omite la configuración y la limpieza).
`boolean`	`isDisabledReceiver()` Indica si el objeto `IDeviceActionReceiver` está inhabilitado o no.
`final void`	`logAssociation(String dataName, LogFile logFile)` No se usa dentro de la implementación del recopilador de métricas.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Es una devolución de llamada que se realiza cuando un caso de prueba falla debido a un error 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)` Es una devolución de llamada que se realiza cuando se inicia una ejecución de prueba.
`void`	`onTestStart(DeviceMetricData testData)` Es la 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 el objeto debe inhabilitarse.
`void`	`setDisableReceiver(boolean isDisabled)` Establece si se debe inhabilitar `IDeviceActionReceiver`.
`final void`	`setLogSaver(ILogSaver logSaver)` No se usa 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 que es falsa
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Se llama cuando una prueba atómica marca que supone una condición que es 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 la falla de un caso de prueba individual.
`final void`	`testFailed(TestDescription test, String trace)` Informa la falla de un caso de prueba individual.
`final void`	`testIgnored(TestDescription test)` Se llama cuando no se ejecutará una prueba, generalmente 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 la prueba.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` No se usa 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 la prueba.
`final void`	`testRunFailed(FailureDescription failure)` No se pudo completar la ejecución de prueba de los informes debido a una falla que se describe en `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` No se pudo completar la ejecución de prueba de los informes debido a un error fatal.
`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 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)` Se detuvo la ejecución de prueba de los informes antes de que se completara 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 se espera habitualmente.
`final void`	`testStarted(TestDescription test, long startTime)` 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 una medición precisa.
`final void`	`testStarted(TestDescription test)` Devoluciones de llamada de casos de prueba

Constantes

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Valor de la constante: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Valor de la constante: "test-case-include-group"

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

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

Muestra

getDevices

public final  getDevices ()

Devuelve 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 guárdalo en caché 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. Devuelve null si no se encuentra el archivo.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Devuelve el ITestInvocationListener original al que reenviamos los resultados.

Muestra
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Muestra
`String`

getRealDevices

public final  getRealDevices ()

Devuelve todos los dispositivos que no son de prueba de la lista de getDevices().

Muestra

getRunName

public String getRunName ()

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

getTestName

public String getTestName ()

Devuelve el nombre de la prueba mTestName que activa el recopilador.

Muestra
`String`	mTestName, el nombre de la prueba actual.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialización del recopilador con el contexto actual y el lugar al que se deben reenviar los resultados. Solo se llamará una vez por instancia, y se espera que el recopilador actualice su contexto interno y su objeto de escucha. Nunca se llamará a Init durante una ejecución de prueba siempre antes.

No anules este método, 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 colocarán los resultados.

Muestra
`ITestInvocationListener`	Es el nuevo objeto de escucha que envuelve al original.

Arroja
`DeviceNotAvailableException`

invocationEnded

public final void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea correctamente 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`: Es 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 ()

Devuelve True si todo el objeto está inhabilitado (omite la configuración y la limpieza). De lo contrario, es falso.

Muestra
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Indica si el objeto IDeviceActionReceiver está inhabilitado o no.

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

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

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

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

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Es una devolución de llamada que se realiza cuando un caso de prueba falla debido a un error de suposición.

Parámetros
`testData`	`DeviceMetricData`: Es 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. Esta debería ser la hora de limpieza.

Parámetros
`testData`	`DeviceMetricData`: Es 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. Esta debería ser la hora de limpieza.

Parámetros
`testData`	`DeviceMetricData`: Es 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`: Es 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. Esta debería ser la hora de limpieza.

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)

Es una devolución de llamada que se realiza 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)

Es la devolución de llamada cuando se inicia un caso de prueba.

Parámetros
`testData`	`DeviceMetricData`: Es 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 reiniciar el dispositivo 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 reiniciar el dispositivo durante esta devolución de llamada. Se ignorará cualquier intento de reinicio.

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

Arroja
`DeviceNotAvailableException`

setDisable

public final void setDisable (boolean isDisabled)

Establece si el objeto debe inhabilitarse. Inhabilitado significa que se deben omitir los pasos de configuración y de cierre. 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 la 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 se usa dentro de la implementación del recopilador de métricas. Esto 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 que es falsa

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`trace`	`String`: Es el 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 que es 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 fecha y hora en 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 devuelve las métricas de clave/valor que se hayan 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 la falla 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 la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

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

testIgnored

public final void testIgnored (TestDescription test)

Se llama cuando no se ejecutará una prueba, generalmente 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 la prueba.

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

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

Parámetros
`dataName`	`String`: Es un nombre descriptivo `String` de los datos, p. ej., "device_logcat". Nota: dataName puede no ser ú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 la lectura. Los llamadores deben asegurarse de que la fuente de 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 se usa dentro de la implementación del recopilador de métricas. Esto es un reenvío puro.

Parámetros
`dataName`	`String`: Es un nombre descriptivo `String` de los datos, p. ej., "device_logcat". Nota: dataName puede no ser ú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 la lectura.
`logFile`	`LogFile`: Es el objeto `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 a testModuleEnded() y es opcional en la secuencia. Solo se usa durante una ejecución que utiliza módulos: ejecutores basados en conjuntos de pruebas.

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

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos
`runMetrics`	: Pares clave-valor que se registran 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 los informes debido a una falla que se describe en 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 los informes debido a un error fatal.

Parámetros
`errorMessage`	`String`: `String` que describe el motivo de la falla de la 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 la prueba.
`testCount`	`int`: Es la cantidad total de pruebas en la ejecución de prueba.
`attemptNumber`	`int`: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se realice una nueva ejecución. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Devoluciones de llamada de ejecución de prueba

Parámetros
`runName`	`String`: Es el nombre de la ejecución de la 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 la prueba.
`testCount`	`int`: Es la cantidad total de pruebas en la ejecución de prueba.
`attemptNumber`	`int`: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se ejecute una prueba nueva. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser 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)

Se detuvo la ejecución de prueba de los informes antes de que se completara debido a una solicitud del usuario.

TODO: Actualmente no se usa. Considera quitarlo.

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 se espera habitualmente. Se intentará volver a ejecutar 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)

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

Parámetros
`test`	`TestDescription`: Identifica la prueba.
`startTime`	`long`: Es la fecha y 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.