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, testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), en la que podemos especificar la hora de finalización directamente.

default void 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 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, runMetrics)

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 FailureDescription.

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 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.

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.