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 error.
- 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 errores. |
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) Establezca si la recopilación de informes de errores debe recopilar el informe de errores en un subproceso diferente ( |
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 : el ERROR(/Throwable) causa 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)
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 |
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 errores.
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 | 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 deERROR(/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 ERROR(/String) nombre descriptivo 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 | 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 : ERROR(/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 |
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2023-03-30 (UTC)