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:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- 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 que es falsa |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición que es 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 la falla de un caso de prueba individual. |
default
void
|
testFailed(TestDescription test, String trace)
Informa 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,
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 una falla que se describe en |
default
void
|
testRunFailed(String errorMessage)
No se pudo completar la ejecución de prueba de los informes debido a un error fatal. |
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)
Se detuvo la ejecución de prueba de los informes antes de que se completara 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 se espera habitualmente. |
default
void
|
testStarted(TestDescription test, long startTime)
Alternativa a |
default
void
|
testStarted(TestDescription test)
Informa el inicio de un caso de prueba individual. |
Métodos públicos
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Se llama cuando una prueba atómica marca que supone una condición que es falsa
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
trace |
String: Es el seguimiento de pila de la falla. |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Se llama cuando una prueba atómica marca que supone una condición que es 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 fecha y hora en 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 aprobó. También devuelve las métricas de clave/valor que se hayan 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 |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Informa 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 la falla y su contexto. |
testFailed
public void testFailed (TestDescription test, String trace)
Informa la falla de un caso de prueba individual.
Se llamará entre testStarted y testEnded.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
trace |
String: Es el seguimiento de pila de la falla. |
testIgnored
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.
| Parámetros | |
|---|---|
elapsedTimeMillis |
long: Tiempo transcurrido informado por el dispositivo, en milisegundos |
runMetrics |
: Pares clave-valor que se registran al final de una ejecución de prueba |
testRunFailed
public void testRunFailed (FailureDescription failure)
No se pudo completar la ejecución de prueba de los informes debido a una falla que se describe en 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 fatal.
| 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 la prueba. |
testCount |
int: Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se realice una nueva ejecución. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3. |
testRunStarted
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 la prueba. |
testCount |
int: Es la 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 la prueba. |
testCount |
int: Es la cantidad total de pruebas en la ejecución de prueba. |
attemptNumber |
int: Es el número de pedido que identifica los diferentes intentos del mismo runName que se ejecuta varias veces. El valor de attemptNumber se indexa a partir de 0 y debe incrementarse cada vez que se ejecute una prueba nueva. Por ejemplo, si una prueba se reintenta de forma granular 3 veces, debería tener 4 ejecuciones totales con el mismo runName y el valor de attemptNumber debería ser de 0 a 3. |
startTime |
long: Es la hora en que comenzó la ejecución, medida a través de System.currentTimeMillis(). |
testRunStopped
public void testRunStopped (long elapsedTime)
Se detuvo la ejecución de prueba de los informes antes de que se completara debido a una solicitud del usuario.
TODO: Actualmente no se usa. Considera quitarlo.
| 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 se espera habitualmente. Se intentará volver a ejecutar 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)
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 una medición precisa.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |
startTime |
long: Es la fecha y hora en que comenzó la prueba, medida a través de System.currentTimeMillis(). |
testStarted
public void testStarted (TestDescription test)
Informa el inicio de un caso de prueba individual. Interfaz más antigua. Se debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |