ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Recibe notificaciones de eventos durante las ejecuciones de pruebas de instrumentación.
Se basa en org.junit.runner.notification.RunListener.
La secuencia de llamadas será la siguiente:
- pruebaRunStarted
- testStarted
- [testFailed]
- [falla-de-pruebadesumo]
- [testIgnored]
- testEnded
- ....
- [pruebadeprueba]
- testRunEnded
Resumen
Métodos públicos | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Se llama cuando una prueba atómica marca que supone una condición falsa. |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición falsa. |
default
void
|
testEnded(TestDescription test, long endTime,
Es una 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 ejecutará una prueba, por lo general, porque un método de prueba está anotado con org.junit.Ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis,
Informa el final de la ejecución de 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 no suele esperarse. |
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 supone una condición falsa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
trace |
String : Seguimiento de pila de las fallas |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición falsa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
failure |
FailureDescription : FailureDescription que describe la falla y su contexto |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Es una 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 una medición precisa.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
endTime |
long : Es la hora en la que finalizó la prueba, medida a través de System.currentTimeMillis() . |
testMetrics |
: Un ERROR(/Map) de las métricas emitidas |
testEnded
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ó. También muestra cualquier métrica de par clave-valor que se haya 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 |
testFailed
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 la falla |
testIgnored
public void testIgnored (TestDescription test)
Se llama cuando no se ejecutará una prueba, por lo general, 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 prueba.
Parámetros | |
---|---|
elapsedTimeMillis |
long : Tiempo transcurrido informado por el dispositivo, en milisegundos |
runMetrics |
: Pares clave-valor informados al final de una ejecución de prueba |
testRunFailed
public void testRunFailed (FailureDescription failure)
No se pudo completar la ejecución de prueba de informes debido a una falla que describe FailureDescription
.
Parámetros | |
---|---|
failure |
FailureDescription : FailureDescription que describe la falla y su contexto |
testRunFailed
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 la ejecución. |
testRunStarted
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 : Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int : Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El attemptNumber tiene un índice de 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el attemptNumber va de 0 a 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 |
testRunStarted
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 : Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int : Es el número de orden que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber está indexado en 0 y debe aumentar cada vez que se realiza una ejecución nueva. p.ej., si una prueba se vuelve a intentar de forma granular 3 veces, debe tener 4 ejecuciones en total con el mismo runName y el valor de attemptNumber debe estar entre 0 y 3. |
startTime |
long : La hora en que comenzó la ejecución, medida a través de System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
La ejecución de prueba de informes se detuvo antes de completarse debido a una solicitud del usuario.
TODO: currently unused, consider removing
Parámetros | |
---|---|
elapsedTime |
long : Tiempo transcurrido informado por el dispositivo, en milisegundos |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Se llama cuando se omite una prueba y no se ejecuta por un motivo que no suele esperarse. Se intentará volver a realizar estas pruebas para obtener una ejecución adecuada.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Es una alternativa a testStarted(com.android.tradefed.result.TestDescription)
, en la que también especificamos cuándo se inició la prueba, combinada 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. Interfaz más antigua, debe usar testStarted(com.android.tradefed.result.TestDescription)
siempre que sea posible.
Parámetros | |
---|---|
test |
TestDescription : Identifica la prueba. |