Informe de errorCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Objeto
com.android.tradefed.result.BugreportCollector


Un ITestInvocationListener de paso que recopila informes de errores cuando ocurren eventos configurables y luego llama a ITestInvocationListener#testLog en sus elementos secundarios después de recopilar cada informe de errores.

Comportamientos: (FIXME: termina esto)

  • Capturar después de cada caso si alguno de los casos de prueba falló
  • Captura después de cada caso de prueba
  • Captura después de cada caso de prueba fallido
  • Captura

Resumen

Clases anidadas

class BugreportCollector.Predicate

Un predicado completo que describe cuándo capturar un informe de error.

interface BugreportCollector.SubPredicate

Campos

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Un predicado predefinido que se activa después de cada caso de prueba fallido

public static final BugreportCollector.Predicate AT_START

Un predicado predefinido que se activa cuando comienza la primera invocación

Constructores públicos

BugreportCollector ( ITestInvocationListener listener, ITestDevice testDevice)

Métodos públicos

void addPredicate ( BugreportCollector.Predicate p)
void blockUntilIdle ()

Bloquee hasta que el recopilador no recopile ningún informe de error.

TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

void invocationEnded (long elapsedTime)

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

void invocationFailed (Throwable cause)

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

void invocationStarted ( IInvocationContext context)

Informa el inicio de la invocación de prueba.

void setAsynchronous (boolean asynchronous)

Establece si la colección de informes de errores debe recopilar el informe de errores en un subproceso diferente ( asynchronous = true ), o bloquear a la persona que llama hasta que se capture el informe de errores ( asynchronous = false ).

void setDescriptiveName (String name)

Establezca el nombre descriptivo que se usará al registrar informes de errores.

void setDeviceWaitTime (int waitTime)

Configure el tiempo (en segundos) para esperar a que el dispositivo esté en línea antes de intentar capturar un informe de error.

void testAssumptionFailure ( TestDescription test, String trace)

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

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

void testFailed ( TestDescription test, String trace)

Informa de la falla de un caso de prueba individual.

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.

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

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

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

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

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount)

Informa del inicio de una ejecución de prueba.

void testRunStopped (long elapsedTime)

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

void testStarted ( TestDescription test)

Informa del inicio de un caso de prueba individual.

Campos

DESPUÉS DE_FAILED_CASOS DE PRUEBA

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Un predicado predefinido que se activa después de cada caso de prueba fallido

AL PRINCIPIO

public static final BugreportCollector.Predicate AT_START

Un predicado predefinido que se activa cuando comienza la primera invocación

Constructores públicos

Informe de errorCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parámetros
listener ITestInvocationListener

testDevice ITestDevice

Métodos públicos

agregar predicado

public void addPredicate (BugreportCollector.Predicate p)

Parámetros
p BugreportCollector.Predicate

bloquear hasta que esté inactivo

public void blockUntilIdle ()

Bloquee hasta que el recopilador no recopile ningún informe de errores. Si el recopilador no está recopilando activamente un informe de error, regrese de inmediato

obtenerResumen

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

Devoluciones
TestSummary Un TestSummary que resume la ejecución, o nulo

invocaciónTerminada

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

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco TradeFederation. Los reporteros deben anular este método para admitir informes de múltiples dispositivos.

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

setAsynchronous

public void setAsynchronous (boolean asynchronous)

Establece si la colección de informes de errores debe recopilar el informe de errores en un subproceso diferente ( asynchronous = true ), o bloquear a la persona que llama hasta que se capture el informe de errores ( asynchronous = false ).

Parámetros
asynchronous boolean

establecerNombreDescriptivo

public void setDescriptiveName (String name)

Establezca el nombre descriptivo que se usará al registrar informes de errores. Si es null , BugreportCollector volverá al comportamiento predeterminado de serializar el nombre del evento que provocó la recopilación del informe de error.

Parámetros
name String

establecerDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Configure el tiempo (en segundos) para esperar a que el dispositivo esté en línea antes de intentar capturar un informe de error. Si es negativo, no se realizará ninguna comprobación. Cualquier DeviceNotAvailableException que se encuentre durante esta verificación se registrará e ignorará.

Parámetros
waitTime int

pruebaAsunciónFalla

public 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

pruebaTerminó

public void testEnded (TestDescription test, 
                 testMetrics)

Informa el final de la ejecución de un caso de prueba individual.

Si no se invocó testFailed(TestDescription, FailureDescription) , esta prueba pasó. También devuelve cualquier métrica clave/valor que 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 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 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 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.

testRunEnded

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

Informa del inicio de una ejecución de prueba.

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: actualmente sin usar, considere eliminar

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

pruebaEmpezó

public void testStarted (TestDescription test)

Informa del inicio de un caso de prueba individual. Interfaz anterior, debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test TestDescription : identifica la prueba