ITestLifeCycleReceiver
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Riceve notifiche di eventi durante le esecuzioni di test della strumentazione.
Modellato su org.junit.runner.notification.RunListener
La sequenza delle chiamate sarà:
- testRunStarted
- testAvviato
- [test non riuscito]
- [testAssunzioneFailure]
- [testIgnorato]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
Riepilogo
Metodi pubblici | |
---|---|
default void | testAssumptionFailure ( TestDescription test, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
default void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Chiamato quando un test atomico segnala che presuppone una condizione falsa |
default void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa a |
default void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Riporta la fine dell'esecuzione di un singolo test case. |
default void | testFailed ( TestDescription test, FailureDescription failure) Riporta il fallimento di un singolo test case. |
default void | testFailed ( TestDescription test, String trace) Riporta il fallimento di un singolo test case. |
default void | testIgnored ( TestDescription test) Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore. |
default void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Segnala la fine dell'esecuzione del test. |
default void | testRunFailed ( FailureDescription failure) Impossibile completare l'esecuzione del test dei report a causa di un errore descritto da |
default void | testRunFailed (String errorMessage) Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile. |
default void | testRunStarted (String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione di prova. |
default void | testRunStarted (String runName, int testCount) Segnala l'inizio di un'esecuzione di prova. |
default void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di prova. |
default void | testRunStopped (long elapsedTime) Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente. |
default void | testStarted ( TestDescription test, long startTime) Alternativa a |
default void | testStarted ( TestDescription test) Riporta l'inizio di un singolo caso di test. |
Metodi pubblici
testAssunzioneFallimento
public void testAssumptionFailure (TestDescription test, String trace)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack di errore |
testAssunzioneFallimento
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Chiamato quando un test atomico segnala che presuppone una condizione falsa
Parametri | |
---|---|
test | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
dove possiamo specificare direttamente l'ora di fine. Combinalo con testStarted(com.android.tradefed.result.TestDescription, long)
per una misurazione accurata.
Parametri | |
---|---|
test | TestDescription : identifica il test |
endTime | long : l'ora in cui è terminato il test, misurata tramite System.currentTimeMillis() |
testMetrics | ERROR(/Map) delle metriche emesse |
testEnded
public void testEnded (TestDescription test,testMetrics)
Riporta la fine dell'esecuzione di un singolo test case.
Se testFailed(TestDescription, FailureDescription)
non è stato richiamato, il test è stato superato. Restituisce inoltre qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.
Parametri | |
---|---|
test | TestDescription : identifica il test |
testMetrics | ERROR(/Map) delle metriche emesse |
prova non riuscita
public void testFailed (TestDescription test, FailureDescription failure)
Riporta il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
prova non riuscita
public void testFailed (TestDescription test, String trace)
Riporta il fallimento di un singolo test case.
Verrà chiamato tra testStarted e testEnded.
Parametri | |
---|---|
test | TestDescription : identifica il test |
trace | String : traccia dello stack di errore |
testIgnorato
public void testIgnored (TestDescription test)
Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.
Parametri | |
---|---|
test | TestDescription : identifica il test |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Segnala la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.
Parametri | |
---|---|
elapsedTimeMillis | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (FailureDescription failure)
Impossibile completare l'esecuzione del test dei report a causa di un errore descritto da FailureDescription
.
Parametri | |
---|---|
failure | FailureDescription : FailureDescription che descrive l'errore e il relativo contesto. |
testRunFailed
public void testRunFailed (String errorMessage)
Impossibile completare l'esecuzione del test dei report a causa di un errore irreversibile.
Parametri | |
---|---|
errorMessage | String : String che descrive il motivo dell'errore di esecuzione. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
attemptNumber | int : numero dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Segnala l'inizio di un'esecuzione di prova.
Parametri | |
---|---|
runName | String : il nome dell'esecuzione del test |
testCount | int : numero totale di test nell'esecuzione del test |
attemptNumber | int : numero dell'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. Ad esempio, un test granulare viene ripetuto 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il tryNumber è compreso tra 0 e 3. |
startTime | long : l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.
TODO: attualmente inutilizzato, valuta la possibilità di rimuoverlo
Parametri | |
---|---|
elapsedTime | long : il dispositivo ha riportato il tempo trascorso, in millisecondi |
testAvviato
public void testStarted (TestDescription test, long startTime)
Alternativa a testStarted(com.android.tradefed.result.TestDescription)
dove specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
per una misurazione accurata .
Parametri | |
---|---|
test | TestDescription : identifica il test |
startTime | long : l'ora di inizio del test, misurata tramite System.currentTimeMillis() |
testAvviato
public void testStarted (TestDescription test)
Riporta l'inizio di un singolo caso di test. L'interfaccia precedente dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription)
quando possibile.
Parametri | |
---|---|
test | TestDescription : identifica il test |