À 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.

ModuleResultsAndMetricsForwarder

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.ResultAndLogForwarder
		↳	com.android.tradefed.result.ModuleResultsAndMetricsForwarder

Extension de ResultAndLogForwarder qui ajoute des métriques supplémentaires liées au module aux résultats du test.

Résumé

Constructeurs publics
`ModuleResultsAndMetricsForwarder(ITestInvocationListener... listeners)`

Méthodes publiques
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` Indique si la tentative doit être signalée comme isolée ou non.
`void`	`setMarkTestsSkipped(boolean skip)` Indique s'il faut marquer tous les scénarios de test comme ignorés.
`void`	`setModuleId(String moduleId)`
`void`	`setTestMappingSources( testMappingSources)` Définit les sources de mappage des tests qui seront insérées dans les métriques.
`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)` Signalement de l'échec d'un cas de test individuel.
`void`	`testFailed(TestDescription test, String trace)` Signale l'échec d'un cas de test individuel.
`void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Rapports de fin de série de tests.
`void`	`testRunFailed(FailureDescription failure)` L'exécution du test des rapports n'a pas pu être effectuée en raison d'un échec décrit par `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Indique le début d'une série de tests.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Indique le début d'une série de tests.
`void`	`testStarted(TestDescription test, long startTime)` Alternative à `testStarted(com.android.tradefed.result.TestDescription)` où nous spécifions également la date de début du test, combinée à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` pour une mesure précise.
`void`	`testStarted(TestDescription test)` Indique le début d'un scénario de test individuel.

Constructeurs publics

ModuleResultsAndMetricsForwarder

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

Paramètres
`listeners`	`ITestInvocationListener`

Méthodes publiques

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`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

Indique s'il faut marquer tous les scénarios de test comme ignorés.

Paramètres
`skip`	`boolean`

setModuleId

public void setModuleId (String moduleId)

Paramètres
`moduleId`	`String`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

Paramètres
`testMappingSources`

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 avec testStarted(com.android.tradefed.result.TestDescription, long) pour obtenir une mesure précise.

Paramètres
`test`	`TestDescription` : identifie le test
`endTime`	`long` : heure à laquelle le test s'est terminé, 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 a 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)

Signalement de l'échec d'un cas 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.

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

Sera appelé entre testStarted et testEnded.

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Rapports de fin de série de tests.

Paramètres
`elapsedTimeMillis`	`long` : temps écoulé indiqué par l'appareil, en millisecondes
`runMetrics`	: paires clé/valeur signalées à la fin d'une série de tests

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports n'a pas pu être effectuée 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 n'a pas pu être effectuée 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 runName, 
                int testCount, 
                int attemptNumber)

Indique le début d'une série de tests.

Paramètres
`runName`	`String` : nom de l'exécution du test
`testCount`	`int` : nombre total de tests dans l'exécution du test
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName qui sont exécutées plusieurs fois. attemptNumber est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière précise trois fois, il doit comporter quatre exécutions au total sous le même runName, et attemptNumber doit être compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Indique le début d'une série de tests.

Paramètres
`runName`	`String` : nom de l'exécution du test
`testCount`	`int` : nombre total de tests dans l'exécution du test
`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 de tentative est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière granulaire trois fois, il doit comporter quatre exécutions au total sous le même runName, et le numéro de tentative est compris entre 0 et 3.
`startTime`	`long` : heure de début de l'exécution, mesurée avec `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription) où nous spécifions également la date de début du test, combinée à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Paramètres
`test`	`TestDescription` : identifie le test
`startTime`	`long` : heure à laquelle le test a commencé, mesurée via `System.currentTimeMillis()`

testStarted

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