Cette page a été traduite par l'API Cloud Translation.

Écouteur de modules

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

Écouteur associé à chaque IRemoteTest de chaque module afin de collecter la liste des résultats.

Résumé

Constructeurs publics
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` Constructeur.

Méthodes publiques
`boolean`	`hasLastAttemptFailed()` Indique si la dernière tentative de session de l'écouteur a échoué ou non.
`void`	`logAssociation(String dataName, LogFile logFile)` Dans certains cas, le journal doit être fortement associé à un scénario test, mais la possibilité de Ainsi, sur la ligne directe `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` n'est pas possible.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Détermine si la tentative doit être signalée comme isolée.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` Détermine si nous ne collectons ou non que les tests.
`void`	`setMarkTestsSkipped(boolean skip)` Indique si tous les scénarios de test doivent être marqués comme ignorés.
`void`	`setTestMappingSources( testMappingSources)` Définit les sources de mappage de test qui seront insérées dans les métriques.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`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.
`void`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution d'un scénario de test individuel.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Indique l'échec 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)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testRunEnded(long elapsedTime, runMetrics)` Signale la fin de l'exécution du test.
`void`	`testRunFailed(FailureDescription failure)` Échec de l'exécution du test des rapports en raison d'un échec décrit par `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` Échec de l'exécution du test des rapports en raison d'une erreur fatale.
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` Indique le début d'une exécution de test.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Indique le début d'une exécution de test.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue.
`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.

Constructeurs publics

Écouteur de modules

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Constructeur.

Paramètres
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

Méthodes publiques

hasLastTryFailed

public boolean hasLastAttemptFailed ()

Indique si la dernière tentative de session de l'écouteur a échoué ou non.

Renvoie
`boolean`

association log

public void logAssociation (String dataName, 
                LogFile logFile)

Dans certains cas, le journal doit être fortement associé à un scénario test, mais la possibilité de Ainsi, sur la ligne directe testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) n'est pas possible. Ainsi, ce rappel permet de fournir une association forte explicitement.

Paramètres
`dataName`	`String`: nom des données
`logFile`	`LogFile`: le `LogFile` qui a été consigné précédemment et doit être associé à scénario de test.

setTentativeIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Détermine si la tentative doit être signalée comme isolée.

Paramètres
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Détermine si nous ne collectons ou non que les tests.

Paramètres
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Indique si tous les scénarios de test doivent être marqués comme ignorés.

Paramètres
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

Définit les sources de mappage de test qui seront insérées dans les métriques.

Paramètres
`testMappingSources`

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.

JournalTest

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Paramètres
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

JournalTest enregistré

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Paramètres
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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 (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 name, 
                int numTests, 
                int attemptNumber)

Indique le début d'une exécution de test.

Paramètres
`name`	`String`: nom de l'exécution du test
`numTests`	`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 name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Indique le début d'une exécution de test.

Paramètres
`name`	`String`: nom de l'exécution du test
`numTests`	`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()`

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()`