ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Recibe notificaciones de eventos durante las ejecuciones de pruebas de instrumentación.
Con un patrón de org.junit.runner.notification.RunListener
La secuencia de llamadas será la siguiente:
- pruebaRunStarted
- Iniciodeprueba
- [Prueba con errores]
- [falla-de-pruebadesumo]
- [prueba ignorada]
- pruebaFinalizada
- ....
- [pruebadeprueba]
- pruebaRunfinalizada
Resumen
Métodos públicos | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Se llama cuando una prueba atómica marca que asume una condición falsa. |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que asume una condición falsa. |
default
void
|
testEnded(TestDescription test, long endTime,
Alternativa a |
default
void
|
testEnded(TestDescription test,
Informa el final de la ejecución de un caso de prueba individual. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
Informa el error de un caso de prueba individual. |
default
void
|
testFailed(TestDescription test, String trace)
Informa el error de un caso de prueba individual. |
default
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. |
default
void
|
testRunEnded(long elapsedTimeMillis,
Informa el final de la ejecución de la prueba. |
default
void
|
testRunFailed(FailureDescription failure)
No se pudo completar la ejecución de prueba de los informes debido a un error que describe |
default
void
|
testRunFailed(String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error grave. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Informa el inicio de una ejecución de prueba. |
default
void
|
testRunStarted(String runName, int testCount)
Informa el inicio de una ejecución de prueba. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Informa el inicio de una ejecución de prueba. |
default
void
|
testRunStopped(long elapsedTime)
La ejecución de prueba de los informes se detuvo antes de completarse debido a una solicitud del usuario. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera. |
default
void
|
testStarted(TestDescription test, long startTime)
Es una alternativa a |
default
void
|
testStarted(TestDescription test)
Informa el inicio de un caso de prueba individual. |
Métodos públicos
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 |
ErrordeAsuncióndeprueba
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que asume una condición falsa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
failure |
FailureDescription : FailureDescription que describe la falla y su contexto |
pruebaFinalizada
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, en la que podemos especificar la hora de finalización
directamente. Combínalo con testStarted(com.android.tradefed.result.TestDescription, long)
para obtener mediciones precisas.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
endTime |
long : La hora en la que finalizó la prueba, medida mediante System.currentTimeMillis() |
testMetrics |
: Una ERROR(/Map) de las métricas emitidas |
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, FailureDescription failure)
Informa el error de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
failure |
FailureDescription : FailureDescription que describe la falla y su contexto |
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. |
pruebaRunfinalizada
public void testRunEnded (long elapsedTimeMillis,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 | |
---|---|
elapsedTimeMillis |
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 (FailureDescription failure)
No se pudo completar la ejecución de prueba de los informes debido a un error que describe FailureDescription
.
Parámetros | |
---|---|
failure |
FailureDescription : FailureDescription que describe la falla y su contexto |
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, int attemptNumber)
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 |
attemptNumber |
int : Número de pedido, que identifica los diferentes intentos del mismo runName
que se ejecutan varias veces. El valor de tryNumber tiene un índice 0 y debería aumentarse cada vez
se ejecuta una nueva ejecución. p.ej., Se vuelve a intentar una prueba detallada 3 veces; debería tener 4 en total
se ejecuta con el mismo runName y tryNumber del 0 al 3. |
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 |
pruebaRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
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 |
attemptNumber |
int : Número de pedido, que identifica los diferentes intentos del mismo runName
que se ejecutan varias veces. El valor de intentNumber tiene un índice 0 y debería aumentarse cada vez que se genera un
una nueva carrera. p.ej., Se vuelve a intentar una prueba detallada 3 veces, por lo que debería tener 4 ejecuciones en total
con el mismo runName e tryNumber del 0 al 3. |
startTime |
long : Es la hora en que comenzó la ejecución, medida mediante System.currentTimeMillis() . |
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. |
pruebaOmitir
public void testSkipped (TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que normalmente no se espera. Se intentará volver a realizar estas pruebas para que se ejecute correctamente.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
reason |
SkipReason : SkipReason |
Iniciodeprueba
public void testStarted (TestDescription test, long startTime)
Es una alternativa a testStarted(com.android.tradefed.result.TestDescription)
, donde también especificamos cuándo se realizó la prueba.
comenzó y se combinó con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
para obtener una medición precisa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
startTime |
long : Es la hora en que comenzó la prueba, medida mediante System.currentTimeMillis() . |
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. |