ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Reçoit des notifications d'événements lors de l'exécution des tests d'instrumentation.
Créé après org.junit.runner.notification.RunListener
La séquence d'appels se présente comme suit:
- Exécution du test démarrée
- Démarrage du test démarré
- [ÉchecTest]
- [testAssumptionFailure].
- [testIgnoré]
- Terminé
- ....
- TestRunEnded
Résumé
Méthodes publiques | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse |
default
void
|
testEnded(TestDescription test, long endTime,
Alternative à |
default
void
|
testEnded(TestDescription test,
Indique la fin de l'exécution d'un scénario de test individuel. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
Indique l'échec d'un scénario de test individuel. |
default
void
|
testFailed(TestDescription test, String trace)
Indique l'échec d'un scénario de test individuel. |
default
void
|
testIgnored(TestDescription test)
Appelé lorsqu'un test n'est pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis,
Signale la fin de l'exécution du test. |
default
void
|
testRunFailed(FailureDescription failure)
Échec de l'exécution du test des rapports en raison d'un échec décrit par |
default
void
|
testRunFailed(String errorMessage)
Échec de l'exécution du test des rapports en raison d'une erreur fatale. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Indique le début d'une exécution de test. |
default
void
|
testRunStarted(String runName, int testCount)
Indique le début d'une exécution de test. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Indique le début d'une exécution de test. |
default
void
|
testRunStopped(long elapsedTime)
L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue. |
default
void
|
testStarted(TestDescription test, long startTime)
Alternative à |
default
void
|
testStarted(TestDescription test)
Indique le début d'un scénario de test individuel. |
Méthodes publiques
TestAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
trace |
String : trace de la pile de défaillance |
TestAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
failure |
FailureDescription : FailureDescription décrivant l'échec et son contexte. |
Terminé
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, où nous pouvons spécifier l'heure de fin
directement. Combinez-le avec testStarted(com.android.tradefed.result.TestDescription, long)
pour obtenir des mesures précises.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
endTime |
long : heure de fin du test, mesurée via System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) des métriques émises |
Terminé
public void testEnded (TestDescription test,testMetrics)
Indique la fin de l'exécution d'un scénario de test individuel.
Si testFailed(TestDescription, FailureDescription)
n'a pas été appelé, le test a réussi. Renvoie également toute clé-valeur
qui ont pu être émises lors de l'exécution du scénario de test.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
testMetrics |
: ERROR(/Map) des métriques émises |
Échec du test
public void testFailed (TestDescription test, FailureDescription failure)
Indique l'échec d'un scénario de test individuel.
Sera appelé entre testStarted et testEnded.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
failure |
FailureDescription : FailureDescription décrivant l'échec et son contexte. |
Échec du test
public void testFailed (TestDescription test, String trace)
Indique l'échec d'un scénario de test individuel.
Sera appelé entre testStarted et testEnded.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
trace |
String : trace de la pile de défaillance |
TestIgnoré
public void testIgnored (TestDescription test)
Appelé lorsqu'un test n'est pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
TestRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Signale la fin de l'exécution du test. FIXME: Nous ne pouvons pas avoir deux éléments Map<> des interfaces de différents types, donc nous devons utiliser HashMap ici.
Paramètres | |
---|---|
elapsedTimeMillis |
long : temps écoulé indiqué par l'appareil, en millisecondes |
runMetrics |
: paires clé/valeur signalées à la fin d'un test avec Metric . |
TestRunFailed
public void testRunFailed (FailureDescription failure)
Échec de l'exécution du test des rapports en raison d'un échec décrit par FailureDescription
.
Paramètres | |
---|---|
failure |
FailureDescription : FailureDescription décrivant l'échec et son contexte. |
TestRunFailed
public void testRunFailed (String errorMessage)
Échec de l'exécution du test des rapports en raison d'une erreur fatale.
Paramètres | |
---|---|
errorMessage |
String : String décrivant la raison de l'échec de l'exécution. |
Exécution du test démarrée
public void testRunStarted (String runName, int testCount, int attemptNumber)
Indique le début d'une exécution de test.
Paramètres | |
---|---|
runName |
String : nom de l'exécution du test |
testCount |
int : nombre total de tests en cours d'exécution |
attemptNumber |
int : numéro de commande identifiant les différentes tentatives du même runName
qui sont exécutées plusieurs fois. Le numéro tryNumber est indexé par 0 et doit s'incrémenter à chaque fois.
une nouvelle exécution. Ex. : Un test est relancé trois fois de manière précise. Il doit en comporter quatre au total.
s'exécute sous le même runName, et le tryNumber est compris entre 0 et 3. |
Exécution du test démarrée
public void testRunStarted (String runName, int testCount)
Indique le début d'une exécution de test.
Paramètres | |
---|---|
runName |
String : nom de l'exécution du test |
testCount |
int : nombre total de tests en cours d'exécution |
Exécution du test démarrée
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Indique le début d'une exécution de test.
Paramètres | |
---|---|
runName |
String : nom de l'exécution du test |
testCount |
int : nombre total de tests en cours d'exécution |
attemptNumber |
int : numéro de commande identifiant les différentes tentatives du même runName
qui sont exécutées plusieurs fois. La valeur tryNumber est indexée par 0 et doit s'incrémenter chaque fois qu'une
une nouvelle exécution. Ex. : Un test est relancé trois fois de manière précise et doit comporter quatre exécutions au total.
sous le même nom d'exécution, et le numéro de tentative est compris entre 0 et 3. |
startTime |
long : heure de début de l'exécution, mesurée via System.currentTimeMillis() |
Exécution de test arrêtée
public void testRunStopped (long elapsedTime)
L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur.
À FAIRE: actuellement non utilisé, pensez à le supprimer
Paramètres | |
---|---|
elapsedTime |
long : temps écoulé indiqué par l'appareil, en millisecondes |
Test ignoré
public void testSkipped (TestDescription test, SkipReason reason)
Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue. Ces tests feront l'objet d'une nouvelle tentative pour tenter d'obtenir une exécution correcte.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
reason |
SkipReason : SkipReason |
Démarrage du test démarré
public void testStarted (TestDescription test, long startTime)
Alternative à testStarted(com.android.tradefed.result.TestDescription)
, où nous spécifions également quand le test a été
et ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
pour une mesure précise.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |
startTime |
long : heure de début du test, mesurée via System.currentTimeMillis() |
Démarrage du test démarré
public void testStarted (TestDescription test)
Indique le début d'un scénario de test individuel. Ancienne interface. Utilisez testStarted(com.android.tradefed.result.TestDescription)
autant que possible.
Paramètres | |
---|---|
test |
TestDescription : identifie le test. |