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

ModuleListener

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 l'écouteur a échoué ou non.
`void`	`logAssociation(String dataName, LogFile logFile)` Dans certains cas, le journal doit être fortement associé à un cas de test, mais il n'est pas possible de le faire sur le rappel `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` direct.
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Indique si la tentative doit être signalée comme isolée ou non.
`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 directement l'heure de fin.
`void`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution d'un cas de test individuel.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Signale l'échec d'un cas de test individuel.
`void`	`testFailed(TestDescription test, String trace)` Signale l'échec d'un cas de test individuel.
`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.
`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)` L'exécution du test des rapports a échoué en raison d'un échec décrit par `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` L'exécution du test des rapports a échoué 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 n'a pas été exécuté pour une raison inhabituelle.
`void`	`testStarted(TestDescription test, long startTime)` Alternative à `testStarted(com.android.tradefed.result.TestDescription)`, où nous spécifions également quand le test a été lancé, combiné à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` pour une mesure précise.

Constructeurs publics

ModuleListener

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

Constructeur.

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

Méthodes publiques

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

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

Renvoie
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dans certains cas, le journal doit être fortement associé à un cas de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) direct. Ainsi, ce rappel permet d'établir explicitement une association forte.

Paramètres
`dataName`	`String`: nom des données
`logFile`	`LogFile`: `LogFile` enregistré précédemment et qui doit être associé au cas de test.

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

Indique si la tentative doit être signalée comme isolée ou non.

Paramètres
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

Indique si nous ne collectons 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 l'échec

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.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier directement l'heure de fin. Combinez-le à 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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Indique la fin de l'exécution d'un cas de test individuel.

Si testFailed(TestDescription, FailureDescription) n'a pas été appelé, ce test est réussi. Renvoie également toutes les métriques clé/valeur qui ont pu être émises lors de l'exécution du cas de test.

Paramètres
`test`	`TestDescription`: identifie le test
`testMetrics`	: `ERROR(/Map)` des métriques émises

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signale l'échec d'un cas de test individuel.

Appelé entre testStarted et testEnded.

Paramètres
`test`	`TestDescription`: identifie le test.
`failure`	`FailureDescription`: `FailureDescription` décrivant l'échec et son contexte.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Signale l'échec d'un cas de test individuel.

Appelé entre testStarted et testEnded.

Paramètres
`test`	`TestDescription`: identifie le test
`trace`	`String`: trace de la pile de l'échec

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.

testLog

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

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

testLogSaved

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.

Paramètres
`elapsedTime`	`long`: durée écoulée, en millisecondes, indiquée par l'appareil
`runMetrics`	: paires clé-valeur signalées à la fin d'une exécution de test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports a échoué 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)

L'exécution du test des rapports a échoué 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 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 dans l'exécution de test
`attemptNumber`	`int`: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le numéro "tentative" est indexé par 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, un test précis a été relancé trois fois, il 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.

testRunStarted

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 dans l'exécution de test
`attemptNumber`	`int`: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque nouvelle exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être compris entre 0 et 3.
`startTime`	`long`: heure de début de l'exécution, mesurée via `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle. Nous allons tenter de réexécuter ces tests pour 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 le moment où le test a commencé, combiné à 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()`