ITestLifeCycleReceiver
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Recibe notificaciones de eventos durante las pruebas de instrumentación.
Con el patrón de org.junit.runner.notification.RunListener
La secuencia de llamadas será:
- testRunStarted
- pruebaEmpezó
- [prueba fallida]
- [pruebaAsunciónFracaso]
- [prueba ignorada]
- pruebaTerminó
- ....
- [testRunFailed]
- testRunEnded
Resumen
Métodos públicos | |
---|---|
default void | testAssumptionFailure ( TestDescription test, String trace) Llamado cuando una prueba atómica marca que asume una condición que es falsa |
default void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Llamado cuando una prueba atómica marca que asume una condición que es falsa |
default void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa a |
default void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Informa el final de la ejecución de un caso de prueba individual. |
default void | testFailed ( TestDescription test, FailureDescription failure) Informa de la falla de un caso de prueba individual. |
default void | testFailed ( TestDescription test, String trace) Informa de la falla de un caso de prueba individual. |
default 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. |
default void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Informa el final de la ejecución de la prueba. |
default void | testRunFailed ( FailureDescription failure) La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por |
default void | testRunFailed (String errorMessage) La ejecución de la prueba de informes no se pudo completar debido a un error fatal. |
default void | testRunStarted (String runName, int testCount, int attemptNumber) Informa del inicio de una ejecución de prueba. |
default void | testRunStarted (String runName, int testCount) Informa del inicio de una ejecución de prueba. |
default void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Informa del inicio de una ejecución de prueba. |
default void | testRunStopped (long elapsedTime) La ejecución de la prueba de informes se detuvo antes de completarse debido a una solicitud del usuario. |
default void | testStarted ( TestDescription test, long startTime) Alternativa a |
default void | testStarted ( TestDescription test) Informa del inicio de un caso de prueba individual. |
Métodos públicos
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 |
pruebaAsunciónFalla
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Llamado cuando una prueba atómica marca que asume una condición que es falsa
Parámetros | |
---|---|
test | TestDescription : identifica la prueba |
failure | FailureDescription : FailureDescription que describe el error y su contexto. |
pruebaTerminó
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
donde podemos especificar la hora de finalización directamente. Combínelo con testStarted(com.android.tradefed.result.TestDescription, long)
para obtener una medida precisa.
Parámetros | |
---|---|
test | TestDescription : identifica la prueba |
endTime | long : la hora en que finalizó la prueba, medida a través de ERROR(/System#currentTimeMillis()) |
testMetrics | ERROR(/Map) de las métricas emitidas |
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, FailureDescription failure)
Informa de la falla de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
Parámetros | |
---|---|
test | TestDescription : identifica la prueba |
failure | FailureDescription : FailureDescription que describe el error y su contexto. |
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 |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,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 | |
---|---|
elapsedTimeMillis | long : tiempo transcurrido informado por el dispositivo, en milisegundos |
runMetrics | Metric . |
pruebaRunFailed
public void testRunFailed (FailureDescription failure)
La ejecución de la prueba de informes no se pudo completar debido a una falla descrita por FailureDescription
.
Parámetros | |
---|---|
failure | FailureDescription : FailureDescription que describe el error y su contexto. |
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, int attemptNumber)
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 |
attemptNumber | int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3. |
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 |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
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 |
attemptNumber | int : número de orden, identificando los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento está indexado en 0 y debe incrementarse cada vez que ocurre una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones totales con el mismo nombre de ejecución y el número de intento es de 0 a 3. |
startTime | long : la hora en que comenzó la ejecución, medida a través de ERROR(/System#currentTimeMillis()) |
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, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
donde también especificamos cuándo se inició la prueba, combinada con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
para una medición precisa .
Parámetros | |
---|---|
test | TestDescription : identifica la prueba |
startTime | long : la hora en que comenzó la prueba, medida a través de ERROR(/System#currentTimeMillis()) |
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 |