ITestLifeCycleReceiver
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Reçoit des notifications d'événements pendant les exécutions de test d'instrumentation.
Inspiré de org.junit.runner.notification.RunListener
La séquence des appels sera:
- testRunStarted
- testStarted
- [test échoué]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
Sommaire
Méthodes publiques | |
---|---|
default void | testAssumptionFailure ( TestDescription test, String trace) Appelé lorsqu'un test atomique signale qu'il suppose une condition fausse |
default void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternative à |
default void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Signale la fin de l'exécution d'un cas de test individuel. |
default void | testFailed ( TestDescription test, String trace) Signale l'échec d'un cas de test individuel. |
default void | testIgnored ( TestDescription test) Appelé lorsqu'un test ne sera 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, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Signale la fin du test. |
default void | testRunFailed (String errorMessage) L’exécution du test des rapports n’a pas abouti en raison d’une erreur fatale. |
default void | testRunStarted (String runName, int testCount, int attemptNumber) Signale le début d'un test. |
default void | testRunStarted (String runName, int testCount) Signale le début d'un test. |
default void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Signale le début d'un test. |
default void | testRunStopped (long elapsedTime) Le test des rapports s'est arrêté avant la fin en raison d'une demande de l'utilisateur. |
default void | testStarted ( TestDescription test, long startTime) Alternative à |
default void | testStarted ( TestDescription test) Signale 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 signale qu'il suppose une condition fausse
Paramètres | |
---|---|
test | TestDescription : identifie le test |
trace | String : trace de l'échec de la pile |
testEnded
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 avec testStarted(com.android.tradefed.result.TestDescription, long)
pour une mesure précise.
Paramètres | |
---|---|
test | TestDescription : identifie le test |
endTime | long : l'heure de fin du test, mesurée via System.currentTimeMillis() |
testMetrics | ERROR(/Map) des métriques émises |
testEnded
public void testEnded (TestDescription test,testMetrics)
Signale la fin de l'exécution d'un cas de test individuel.
Si testFailed(TestDescription, String)
n'a pas été testFailed(TestDescription, String)
, ce test a réussi. Renvoie également toutes les métriques clé / valeur qui peuvent avoir été é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 |
test échoué
public void testFailed (TestDescription test, String trace)
Signale l'échec d'un cas de test individuel.
Sera appelé entre testStarted et testEnded.
Paramètres | |
---|---|
test | TestDescription : identifie le test |
trace | String : trace de l'échec de la pile |
testIgnoré
public void testIgnored (TestDescription test)
Appelé lorsqu'un test ne sera 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 du test. FIXME: Nous ne pouvons pas avoir deux interfaces Map <> avec un type différent, nous devons donc utiliser HashMap ici.
Paramètres | |
---|---|
elapsedTimeMillis | long : l'appareil a signalé le temps écoulé, en millisecondes |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
Le test des rapports n’a pas abouti en raison d’une erreur fatale.
Paramètres | |
---|---|
errorMessage | String :String décrivant la raison de l'échec de l'exécution. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Signale le début d'un test.
Paramètres | |
---|---|
runName | String : le nom du test |
testCount | int : nombre total de tests en test |
attemptNumber | int : numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le tryNumber est indexé à 0 et doit s'incrémenter chaque fois qu'une nouvelle exécution se produit. Par exemple, un test est retenté de manière granulaire 3 fois, il doit avoir 4 exécutions au total sous le même runName et le nombre de tentatives est compris entre 0 et 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Signale le début d'un test.
Paramètres | |
---|---|
runName | String : le nom du test |
testCount | int : nombre total de tests en test |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Signale le début d'un test.
Paramètres | |
---|---|
runName | String : le nom du test |
testCount | int : nombre total de tests en test |
attemptNumber | int : numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le tryNumber est indexé à 0 et doit s'incrémenter à chaque fois qu'une nouvelle exécution se produit. Par exemple, un test est retenté de manière granulaire 3 fois, il doit avoir 4 exécutions au total sous le même runName et le nombre de tentatives est compris entre 0 et 3. |
startTime | long : l'heure de démarrage de l'analyse, mesurée via System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Le test des rapports s'est arrêté avant la fin en raison d'une demande utilisateur.
TODO: actuellement inutilisé, envisagez de supprimer
Paramètres | |
---|---|
elapsedTime | long : l'appareil a signalé le temps écoulé, en millisecondes |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternative à testStarted(com.android.tradefed.result.TestDescription)
où nous testStarted(com.android.tradefed.result.TestDescription)
également quand le test a été lancé, combiné avec ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
pour une mesure précise .
Paramètres | |
---|---|
test | TestDescription : identifie le test |
startTime | long : l'heure de début du test, mesurée via System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
Signale le début d'un scénario de test individuel. Interface plus ancienne, devrait utiliser testStarted(com.android.tradefed.result.TestDescription)
chaque fois que possible.
Paramètres | |
---|---|
test | TestDescription : identifie le test |