Receptor ITestLifeCycle

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


Recibe notificaciones de eventos durante las ejecuciones de pruebas de instrumentación.

Modelado según org.junit.runner.notification.RunListener

La secuencia de convocatorias será:

  • pruebaRunStarted
  • pruebaIniciada
  • [prueba fallida]
  • [pruebaAsunciónFalla]
  • [pruebaIgnorada]
  • pruebafinalizada
  • ....
  • [prueba de ejecución fallida]
  • pruebaRunEnded

Resumen

Métodos públicos

default void testAssumptionFailure ( TestDescription test, String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

default void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

default void testEnded ( TestDescription test, long endTime, testMetrics) 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.

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 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 va a 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 prueba de informes no se pudo completar debido a un error descrito en FailureDescription .

default void testRunFailed (String errorMessage)

La ejecución de 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 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)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) donde también especificamos cuándo se inició la prueba, combinado con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) para una medición precisa .

default void testStarted ( TestDescription test)

Informa el inicio de un caso de prueba individual.

Métodos públicos

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                String trace)

Se llama cuando una prueba atómica indica que asume una condición que es falsa

Parámetros
test TestDescription : identifica la prueba.

trace String : seguimiento de pila del error

pruebaSuposiciónFracaso

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Se llama cuando una prueba atómica indica 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.

pruebafinalizada

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 System.currentTimeMillis()

testMetrics : un 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 pasó. También devuelve cualquier métrica clave/valor que pueda haberse 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

prueba fallida

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 el error y su contexto.

prueba fallida

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 del error

pruebaIgnorado

public void testIgnored (TestDescription test)

Se llama cuando no se va a ejecutar una prueba, generalmente porque un método de prueba está anotado con org.junit.Ignore.

Parámetros
test TestDescription : identifica la prueba.

pruebaRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Informa el final de la ejecución de la 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 : pares clave-valor informados al final de una ejecución de prueba con Metric .

prueba de ejecución fallida

public void testRunFailed (FailureDescription failure)

La ejecución de prueba de informes no se pudo completar debido a un error descrito en FailureDescription .

Parámetros
failure FailureDescription : FailureDescription que describe el error y su contexto.

prueba de ejecución fallida

public void testRunFailed (String errorMessage)

La ejecución de prueba de informes no se pudo completar debido a un error fatal.

Parámetros
errorMessage String : String que describe el motivo del error de ejecución.

pruebaRunStarted

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 pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo el mismo nombre de ejecución y el número de intento es de 0 a 3.

pruebaRunStarted

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

pruebaRunStarted

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 pedido, que identifica los diferentes intentos del mismo runName que se ejecutan varias veces. El número de intento tiene un índice de 0 y debe incrementarse cada vez que se realiza una nueva ejecución. Por ejemplo, una prueba se reintenta granularmente 3 veces, debe tener 4 ejecuciones en total bajo 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 mediante System.currentTimeMillis()

pruebaEjecutarDetenido

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 uso, considere eliminarlo

Parámetros
elapsedTime long : tiempo transcurrido informado por el dispositivo, en milisegundos

prueba omitida

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 intentar obtener una ejecución adecuada.

Parámetros
test TestDescription : identifica la prueba.

reason SkipReason : SkipReason

pruebaIniciada

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, combinado 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 System.currentTimeMillis()

pruebaIniciada

public void testStarted (TestDescription test)

Informa el inicio de un caso de prueba individual. La interfaz anterior debe usar testStarted(com.android.tradefed.result.TestDescription) siempre que sea posible.

Parámetros
test TestDescription : identifica la prueba.