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 (asynchronous = true), ou bloquer l'appelant jusqu'à ce que le rapport de bug soit généré (asynchronous = false).

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, testMetrics)

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, runMetrics)

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.