Coleccionista de informes de errores

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 se producen eventos configurables y luego llama a ITestInvocationListener#testLog en sus elementos secundarios después de que se recopila cada informe de error.

Comportamientos: (FIXME: terminar esto)

• Capture después de cada uno 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 finalizado, ya sea exitosamente 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) Establezca si la recopilació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 utilizará al registrar informes de errores.
void	setDeviceWaitTime (int waitTime) Establezca 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) Se llama cuando una prueba atómica indica 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 el error de un caso de prueba individual.
void	testIgnored ( TestDescription test) Se llama cuando no se va a 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 los datos de registro o depuración asociados 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 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 el inicio de un caso de prueba individual.

Campos

DESPUÉS_FAILED_TESTCASES

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

Coleccionista 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

bloquear hasta que esté inactivo

public void blockUntilIdle ()

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

obtener resumen

public TestSummary getSummary ()

Permite que InvocationListener devuelva un resumen.

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

invocaciónFinalizada

public void invocationEnded (long elapsedTime)

Informa que la invocación ha finalizado, ya sea exitosamente o debido a alguna condición de error.

Será llamado automáticamente por el marco de TradeFederation.

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

invocación fallida

public void invocationFailed (Throwable cause)

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

Será llamado automáticamente por el marco de TradeFederation.

Parámetros
cause	Throwable : la causa Throwable del fallo.

invocaciónIniciada

public void invocationStarted (IInvocationContext context)

Informa el inicio de la invocación de prueba.

Será llamado automáticamente por el marco de 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

establecerAsincrónico

public void setAsynchronous (boolean asynchronous)

Establezca si la recopilació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

establecer nombre descriptivo

public void setDescriptiveName (String name)

Establezca el nombre descriptivo que se utilizará al registrar informes de errores. Si es null , BugreportCollector recurrirá al comportamiento predeterminado de serializar el nombre del evento que provocó que se recopilara el informe de error.

Parámetros
name	String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Establezca 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á y se ignorará.

Parámetros
waitTime	int

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

Parámetros
test	TestDescription : identifica la prueba.
trace	String : seguimiento de pila del error

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 pasó. También devuelve cualquier métrica clave/valor que pueda haberse 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 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 del error

pruebaIgnorado

public void testIgnored (TestDescription test)

Se llama cuando no se va a 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 los datos de registro o depuración asociados 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 : una String que describe el nombre 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 esté completo. 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.

pruebaRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Informa el final de la ejecución de la 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	: pares clave-valor informados al final de una ejecución de prueba con Metric .

prueba de ejecución fallida

public void testRunFailed (String errorMessage)

La ejecución de 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.

pruebaRunStarted

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

pruebaEjecutarDetenido

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 uso, considere eliminarlo

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

pruebaIniciada

public void testStarted (TestDescription test)

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

Parámetros
test	TestDescription : identifica la prueba.