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, HashMap<String, MetricMeasurement.Metric> testMetrics)
Informa el final de la ejecución de un caso de prueba individual. |
default
void
|
testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)
Alternativa a |
default
void
|
testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Alternativa a |
default
void
|
testEnded(TestDescription test, Map<String, String> testMetrics)
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, HashMap<String, MetricMeasurement.Metric> runMetrics)
Informa el final de una ejecución de prueba. |
default
void
|
testRunEnded(long elapsedTimeMillis, Map<String, String> runMetrics)
Informa el final de una ejecución de prueba. |
default
void
|
testRunFailed(FailureDescription failure)
No se pudo completar la ejecución de prueba de informes debido a un error descrito por |
default
void
|
testRunFailed(String errorMessage)
Informa que no se pudo completar la ejecución de prueba 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)
Se detuvo la ejecución de prueba 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, HashMap<String, MetricMeasurement.Metric> 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 |
HashMap: Un Map de las métricas emitidas. |
testEnded
public void testEnded (TestDescription test, long endTime, Map<String, String> testMetrics)
Alternativa a testEnded(TestDescription,Map) en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(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 |
Map: Un Map de las métricas emitidas. |
testEnded
public void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
Alternativa a testEnded(TestDescription,Map) en la que podemos especificar la hora de finalización directamente. Combínalo con testStarted(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 |
HashMap: Un Map de las métricas emitidas. |
testEnded
public void testEnded (TestDescription test, Map<String, String> 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 |
Map: Un 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,
HashMap<String, MetricMeasurement.Metric> runMetrics)Informa el final de una ejecución de prueba. FIXME: No podemos tener dos interfaces Map<> con diferentes tipos, por lo que tenemos que usar HashMap aquí.
| Parámetros | |
|---|---|
elapsedTimeMillis |
long: Tiempo transcurrido informado por el dispositivo, en milisegundos. |
runMetrics |
HashMap: Pares clave-valor que se registran al final de una ejecución de prueba con Metric. |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
Map<String, String> runMetrics)Informa el final de una ejecución de prueba.
| Parámetros | |
|---|---|
elapsedTimeMillis |
long: Tiempo transcurrido informado por el dispositivo, en milisegundos. |
runMetrics |
Map: 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 informes debido a un error descrito por FailureDescription.
| Parámetros | |
|---|---|
failure |
FailureDescription: FailureDescription que describe la falla y su contexto. |
testRunFailed
public void testRunFailed (String errorMessage)
Informa que no se pudo completar la ejecución de prueba 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 una 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 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 nueva prueba. 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 una ejecución de 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 una 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 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 nueva prueba. 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 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(TestDescription) en la que también especificamos cuándo se inició la prueba, combinada con testEnded(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. Es una interfaz más antigua. Se debe usar testStarted(TestDescription) siempre que sea posible.
| Parámetros | |
|---|---|
test |
TestDescription: Identifica la prueba. |