À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

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

CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener

Sous-classes directes connues

JsonHttpTestResultReporter, MetricsXMLResultReporter, ModuleListener, ReportPassedTests, ResultAggregator, ShardListener, SuiteResultReporter, XmlResultReporter

JsonHttpTestResultReporter	Un outil de création de rapports sur les résultats qui encode les résultats des métriques de test et les informations sur la branche et l'appareil au format JSON, puis les envoie en POST vers un point de terminaison de service HTTP.
MetricsXMLResultReporter	MetricsXMLResultReporter écrit les métriques de test et les métriques d'exécution dans un fichier XML dans un dossier spécifié par le paramètre metrics-folder lors de la phase invocationEnded du test.
ModuleListener	Écouteur associé à chaque `IRemoteTest` de chaque module afin de collecter la liste des résultats.
ReportPassedTests	Signalez dans un fichier les filtres possibles pour exclure les tests réussis.
ResultAggregator	Transmetteur spécial qui agrège les résultats si nécessaire, en fonction de la stratégie de nouvelle tentative adoptée.
ShardListener	`ITestInvocationListener` qui collecte les résultats d'un segment d'invocation (également appelé fractionnement d'invocation pour s'exécuter sur plusieurs ressources en parallèle) et les transfère à un autre écouteur.
SuiteResultReporter	Collectez les résultats des tests pour une invocation de suite complète et affichez les résultats finaux.
XmlResultReporter	Écrit les résultats JUnit dans un fichier XML au format compatible avec XMLJUnitResultFormatter d'Ant.

Sous-classes indirectes connues

FormattedGeneratorReporter, XmlFormattedGeneratorReporter

FormattedGeneratorReporter	Outil de création de rapports permettant de générer des rapports dans un format particulier.
XmlFormattedGeneratorReporter	Implémentation de `FormattedGeneratorReporter` qui met en forme les résultats de la suite au format XML.

Un ITestInvocationListener qui collecte tous les résultats des tests.

Bien que les structures de données utilisées dans cet objet soient thread-safe, les rappels ITestInvocationListener doivent être appelés dans l'ordre correct.

Résumé

Constructeurs publics
`CollectingTestListener()`

Méthodes publiques
`IBuildInfo`	`getBuildInfo()` Cette méthode est obsolète. s'appuyer sur le `IBuildInfo` de `getInvocationContext()`.
`TestRunResult`	`getCurrentRunResults()` Récupère les résultats de l'exécution de test en cours.
`int`	`getExpectedTests()` Renvoie le nombre de tests attendus.
`IInvocationContext`	`getInvocationContext()` Renvoie le contexte d'appel signalé via `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getMergedTestRunResults()` Renvoie la collection fusionnée des résultats pour toutes les exécutions au cours de différentes tentatives.
`IInvocationContext`	`getModuleContextForRunResult(String testRunName)` Renvoie l'`IInvocationContext` du module associé aux résultats.
`MultiMap<String, LogFile>`	`getModuleLogFiles()` Renvoie une copie de la carte contenant tous les fichiers journalisés associés au module.
`MultiMap<String, LogFile>`	`getNonAssociatedLogFiles()` Renvoie une copie de la carte contenant tous les fichiers journalisés qui ne sont pas associés à une exécution de test ou à un module.
`int`	`getNumAllFailedTestRuns()` Renvoie le nombre total d'exécutions de test dans un état d'échec
`int`	`getNumAllFailedTests()` Renvoie le nombre total de tests en état d'échec (seuls les échecs, les échecs d'hypothèse ne sont pas pris en compte).
`int`	`getNumTestsInState(TestResult.TestStatus status)` Renvoie le nombre de tests dans un état donné pour cette exécution.
`int`	`getNumTotalTests()` Renvoie le nombre total de tests terminés pour toutes les exécutions.
`IBuildInfo`	`getPrimaryBuildInfo()` Renvoie les informations de compilation principales signalées via `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
	`getRunResults()` Cette méthode est obsolète. Utiliser `getMergedTestRunResults()`
`TestRunResult`	`getTestRunAtAttempt(String testRunName, int attempt)` Renvoyez `TestRunResult` pour une seule tentative.
`int`	`getTestRunAttemptCount(String testRunName)` Affiche le nombre de tentatives pour un nom d'exécution de test donné.
	`getTestRunAttempts(String testRunName)` Récupère toutes les tentatives pour un `TestRunResult` d'une exécution de test donnée.
	`getTestRunForAttempts(int attempt)` Récupère tous les résultats d'une tentative donnée.
	`getTestRunNames()` Renvoie tous les noms de toutes les exécutions de test.
`boolean`	`hasFailedTests()` Indique si l'appel a généré des tests échoués ou des tests d'hypothèse échoués.
`boolean`	`hasTestRunResultsForName(String testRunName)` Indique si un nom d'exécution de test donné renvoie des résultats.
`void`	`invocationEnded(long elapsedTime)`
`void`	`invocationFailed(Throwable cause)`
`void`	`invocationStarted(IInvocationContext context)`
`void`	`logAssociation(String dataName, LogFile logFile)`
`void`	`setBuildInfo(IBuildInfo buildInfo)` Cette méthode est obsolète. Plus nécessaire pour les tests.
`void`	`setMergeStrategy(MergeStrategy strategy)` Définit l'`MergeStrategy` à utiliser lors de la fusion des résultats.
`void`	`testAssumptionFailure(TestDescription test, String trace)`
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`void`	`testEnded(TestDescription test, testMetrics)`
`void`	`testFailed(TestDescription test, FailureDescription failure)`
`void`	`testFailed(TestDescription test, String trace)`
`void`	`testIgnored(TestDescription test)`
`void`	`testModuleEnded()`
`void`	`testModuleStarted(IInvocationContext moduleContext)`
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failure)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber)`
`void`	`testRunStarted(String name, int numTests)`
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)`
`void`	`testRunStopped(long elapsedTime)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Méthodes protégées
`final void`	`clearModuleLogFiles()` Permet de nettoyer le fichier du module afin d'éviter de le conserver trop longtemps.
`final void`	`clearResultsForName(String testRunName)` Permet d'effacer les résultats pour un nom d'exécution donné.
`void`	`setIsAggregrateMetrics(boolean aggregate)` Activer/Désactiver l'option "Métriques agrégées"

Constructeurs publics

CollectingTestListener

public CollectingTestListener ()

Méthodes publiques

getBuildInfo

public IBuildInfo getBuildInfo ()

Cette méthode est obsolète.
dépend de IBuildInfo de getInvocationContext().

Renvoie les informations de compilation.

Renvoie
`IBuildInfo`

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

Récupère les résultats de l'exécution de test en cours.

Notez que les résultats peuvent être incomplets. Il est recommandé de tester la valeur de TestRunResult.isRunComplete() et/ou (@link TestRunResult#isRunFailure()} selon le cas avant de traiter les résultats.

Renvoie
`TestRunResult`	`TestRunResult` représentant les données collectées lors de la dernière exécution du test

getExpectedTests

public int getExpectedTests ()

Renvoie le nombre de tests attendus. Peut différer de getNumTotalTests() si certains tests ne s'exécutent pas.

Renvoie
`int`

getInvocationContext

public IInvocationContext getInvocationContext ()

Renvoie le contexte d'appel signalé via invocationStarted(com.android.tradefed.invoker.IInvocationContext).

Renvoie
`IInvocationContext`

getMergedTestRunResults

public  getMergedTestRunResults ()

Renvoie la collection fusionnée des résultats pour toutes les exécutions au cours de différentes tentatives.

S'il existe plusieurs résultats, chaque exécution de test est fusionnée, et le dernier résultat écrase les résultats des exécutions précédentes. Les exécutions de test sont triées par numéro de tentative.

Les métriques d'une même tentative seront fusionnées en fonction de la préférence définie par aggregate-metrics. Les métriques finales seront celles de la dernière tentative.

Renvoie

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

Renvoie l'IInvocationContext du module associé aux résultats.

Paramètres
`testRunName`	`String`: nom donné par {`testRunStarted(String, int)`.

Renvoie
`IInvocationContext`	`IInvocationContext` du module pour un nom d'exécution de test `null` donné s'il n'y a pas de résultats pour ce nom.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

Renvoie une copie de la carte contenant tous les fichiers journalisés associés au module.

Renvoie
`MultiMap<String, LogFile>`

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

Renvoie une copie de la carte contenant tous les fichiers journalisés qui ne sont pas associés à une exécution de test ou à un module.

Renvoie
`MultiMap<String, LogFile>`

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

Renvoie le nombre total d'exécutions de test dans un état d'échec

Renvoie
`int`

getNumAllFailedTests

public int getNumAllFailedTests ()

Renvoie le nombre total de tests en état d'échec (seuls les échecs, les échecs d'hypothèse ne sont pas pris en compte).

Renvoie
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

Renvoie le nombre de tests dans un état donné pour cette exécution.

Paramètres
`status`	`TestResult.TestStatus`

Renvoie
`int`

getNumTotalTests

public int getNumTotalTests ()

Renvoie le nombre total de tests terminés pour toutes les exécutions.

Renvoie
`int`

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

Renvoie les informations de compilation principales signalées via invocationStarted(com.android.tradefed.invoker.IInvocationContext). La compilation principale est la compilation renvoyée par le premier fournisseur de compilation de la configuration en cours d'exécution. Renvoie la valeur "null" s'il n'y a pas de contexte (pas de compilation pour le scénario de test).

Renvoie
`IBuildInfo`

getRunResults

public  getRunResults ()

Cette méthode est obsolète.
Utiliser getMergedTestRunResults()

Renvoie les résultats de toutes les exécutions de test.

Renvoie

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

Renvoyez TestRunResult pour une seule tentative.

Paramètres
`testRunName`	`String`: nom donné par {`testRunStarted(String, int)`.
`attempt`	`int`: ID de l'essai.

Renvoie
`TestRunResult`	`TestRunResult` pour le nom et l'ID de tentative donnés, ou `null` s'ils n'existent pas.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

Affiche le nombre de tentatives pour un nom d'exécution de test donné.

Paramètres
`testRunName`	`String`: nom donné par {`testRunStarted(String, int)`.

Renvoie
`int`

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

Récupère toutes les tentatives pour un TestRunResult d'une exécution de test donnée.

Paramètres
`testRunName`	`String`: nom donné par {`testRunStarted(String, int)`.

Renvoie
	Tous les `TestRunResult` d'une exécution de test donnée, triés par nombre de tentatives.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

Récupère tous les résultats d'une tentative donnée.

Paramètres
`attempt`	`int`: tentative pour laquelle nous souhaitons obtenir des résultats.

Renvoie
	Tous les `TestRunResult` pour une tentative donnée.

getTestRunNames

public  getTestRunNames ()

Renvoie tous les noms de toutes les exécutions de test.

Ces exécutions de test peuvent avoir été exécutées plusieurs fois avec différentes tentatives.

Renvoie

hasFailedTests

public boolean hasFailedTests ()

Indique si l'appel a généré des tests échoués ou des tests d'hypothèse échoués.

Renvoie
`boolean`

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

Indique si un nom d'exécution de test donné renvoie des résultats.

Paramètres
`testRunName`	`String`: nom donné par {`testRunStarted(String, int)`.

Renvoie
`boolean`

invocationEnded

public void invocationEnded (long elapsedTime)

Paramètres
`elapsedTime`	`long`

invocationFailed

public void invocationFailed (Throwable cause)

Paramètres
`cause`	`Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Paramètres
`context`	`IInvocationContext`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Paramètres
`dataName`	`String`
`logFile`	`LogFile`

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

Cette méthode est obsolète.
Plus nécessaire pour les tests.

Définit les informations de compilation. Ne doit être utilisé que pour les tests.

Paramètres
`buildInfo`	`IBuildInfo`

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

Définit l'MergeStrategy à utiliser lors de la fusion des résultats.

Paramètres
`strategy`	`MergeStrategy`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Paramètres
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Paramètres
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

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

Paramètres
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Paramètres
`test`	`TestDescription`
`testMetrics`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Paramètres
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public void testFailed (TestDescription test, 
                String trace)

Paramètres
`test`	`TestDescription`
`trace`	`String`

testIgnored

public void testIgnored (TestDescription test)

Paramètres
`test`	`TestDescription`

testModuleEnded

public void testModuleEnded ()

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Paramètres
`moduleContext`	`IInvocationContext`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Paramètres
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public void testRunFailed (FailureDescription failure)

Paramètres
`failure`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Paramètres
`errorMessage`	`String`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

Paramètres
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests)

Paramètres
`name`	`String`
`numTests`	`int`

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Paramètres
`name`	`String`
`numTests`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public void testRunStopped (long elapsedTime)

Paramètres
`elapsedTime`	`long`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Paramètres
`test`	`TestDescription`
`startTime`	`long`

testStarted

public void testStarted (TestDescription test)

Paramètres
`test`	`TestDescription`

Méthodes protégées

clearModuleLogFiles

protected final void clearModuleLogFiles ()

Permet de nettoyer le fichier du module afin d'éviter de le conserver trop longtemps.

clearResultsForName

protected final void clearResultsForName (String testRunName)

Permet d'effacer les résultats pour un nom d'exécution donné. À n'utiliser que dans certains cas, comme l'agrégateur de résultats.

Paramètres
`testRunName`	`String`

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

Activer/Désactiver l'option "Métriques agrégées"

Paramètres
`aggregate`	`boolean`