BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector , IDeviceActionReceiver

java.lang.Objeto
com.android.tradefed.device.metric.BaseDeviceMetricCollector


Implementación base de IMetricCollector que permite iniciar y detener la recopilación en onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) y ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) .

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

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)

Recupere el archivo de los artefactos de prueba o los artefactos del módulo y guárdelo en caché en un mapa para las llamadas posteriores.

final ITestInvocationListener getInvocationListener ()

Devuelve el ITestInvocationListener original donde estamos reenviando los resultados.

String getModuleName ()
final getRealDevices ()

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

String getRunName ()

Devuelve 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 dónde enviar los resultados.

final void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito 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.

final void invocationStarted ( IInvocationContext context)

Oyentes de invocación para reenvío

final boolean isDisabled ()

Devuelve True si todo el objeto está deshabilitado (omita tanto la instalación como el desmontaje).

boolean isDisabledReceiver ()

Si IDeviceActionReceiver está deshabilitado o no.

final void logAssociation (String dataName, LogFile logFile)

No lo use 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 un error de suposición.

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

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

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) 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) 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 el objeto debe estar deshabilitado.

void setDisableReceiver (boolean isDisabled)

Establece si se debe deshabilitar IDeviceActionReceiver .

final void setLogSaver ( ILogSaver logSaver)

No lo use dentro de la implementación del recopilador de métricas.

final void testAssumptionFailure ( TestDescription test, String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) donde podemos especificar la hora de finalización directamente.

final void testEnded ( TestDescription test, testMetrics) 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 de la falla de un caso de prueba individual.

final void testFailed ( TestDescription test, String trace)

Informa de 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 el registro asociado o los datos de depuración de la invocación de prueba.

final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

No lo use dentro de la implementación del recopilador de métricas.

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

Informa el comienzo de un módulo en ejecución.

final void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Informa el final de la ejecución de la prueba.

final void testRunFailed ( FailureDescription failure)

La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

final void testRunFailed (String errorMessage)

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

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

Informa del inicio de una ejecución de prueba.

final void testRunStarted (String runName, int testCount)

Prueba de ejecución de devoluciones de llamada

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

Informa del inicio de una ejecución de prueba.

final void testRunStopped (long elapsedTime)

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

final void testStarted ( TestDescription test, long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde 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 llamadas 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)

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

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

Devoluciones

obtener dispositivos

public final  getDevices ()

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

Devoluciones

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Recupere el archivo de los artefactos de prueba o los artefactos del módulo y guárdelo en caché en un mapa para las llamadas posteriores.

Parámetros
fileName String : nombre del archivo a buscar en los artefactos.

Devoluciones
File Archivo del artefacto de prueba o artefacto del módulo. Devuelve nulo si no se encuentra el archivo.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Devuelve el ITestInvocationListener original donde estamos reenviando los resultados.

Devoluciones
ITestInvocationListener

getModuleName

public String getModuleName ()

Devoluciones
String

obtenerDispositivosReales

public final  getRealDevices ()

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

Devoluciones

getRunName

public String getRunName ()

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

Devoluciones
String mRunName, el nombre de ejecución de prueba actual.

en eso

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicialización del recopilador con el contexto actual y dónde enviar los resultados. Solo se llamará una vez por instancia y se espera que el recopilador actualice su contexto interno y su oyente. Nunca se llamará a Init durante una ejecución de prueba siempre antes.

No anule a menos que sepa lo que está haciendo.

Parámetros
context IInvocationContext : el IInvocationContext para la invocación en curso.

listener ITestInvocationListener : el ITestInvocationListener donde colocar los resultados.

Devoluciones
ITestInvocationListener el nuevo oyente envolviendo al original.

Lanza
DeviceNotAvailableException

invocaciónTerminada

public final void invocationEnded (long elapsedTime)

Informa que la invocación ha terminado, ya sea con éxito o debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
elapsedTime long : el tiempo transcurrido de la invocación en ms

invocaciónError

public final void invocationFailed (FailureDescription failure)

Informa una invocación incompleta debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
failure FailureDescription : la FailureDescription que describe la causa de la falla

invocaciónError

public final void invocationFailed (Throwable cause)

Informa una invocación incompleta debido a alguna condición de error.

Será llamado automáticamente por el marco TradeFederation.

Parámetros
cause Throwable : la causa Throwable de la falla

invocaciónEmpezó

public final void invocationStarted (IInvocationContext context)

Oyentes de invocación para reenvío

Parámetros
context IInvocationContext : información sobre la invocación

está desactivado

public final boolean isDisabled ()

Devuelve True si todo el objeto está deshabilitado (omita tanto la instalación como el desmontaje). Falso en caso contrario.

Devoluciones
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

Si IDeviceActionReceiver está deshabilitado o no.

Devoluciones
boolean devuelve verdadero si está deshabilitado, falso en caso contrario.

asociación de registro

public final void logAssociation (String dataName, 
                LogFile logFile)

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

Parámetros
dataName String : el nombre de los datos

logFile LogFile : el LogFile que se registró antes y debe asociarse con el caso de prueba.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

Parámetros
testData DeviceMetricData : DeviceMetricData que contiene los datos para el caso de prueba.

test TestDescription : la TestDescription del caso de prueba en curso.

Lanza
DeviceNotAvailableException

enTestEnd

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 : DeviceMetricData que contiene los datos para el caso de prueba. Será el mismo objeto que durante onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : el mapa actual de métricas pasado a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

test TestDescription : la TestDescription del caso de prueba en curso.

Lanza
DeviceNotAvailableException

enTestEnd

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 : DeviceMetricData que contiene los datos para el caso de prueba. Será el mismo objeto que durante onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : el mapa actual de métricas pasado a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

Lanza
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

Parámetros
testData DeviceMetricData : DeviceMetricData que contiene los datos para el caso de prueba.

test TestDescription : la TestDescription del caso de prueba en curso.

Lanza
DeviceNotAvailableException

enTestModuleEnded

public void onTestModuleEnded ()

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

Lanza
DeviceNotAvailableException

enTestModuleStarted

public void onTestModuleStarted ()

Permite capturar el evento de inicio del módulo.

Lanza
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 la limpieza.

Parámetros
runData DeviceMetricData : DeviceMetricData que contiene los datos para la ejecución. Será el mismo objeto que durante onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentRunMetrics : el mapa actual de métricas pasadas a ERROR(/#testRunEnded(long,Map)) .

Lanza
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Devolución de llamada para eventos testRunFailed

Lanza
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enTestRunStart

public void onTestRunStart (DeviceMetricData runData)

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

Parámetros
runData DeviceMetricData : DeviceMetricData que contiene los datos para la ejecución.

Lanza
DeviceNotAvailableException

enTestStart

public void onTestStart (DeviceMetricData testData)

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

Parámetros
testData DeviceMetricData : DeviceMetricData que contiene los datos para el caso de prueba.

Lanza
DeviceNotAvailableException

reiniciarTerminado

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. Cualquier intento de reinicio será ignorado.

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

Lanza
DeviceNotAvailableException

reiniciarIniciado

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. Cualquier intento de reinicio será ignorado.

Parámetros
device ITestDevice : ITestDevice donde comenzó el reinicio.

Lanza
DeviceNotAvailableException

establecer Deshabilitar

public final void setDisable (boolean isDisabled)

Establece si el objeto debe estar deshabilitado. Deshabilitado significa que se deben omitir los pasos de configuración y desmontaje. Se puede usar para deshabilitar un objeto de forma predeterminada en el constructor predeterminado.

Parámetros
isDisabled boolean : el estado en el que se debe poner el objeto.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Establece si se debe deshabilitar IDeviceActionReceiver . La desactivación significa que no se registrará en el dispositivo para recibir eventos de acción del dispositivo.

Parámetros
isDisabled boolean

establecerLogSaver

public final void setLogSaver (ILogSaver logSaver)

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

Parámetros
logSaver ILogSaver : el ILogSaver

pruebaAsunciónFalla

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test TestDescription : identifica la prueba

trace String : rastro de pila de falla

pruebaAsunciónFalla

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Llamado cuando una prueba atómica marca que asume una condición que es falsa

Parámetros
test TestDescription : identifica la prueba

failure FailureDescription : FailureDescription que describe el error y su contexto.

pruebaTerminó

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

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

Parámetros
test TestDescription : identifica la prueba

endTime long : el tiempo que finalizó la prueba, medido a través de System.currentTimeMillis()

testMetrics : un ERROR(/Map) de las métricas emitidas

pruebaTerminó

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 pasó. También devuelve cualquier métrica 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

prueba fallida

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

prueba fallida

public final void testFailed (TestDescription test, 
                String trace)

Informa de la falla de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test TestDescription : identifica la prueba

trace String : rastro de pila de falla

prueba ignorada

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

registro de prueba

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Proporciona el registro asociado o los datos de depuración de la invocación de prueba.

Debe llamarse antes de ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o ERROR(/ITestInvocationListener#invocationEnded(long))

El marco 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 : un nombre descriptivo String de los datos. por ejemplo, "device_logcat". Tenga en cuenta que dataName puede no ser único por invocación. es decir, los implementadores deben poder manejar múltiples llamadas con el mismo nombre de datos

dataType LogDataType : el LogDataType de los datos

dataStream InputStreamSource : 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. Las personas que llaman 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 use dentro de la implementación del recopilador de métricas. Esto es puro reenvío.

Parámetros
dataName String : un nombre descriptivo String de los datos. por ejemplo, "device_logcat". Tenga en cuenta que dataName puede no ser único por invocación. es decir, los implementadores deben poder manejar múltiples llamadas con el mismo nombre de datos

dataType LogDataType : el LogDataType de los datos

dataStream InputStreamSource : 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 : el LogFile que contiene los metadatos del archivo guardado.

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Informa el comienzo de un módulo en ejecución. Esta devolución de llamada está asociada con testModuleEnded() y es opcional en la secuencia. Solo se usa durante una carrera que usa módulos: corredores basados ​​en suite.

Parámetros
moduleContext IInvocationContext : el IInvocationContext del módulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : pares clave-valor notificados al final de una ejecución de prueba con Metric .

pruebaRunFailed

public final void testRunFailed (FailureDescription failure)

La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription .

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

pruebaRunFailed

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
runName String : el nombre de la ejecución de prueba

testCount int : número total de pruebas en ejecución de prueba

attemptNumber int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Prueba de ejecución de devoluciones de llamada

Parámetros
runName String : el nombre de la ejecución de prueba

testCount int : número total de pruebas en ejecución de prueba

testRunStarted

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

Informa del inicio de una ejecución de prueba.

Parámetros
runName String : el nombre de la ejecución de prueba

testCount int : número total de pruebas en ejecución de prueba

attemptNumber int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3.

startTime long : la hora en que comenzó la ejecución, medida a través de System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: actualmente sin usar, considere eliminar

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

pruebaEmpezó

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde 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 : la hora en que comenzó la prueba, medida a través de System.currentTimeMillis()

pruebaEmpezó

public final void testStarted (TestDescription test)

Devoluciones de llamadas de casos de prueba

Parámetros
test TestDescription : identifica la prueba