A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

Subclases directas conocidas

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 un error 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	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 desde el host con comandos de 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 o una ejecución de prueba.
LogcatTimingMetricCollector	Es un recopilador de métricas que recopila información de sincronización (p.ej., el 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.
ModulePerfettoCollector	Es el recopilador que iniciará el registro de perfetto cuando se inicie y finalice un módulo de prueba, y cuando se reinicie el dispositivo.
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 hay alguno.
ScreenRecordOnFailureCollector	Es el recopilador que capturará y registrará una grabación de pantalla cuando falle un caso de prueba.
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 posprocesa 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 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.
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 base de `FilePullerDeviceMetricCollector` que permite extraer los archivos de showmap del dispositivo y recopilar las métricas de ellos.
TraceCmdCollector	Un `IMetricCollector` que recopila registros durante la prueba con trace-cmd y los registra en la invocación.

Es la implementación base de IMetricCollector que permite iniciar y detener la recopilación en onTestRunStart(DeviceMetricData) y onTestRunEnd(DeviceMetricData,Map).

Resumen

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

Constructores públicos
`BaseDeviceMetricCollector()`

Métodos públicos
`boolean`	`doesModuleContainFailure()` Devuelve verdadero si el módulo actual contenía algún caso de prueba o fallas en la ejecución de pruebas.
`void`	`enableDefaultMetricCollection()` Permite que los recopiladores habiliten la recopilación de métricas predeterminadas.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` Devuelve la lista de información de compilación disponible en la invocación.
`final List<ITestDevice>`	`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()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`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
`boolean`	`isDefaultMetricCollectionEnabled()` Indica si el recopilador recopila métricas como parte de la recopilación de métricas predeterminada.
`final boolean`	`isDisabled()` Devuelve True si todo el objeto está inhabilitado (omite la configuración y la limpieza).
`boolean`	`isDisabledReceiver()` Indica si el `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)` Devolución de llamada cuando falla un caso de prueba debido a una falla de suposición.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Devolución de llamada cuando finaliza un caso de prueba.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` 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, Map<String, MetricMeasurement.Metric> 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)` 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.
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Establece el nivel en el que el recopilador debe recopilar registros, independientemente de las fallas.
`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.
`void`	`setModuleContainsFailure()` Establece si el módulo tuvo alguna falla (caso de prueba, ejecución de prueba).
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Establece el nivel en el que el recopilador debe recopilar registros durante las fallas.
`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, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternativa a `testEnded(TestDescription,Map)` en la que podemos especificar la hora de finalización directamente.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> 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, HashMap<String, MetricMeasurement.Metric> runMetrics)` Informa el final de una ejecución de prueba.
`final void`	`testRunFailed(FailureDescription failure)` No se pudo completar la ejecución de prueba de informes debido a un error descrito por `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` Informa que no se pudo completar la ejecución de prueba debido a un error grave.
`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 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(TestDescription)` en la que también especificamos cuándo se inició la prueba, combinada con `testEnded(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

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Devuelve verdadero si el módulo actual contenía algún caso de prueba o fallas en la ejecución de pruebas.

Muestra
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Permite que los recopiladores habiliten la recopilación de métricas predeterminadas. Cuando la recopilación de métricas predeterminada está habilitada, el recopilador solo debe recopilar en el nivel de recopilación especificado.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Muestra
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

Muestra
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

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

Muestra
`List<ITestDevice>`

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 un valor nulo 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`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Muestra
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

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

Muestra
`List<ITestDevice>`

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

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

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Indica si el recopilador recopila métricas como parte de la recopilación de métricas predeterminada.

Muestra
`boolean`

isDisabled

public final boolean isDisabled ()

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

Muestra
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Indica si el 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)

Devolución de llamada cuando falla un caso de prueba debido a una falla 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, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

Parámetros
`testData`	`DeviceMetricData`: Es el `DeviceMetricData` que contiene los datos del caso de prueba. Será el mismo objeto que durante `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Es el mapa actual de métricas que se pasa a `testEnded(TestDescription,Map)`.

Arroja
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

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

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

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, 
                Map<String, MetricMeasurement.Metric> 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(DeviceMetricData)`.
`currentRunMetrics`	`Map`: Es el mapa actual de métricas que se pasa a `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)

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` en el que 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` en el que se inició el reinicio.

Arroja
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Establece el nivel en el que el recopilador debe recopilar registros, independientemente de las fallas.

El nivel NULL no generará ninguna recopilación.

Parámetros
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` en el que se recopilarán los registros.

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 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 se inhabilita, 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`

setModuleContainsFailure

public void setModuleContainsFailure ()

Establece si el módulo tuvo alguna falla (caso de prueba, ejecución de prueba).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Establece el nivel en el que el recopilador debe recopilar registros durante las fallas.

El nivel NULL no generará ninguna recopilación.

Parámetros
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` en el que se recopilarán los registros.

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, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternativa a testEnded(TestDescription,Map) en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(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`	`HashMap`: Un `Map` de las métricas emitidas.

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> 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`	`HashMap`: Un `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)/ITestInvocationListener#invocationFailed(java.lang.Throwable) 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 registro de logcat del dispositivo.

Parámetros
`dataName`	`String`: Es un nombre descriptivo de los datos, p. ej., "device_logcat".`String` 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 de los datos, p. ej., "device_logcat".`String` 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

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

Parámetros
`elapsedTime`	`long`: Tiempo transcurrido informado por el dispositivo, en milisegundos.
`runMetrics`	`HashMap`: Pares clave-valor que se registran al final de una ejecución de prueba con `Metric`.

testRunFailed

public final void testRunFailed (FailureDescription failure)

No se pudo completar la ejecución de prueba de informes debido a un error descrito por FailureDescription.

Parámetros
`failure`	`FailureDescription`: `FailureDescription` que describe la falla y su contexto.

testRunFailed

public final void testRunFailed (String errorMessage)

Informa que no se pudo completar la ejecución de prueba debido a un error grave.

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 una 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 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 nueva prueba. 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 una 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 una 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 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 nueva prueba. 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 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(TestDescription) en la que también especificamos cuándo se inició la prueba, combinada con testEnded(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.