Colector de informes de errores

public class BugreportCollector
extends Object implements ITestInvocationListener

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

Un ITestInvocationListener de transferencia que recopila informes de errores cuando se pueden configurar eventos y, luego, llama a ITestInvocationListener#testLog en sus elementos secundarios después de cada informe de errores.

Comportamientos: (FIXME: finalizar 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 errores. 

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

Bloquea hasta que el recopilador no recopile ningún informe de errores.

TestSummary getSummary()

Permite que InvocationListener muestre un resumen.

void invocationEnded(long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.

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 recopilación de informes de errores debe recopilarlo en un subproceso diferente. (asynchronous = true), o bloquea al llamador hasta que se capture el informe de errores. (asynchronous = false)

void setDescriptiveName(String name)

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

void setDeviceWaitTime(int waitTime)

Establece el tiempo (en segundos) que se debe esperar hasta que el dispositivo esté en línea antes de intentar capturar una informe de errores.

void testAssumptionFailure(TestDescription test, String trace)

Se llama cuando una prueba atómica marca que asume una condición falsa.

void testEnded(TestDescription test, testMetrics)

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

void testFailed(TestDescription test, String trace)

Informa el error de un caso de prueba individual.

void testIgnored(TestDescription test)

Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.

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

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

void testRunEnded(long elapsedTime, runMetrics)

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

void testRunFailed(String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error grave.

void testRunStarted(String runName, int testCount)

Informa el inicio de una ejecución de prueba.

void testRunStopped(long elapsedTime)

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

void testStarted(TestDescription test)

Informa el inicio de un caso de prueba individual.

Campos

DESPUÉS DE LOS 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

AT_START

public static final BugreportCollector.Predicate AT_START

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

Constructores públicos

Colector de informes de errores

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parámetros
listener ITestInvocationListener

testDevice ITestDevice

Métodos públicos

agregarPredicado

public void addPredicate (BugreportCollector.Predicate p)

Parámetros
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

Bloquea hasta que el recopilador no recopile ningún informe de errores. Si el recopilador no está recopilando un informe de errores, regresa inmediatamente

getSummary

public TestSummary getSummary ()

Permite que InvocationListener muestre un resumen.

Muestra
TestSummary Una TestSummary que resume la ejecución o un valor nulo

invocaciónFinalizada

public void invocationEnded (long elapsedTime)

Informa que la invocación finalizó, ya sea de forma correcta o debido a un error. estado.

Se llamará automáticamente a través del marco TradeFederation.

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

Error de invocación

public void invocationFailed (Throwable cause)

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

Se llamará automáticamente a través del marco TradeFederation.

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

iniciación de invocación

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Se llamará automáticamente a través del marco TradeFederation. Los reporteros deben anular este método para admitir informes de varios dispositivos.

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

setAasync

public void setAsynchronous (boolean asynchronous)

Establece si la recopilación de informes de errores debe recopilarlo en un subproceso diferente. (asynchronous = true), o bloquea al llamador hasta que se capture el informe de errores. (asynchronous = false)

Parámetros
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

Establece el nombre descriptivo que se usará al registrar los informes de errores. Si es null, BugreportCollector recurrirá al comportamiento predeterminado de serializar el nombre de el evento que hizo que se recopilara el informe de errores.

Parámetros
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Establece el tiempo (en segundos) que se debe esperar hasta que el dispositivo esté en línea antes de intentar capturar una informe de errores. Si el valor es negativo, no se realizará ninguna verificación. Cualquier DeviceNotAvailableException que se encuentren durante esta verificación se registrarán y se ignorarán.

Parámetros
waitTime int

ErrordeAsuncióndeprueba

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica marca que asume una condición falsa.

Parámetros
test TestDescription: Identifica la prueba.
trace String: seguimiento de pila de las fallas

pruebaFinalizada

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 se completó correctamente. También muestra cualquier par clave-valor. métricas que podrían haberse emitido durante la ejecución del caso de prueba.

Parámetros
test TestDescription: Identifica la prueba.
testMetrics : Una ERROR(/Map) de las métricas emitidas

Prueba con errores

public void testFailed (TestDescription test, 
                String trace)

Informa el error de un caso de prueba individual.

Se llamará entre testStarted y testEnded.

Parámetros
test TestDescription: Identifica la prueba.
trace String: seguimiento de pila de las fallas

pruebaIgnorada

public void testIgnored (TestDescription test)

Se llama cuando no se ejecuta una prueba, generalmente porque un método de prueba se anota con org.junit.Ignorar.

Parámetros
test TestDescription: Identifica la prueba.

Registro de prueba

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

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

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

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

Parámetros
dataName String: Es un nombre descriptivo String de los datos. p.ej., “device_logcat”. Nota dataName no puede ser único por invocación. es decir, los implementadores deben poder manejar varias llamadas con el mismo dataName
dataType LogDataType: el LogDataType de los datos
dataStream InputStreamSource: el InputStreamSource de los datos Los implementadores deben llamar createInputStream para comenzar a leer los datos y asegurarse de cerrar el InputStream cuando se complete Los emisores deben asegurarse de que la fuente de los datos sea presente y accesible hasta que se complete el método testLog.

pruebaRunfinalizada

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

Parámetros
elapsedTime long: Es el tiempo transcurrido informado por el dispositivo en milisegundos.
runMetrics : Son pares clave-valor que se informan al final de una ejecución de prueba con Metric.

Error de ejecución de prueba

public void testRunFailed (String errorMessage)

No se pudo completar la ejecución de prueba de los informes debido a un error grave.

Parámetros
errorMessage String: String que describe el motivo de la falla de ejecución

pruebaRunStarted

public void testRunStarted (String runName, 
                int testCount)

Informa el inicio de una ejecución de prueba.

Parámetros
runName String: Es el nombre de la ejecución de prueba.
testCount int: Cantidad total de pruebas en la ejecución de prueba

pruebaRundetenida

public void testRunStopped (long elapsedTime)

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

PENDIENTE: Actualmente sin uso, te recomendamos que lo quites

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

Iniciodeprueba

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. Esta interfaz es antigua y debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test TestDescription: Identifica la prueba.