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

TestRunResult

public class TestRunResult
extends Object

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

Contient les résultats d'une seule exécution de test.

Maintient un nombre précis de tests et suit les tests incomplets.

Non thread-safe ! Les rappels test* doivent être appelés dans l'ordre

Résumé

Champs
`public static final String`	`ERROR_DIVIDER`

Constructeurs publics
`TestRunResult()` Créez un `TestRunResult` vide.

Méthodes publiques
	`getCompletedTests()` Récupère l'ensemble des tests terminés.
`long`	`getElapsedTime()` Renvoie la durée écoulée pour l'exécution en cours.
`int`	`getExpectedTestCount()` Récupère le nombre de scénarios de test attendus par cet objet TestRunResult.
	`getFailedTests()` Récupère l'ensemble des tests ayant échoué.
`String`	`getName()`
`int`	`getNumAllFailedTests()` Afficher le nombre total de tests en état d'échec (échec, échec d'hypothèse)
`int`	`getNumCompleteTests()` Récupère le nombre de tests terminés de cette exécution, c'est-à-dire avec un état != "incomplète".
`int`	`getNumTests()` Récupère le nombre de tests de cette exécution.
`int`	`getNumTestsInState(TestStatus status)` Récupère le nombre de tests dans un état donné pour cette exécution.
`int`	`getNumTestsInState(TestResult.TestStatus ddmlibStatus)` POUR LA Compatibilité avec l'état plus ancien.
	`getPassedTests()` Récupère l'ensemble des tests réussis.
`FailureDescription`	`getRunFailureDescription()` Renvoie le descripteur d'échec de l'exécution, `null` si l'exécution n'a pas échoué.
`String`	`getRunFailureMessage()` Renvoie le message d'erreur d'échec de l'exécution, `null`, si l'exécution n'a pas échoué.
`MultiMap<String, LogFile>`	`getRunLoggedFiles()` Renvoie une copie de la carte contenant tous les fichiers journalisés associés à ce cas de test.
	`getRunMetrics()`
	`getRunProtoMetrics()`
`long`	`getStartTime()` Renvoie l'heure de début du premier appel testRunStart.
	`getTestResults()` Renvoie une carte des résultats du test.
	`getTestsInState( statuses)` Récupère l'ensemble des tests dans les états donnés.
	`getTestsResultsInState(TestStatus status)` Renvoie tous les `TestResult` dans un état particulier.
`String`	`getTextSummary()` Renvoie une chaîne conviviale décrivant les résultats.
`boolean`	`hasFailedTests()`
`boolean`	`isRunComplete()`
`boolean`	`isRunFailure()`
`static TestRunResult`	`merge( testRunResults)`
`static TestRunResult`	`merge( testRunResults, MergeStrategy strategy)` Fusionnez plusieurs TestRunResults du même testRunName.
`void`	`resetRunFailure()` Réinitialisez l'état d'échec de l'exécution.
`void`	`setAggregateMetrics(boolean metricAggregation)`
`void`	`setRunComplete(boolean runComplete)`
`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`	`testLogSaved(String dataName, LogFile logFile)` Les informations sur un fichier journalisé sont stockées et associées au cas de test ou à l'exécution de test en cours.
`void`	`testRunEnded(long elapsedTime, runMetrics)`
`void`	`testRunFailed(FailureDescription failureDescription)`
`void`	`testRunFailed(String errorMessage)`
`void`	`testRunStarted(String runName, int testCount, long startTime)` Signaler le démarrage d'un cycle de test
`void`	`testRunStarted(String runName, int testCount)` Signaler le démarrage d'un cycle de test
`void`	`testRunStopped(long elapsedTime)`
`void`	`testSkipped(TestDescription test, SkipReason reason)`
`void`	`testStarted(TestDescription test, long startTime)`
`void`	`testStarted(TestDescription test)`

Champs

ERROR_DIVIDER

public static final String ERROR_DIVIDER

Constructeurs publics

TestRunResult

public TestRunResult ()

Créez un TestRunResult vide.

Méthodes publiques

getCompletedTests

public  getCompletedTests ()

Récupère l'ensemble des tests terminés.

Renvoie

getElapsedTime

public long getElapsedTime ()

Renvoie la durée écoulée pour l'exécution en cours.

Renvoie
`long`

getExpectedTestCount

public int getExpectedTestCount ()

Récupère le nombre de scénarios de test attendus par cet objet TestRunResult. Le nombre réel peut être inférieur au nombre attendu en raison de plantages de test. En règle générale, une telle incohérence indique un échec de l'exécution du test.

Renvoie
`int`

getFailedTests

public  getFailedTests ()

Récupère l'ensemble des tests ayant échoué.

Renvoie

getName

public String getName ()

Renvoie
`String`	le nom de l'exécution du test ;

getNumAllFailedTests

public int getNumAllFailedTests ()

Afficher le nombre total de tests en état d'échec (échec, échec d'hypothèse)

Renvoie
`int`

getNumCompleteTests

public int getNumCompleteTests ()

Récupère le nombre de tests terminés de cette exécution, c'est-à-dire avec un état != "incomplète".

Renvoie
`int`

getNumTests

public int getNumTests ()

Récupère le nombre de tests de cette exécution.

Renvoie
`int`

getNumTestsInState

public int getNumTestsInState (TestStatus status)

Récupère le nombre de tests dans un état donné pour cette exécution.

Paramètres
`status`	`TestStatus`

Renvoie
`int`

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

POUR LA Compatibilité avec l'état plus ancien. Utilisez getNumTestsInState(com.android.tradefed.result.TestStatus) à la place.

Paramètres
`ddmlibStatus`	`TestResult.TestStatus`

Renvoie
`int`

getPassedTests

public  getPassedTests ()

Récupère l'ensemble des tests réussis.

Renvoie

getRunFailureDescription

public FailureDescription getRunFailureDescription ()

Renvoie le descripteur d'échec de l'exécution, null si l'exécution n'a pas échoué.

Renvoie
`FailureDescription`

getRunFailureMessage

public String getRunFailureMessage ()

Renvoie le message d'erreur d'échec de l'exécution, null, si l'exécution n'a pas échoué.

Renvoie
`String`

getRunLoggedFiles

public MultiMap<String, LogFile> getRunLoggedFiles ()

Renvoie une copie de la carte contenant tous les fichiers journalisés associés à ce cas de test.

Renvoie
`MultiMap<String, LogFile>`

getRunMetrics

public  getRunMetrics ()

Renvoie
	une `ERROR(/Map)` des métriques d'exécution du test.

getRunProtoMetrics

public  getRunProtoMetrics ()

Renvoie
	une `ERROR(/Map)` des métriques d'exécution des tests avec le nouveau format de proto.

getStartTime

public long getStartTime ()

Renvoie l'heure de début du premier appel testRunStart.

Renvoie
`long`

getTestResults

public  getTestResults ()

Renvoie une carte des résultats du test.

Renvoie

getTestsInState

public  getTestsInState ( statuses)

Récupère l'ensemble des tests dans les états donnés.

Paramètres
`statuses`

Renvoie

getTestsResultsInState

public  getTestsResultsInState (TestStatus status)

Renvoie tous les TestResult dans un état particulier.

Paramètres
`status`	`TestStatus`

Renvoie

getTextSummary

public String getTextSummary ()

Renvoie une chaîne conviviale décrivant les résultats.

Renvoie
`String`

hasFailedTests

public boolean hasFailedTests ()

Renvoie
`boolean`	`true` si l'exécution du test a généré des échecs ou des erreurs.

isRunComplete

public boolean isRunComplete ()

Renvoie
`boolean`	`true` si l'exécution du test est terminée.

isRunFailure

public boolean isRunFailure ()

Renvoie
`boolean`	`true` si l'exécution du test a échoué.

fusionner

public static TestRunResult merge ( testRunResults)

Paramètres
`testRunResults`

Renvoie
`TestRunResult`

Voir aussi :

ERROR(/#merge(List, MergeStrategy))

fusionner

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

Fusionnez plusieurs TestRunResults du même testRunName. Si un test apparaît dans plusieurs TestRunResults, mais qu'il affiche des résultats différents (par exemple, "boottest-device" s'exécute trois fois avec le résultat FAIL-FAIL-PASS), nous concaténons toutes les traces de pile des exécutions FAILED et nous nous appuyons sur le résultat d'exécution final pour l'état, les métriques, les fichiers journaux, l'heure de début/fin.

Paramètres
`testRunResults`	: liste des TestRunResult à fusionner.
`strategy`	`MergeStrategy`: stratégie de fusion adoptée pour fusionner les résultats.

Renvoie
`TestRunResult`	le TestRunResult final contenant les données fusionnées des testRunResults.

resetRunFailure

public void resetRunFailure ()

Réinitialisez l'état d'échec de l'exécution.

Il est parfois nécessaire de réinitialiser l'état d'échec de l'exécution lors d'une nouvelle tentative. Cette opération doit être effectuée avec précaution pour éviter d'effacer une défaillance réelle.

setAggregateMetrics

public void setAggregateMetrics (boolean metricAggregation)

Paramètres
`metricAggregation`	`boolean`

setRunComplete

public void setRunComplete (boolean runComplete)

Paramètres
`runComplete`	`boolean`

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`

testLogSaved

public void testLogSaved (String dataName, 
                LogFile logFile)

Les informations sur un fichier journalisé sont stockées et associées au cas de test ou à l'exécution de test en cours.

Paramètres
`dataName`	`String`: nom faisant référence aux données.
`logFile`	`LogFile`: objet `LogFile` représentant l'emplacement de l'objet et des informations à son sujet.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

testRunFailed

public void testRunFailed (FailureDescription failureDescription)

Paramètres
`failureDescription`	`FailureDescription`

testRunFailed

public void testRunFailed (String errorMessage)

Paramètres
`errorMessage`	`String`

testRunStarted

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

Signaler le démarrage d'un cycle de test

Paramètres
`runName`	`String`: nom associé à l'exécution du test à des fins de suivi.
`testCount`	`int`: nombre de scénarios de test attendus associés à l'exécution du test.
`startTime`	`long`

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Signaler le démarrage d'un cycle de test

Paramètres
`runName`	`String`: nom associé à l'exécution du test à des fins de suivi.
`testCount`	`int`: nombre de scénarios de test attendus associés à l'exécution du test.

testRunStopped

public void testRunStopped (long elapsedTime)

Paramètres
`elapsedTime`	`long`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Paramètres
`test`	`TestDescription`
`reason`	`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

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

testStarted

public void testStarted (TestDescription test)

Paramètres
`test`	`TestDescription`