BugreportCollector
public
class
BugreportCollector
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.BugreportCollector |
Un ITestInvocationListener
passthrough qui collecte des rapports de bug lors d'événements configurables
se produit, puis appelle ITestInvocationListener#testLog
sur ses enfants après chaque
rapport de bug est collecté.
Comportements: (CORRIGER: finaliser cette étape)
- Effectuer une capture après chaque scénario en cas d'échec des scénarios de test
- Capturer après chaque scénario de test
- Capturer après chaque scénario ayant échoué
- Filmez
Résumé
Classes imbriquées | |
---|---|
class |
BugreportCollector.Predicate
Prédicat complet décrivant quand générer un rapport de bug. |
interface |
BugreportCollector.SubPredicate
|
Champs | |
---|---|
public
static
final
BugreportCollector.Predicate |
AFTER_FAILED_TESTCASES
Un prédicat prédéfini qui se déclenche après chaque scénario ayant échoué |
public
static
final
BugreportCollector.Predicate |
AT_START
Un prédicat prédéfini qui se déclenche au début du premier appel |
Constructeurs publics | |
---|---|
BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)
|
Méthodes publiques | |
---|---|
void
|
addPredicate(BugreportCollector.Predicate p)
|
void
|
blockUntilIdle()
Bloquer jusqu'à ce que le collecteur ne collecte aucun rapport de bug. |
TestSummary
|
getSummary()
Permet à l'écouteur InvocationListener de renvoyer un résumé. |
void
|
invocationEnded(long elapsedTime)
Indique que l'appel s'est arrêté, que ce soit avec succès ou en raison d'une erreur . |
void
|
invocationFailed(Throwable cause)
Signale un appel incomplet en raison d'une condition d'erreur. |
void
|
invocationStarted(IInvocationContext context)
Indique le début de l'appel de test. |
void
|
setAsynchronous(boolean asynchronous)
Indiquer si la collecte du rapport de bug doit collecter le rapport de bug dans un autre thread
( |
void
|
setDescriptiveName(String name)
Définissez le nom descriptif à utiliser lors de l'enregistrement des rapports de bug. |
void
|
setDeviceWaitTime(int waitTime)
Définissez le délai (en secondes) au terme duquel l'appareil est en ligne avant d'effectuer une capture d'écran. rapport de bug. |
void
|
testAssumptionFailure(TestDescription test, String trace)
Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse |
void
|
testEnded(TestDescription test,
Indique la fin de l'exécution d'un scénario de test individuel. |
void
|
testFailed(TestDescription test, String trace)
Indique l'échec d'un scénario de test individuel. |
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. |
void
|
testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)
Fournit les données de journal ou de débogage associées à l'appel de test. |
void
|
testRunEnded(long elapsedTime,
Signale la fin de l'exécution du test. |
void
|
testRunFailed(String errorMessage)
Échec de l'exécution du test des rapports en raison d'une erreur fatale. |
void
|
testRunStarted(String runName, int testCount)
Indique le début d'une exécution de test. |
void
|
testRunStopped(long elapsedTime)
L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur. |
void
|
testStarted(TestDescription test)
Indique le début d'un scénario de test individuel. |
Champs
APRÈS_ÉCHEC_DE_TESTS
public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES
Un prédicat prédéfini qui se déclenche après chaque scénario ayant échoué
À_DÉBUT
public static final BugreportCollector.Predicate AT_START
Un prédicat prédéfini qui se déclenche au début du premier appel
Constructeurs publics
BugreportCollector
public BugreportCollector (ITestInvocationListener listener, ITestDevice testDevice)
Paramètres | |
---|---|
listener |
ITestInvocationListener |
testDevice |
ITestDevice |
Méthodes publiques
addPredicate
public void addPredicate (BugreportCollector.Predicate p)
Paramètres | |
---|---|
p |
BugreportCollector.Predicate |
blocJusqu'à l'inactivité
public void blockUntilIdle ()
Bloquer jusqu'à ce que le collecteur ne collecte aucun rapport de bug. Si le collecteur n'est pas actif un rapport de bug, renvoyez immédiatement
getSummary
public TestSummary getSummary ()
Permet à l'écouteur InvocationListener de renvoyer un résumé.
Renvoie | |
---|---|
TestSummary |
Valeur TestSummary résumant l'exécution, ou valeur nulle |
invocationEnded
public void invocationEnded (long elapsedTime)
Indique que l'appel s'est arrêté, que ce soit avec succès ou en raison d'une erreur .
Sera automatiquement appelée par le framework TradeFederation.
Paramètres | |
---|---|
elapsedTime |
long : temps écoulé de l'appel en ms |
échec de l'appel
public void invocationFailed (Throwable cause)
Signale un appel incomplet en raison d'une condition d'erreur.
Sera automatiquement appelée par le framework TradeFederation.
Paramètres | |
---|---|
cause |
Throwable : cause de l'échec (Throwable ) |
appel démarré
public void invocationStarted (IInvocationContext context)
Indique le début de l'appel de test.
Sera automatiquement appelée par le framework TradeFederation. Les auteurs de rapports doivent ignorer pour créer des rapports sur plusieurs appareils.
Paramètres | |
---|---|
context |
IInvocationContext : informations sur l'appel |
setAsynchrone
public void setAsynchronous (boolean asynchronous)
Indiquer si la collecte du rapport de bug doit collecter le rapport de bug dans un autre thread
(asynchronous = true
), ou bloquer l'appelant jusqu'à ce que le rapport de bug soit généré
(asynchronous = false
).
Paramètres | |
---|---|
asynchronous |
boolean |
DéfinirNomDescriptif
public void setDescriptiveName (String name)
Définissez le nom descriptif à utiliser lors de l'enregistrement des rapports de bug. Si la valeur est null
,
BugreportCollector
revient au comportement par défaut de sérialisation du nom
l'événement à l'origine de la collecte du rapport de bug.
Paramètres | |
---|---|
name |
String |
setDeviceWaitTime
public void setDeviceWaitTime (int waitTime)
Définissez le délai (en secondes) au terme duquel l'appareil est en ligne avant d'effectuer une capture d'écran.
rapport de bug. Si elle est négative, aucune vérification n'est effectuée. Tous les DeviceNotAvailableException
rencontrés lors de cette vérification sera consigné et ignoré.
Paramètres | |
---|---|
waitTime |
int |
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 |
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, 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. |
JournalTest
public void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)
Fournit les données de journal ou de débogage associées à l'appel de test.
Doit être appelé avant ERROR(/ITestInvocationListener#invocationFailed(Throwable))
ou
ERROR(/ITestInvocationListener#invocationEnded(long))
Le framework Tradefédération appelle automatiquement cette méthode et fournit le journal de l'hôte. et, le cas échéant, le fichier logcat de l'appareil.
Paramètres | |
---|---|
dataName |
String : nom descriptif String des données. Ex. : "device_logcat". Remarque
Le nom dataName ne peut pas être unique par appel. Autrement dit, les responsables de la mise en œuvre doivent
plusieurs appels avec le même dataName |
dataType |
LogDataType : LogDataType des données |
dataStream |
InputStreamSource : InputStreamSource des données. Les responsables de la mise en œuvre doivent appeler
createInputStream pour commencer à lire les données, et veillez à fermer le résultat
InputStream une fois l'opération terminée. Les appelants doivent s'assurer que la source des données est conservée
et accessibles jusqu'à ce que la méthode testLog soit terminée. |
TestRunEnded
public void testRunEnded (long elapsedTime,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 | |
---|---|
elapsedTime |
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 (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)
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 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 |
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. |