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

SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Sous-classes directes connues

LegacySubprocessResultsReporter

LegacySubprocessResultsReporter Une implémentation figée du rapporteur de résultats du sous-processus qui devrait rester compatible avec versions antérieures de TF/CTS (par exemple, 8+), malgré les modifications apportées à sa super-classe.

Implémente ITestInvocationListener à spécifier en tant que result_reporter et un transfert à partir de les résultats des tests, les exécutions et les appels de test.

Résumé

Constructeurs publics
`SubprocessResultsReporter()`

Méthodes publiques
`void`	`close()`
`TestSummary`	`getSummary()` Permet à l'écouteur InvocationListener de renvoyer un résumé.
`void`	`invocationEnded(long elapsedTime)` Indique que l'appel s'est arrêté, que ce soit avec succès ou en raison d'une erreur .
`void`	`invocationFailed(FailureDescription failure)` Signale un appel incomplet en raison d'une condition d'erreur.
`void`	`invocationFailed(Throwable cause)` Signale un appel incomplet en raison d'une condition d'erreur.
`void`	`invocationStarted(IInvocationContext context)` Indique le début de l'appel de test.
`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`	`printEvent(String key, Object event)` Outil d'aide permettant d'afficher la clé d'événement, puis l'objet JSON.
`void`	`setOutputTestLog(boolean outputTestLog)` Détermine si le test doit être enregistré ou non.
`boolean`	`supportGranularResults()` Affiche la valeur "True" si l'auteur de l'information accepte des résultats précis, et la valeur "false" dans le cas contraire.
`void`	`testAssumptionFailure(TestDescription testId, String trace)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`void`	`testAssumptionFailure(TestDescription testId, FailureDescription failure)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`void`	`testEnded(TestDescription testId, long endTime, metrics)` Alternative à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, où nous pouvons spécifier l'heure de fin directement.
`void`	`testEnded(TestDescription testId, metrics)` Indique la fin de l'exécution d'un scénario de test individuel.
`void`	`testFailed(TestDescription testId, FailureDescription failure)` Indique l'échec d'un scénario de test individuel.
`void`	`testFailed(TestDescription testId, String reason)` Indique l'échec d'un scénario de test individuel.
`void`	`testIgnored(TestDescription testId)` 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)` Fournit les données de journal ou de débogage associées à l'appel de test.
`void`	`testModuleEnded()` Indique la fin d'une exécution de module.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Indique le début d'un module en cours d'exécution.
`void`	`testRunEnded(long time, 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 reason)` Échec de l'exécution du test des rapports en raison d'une erreur fatale.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Indique le début d'une exécution de test.
`void`	`testRunStarted(String runName, int testCount)` Indique le début d'une exécution de test.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Indique le début d'une exécution de test.
`void`	`testRunStopped(long arg0)` L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur.
`void`	`testSkipped(TestDescription testId, SkipReason reason)` Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue.
`void`	`testStarted(TestDescription testId, 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.
`void`	`testStarted(TestDescription testId)` Indique le début d'un scénario de test individuel.

Constructeurs publics

SubprocessResultsReporter

public SubprocessResultsReporter ()

Méthodes publiques

fermer

public void close ()

getSummary

public TestSummary getSummary ()

Permet à l'écouteur InvocationListener de renvoyer un résumé.

Renvoie
`TestSummary`	Valeur `TestSummary` résumant l'exécution, ou valeur nulle

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel s'est arrêté, que ce soit avec succès ou en raison d'une erreur .

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
`elapsedTime`	`long`: temps écoulé de l'appel en ms

échec de l'appel

public void invocationFailed (FailureDescription failure)

Signale un appel incomplet en raison d'une condition d'erreur.

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
`failure`	`FailureDescription`: le `FailureDescription` décrivant la cause de l'échec

échec de l'appel

public void invocationFailed (Throwable cause)

Signale un appel incomplet en raison d'une condition d'erreur.

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
`cause`	`Throwable`: cause de l'échec (`Throwable`)

appel démarré

public void invocationStarted (IInvocationContext context)

Indique le début de l'appel de test.

Sera automatiquement appelée par le framework TradeFederation. Les auteurs de rapports doivent ignorer pour créer des rapports sur plusieurs appareils.

Paramètres
`context`	`IInvocationContext`: informations sur l'appel

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.

printEvent

public void printEvent (String key, 
                Object event)

Outil d'aide permettant d'afficher la clé d'événement, puis l'objet JSON.

Paramètres
`key`	`String`
`event`	`Object`

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Détermine si le test doit être enregistré ou non.

Paramètres
`outputTestLog`	`boolean`

assistanceRésultatsGranular

public boolean supportGranularResults ()

Affiche la valeur "True" si l'auteur de l'information accepte des résultats précis, et la valeur "false" dans le cas contraire.

Renvoie
`boolean`

TestAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

Paramètres
`testId`	`TestDescription`: identifie le test.
`trace`	`String`: trace de la pile de défaillance

TestAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

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

Terminé

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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
`testId`	`TestDescription`: identifie le test.
`endTime`	`long`: heure de fin du test, mesurée via `System.currentTimeMillis()`
`metrics`	: `ERROR(/Map)` des métriques émises

Terminé

public void testEnded (TestDescription testId, 
                 metrics)

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
`testId`	`TestDescription`: identifie le test.
`metrics`	: `ERROR(/Map)` des métriques émises

Échec du test

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Indique l'échec d'un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

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

Échec du test

public void testFailed (TestDescription testId, 
                String reason)

Indique l'échec d'un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
`testId`	`TestDescription`: identifie le test.
`reason`	`String`: trace de la pile de défaillance

TestIgnoré

public void testIgnored (TestDescription testId)

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
`testId`	`TestDescription`: identifie le test.

JournalTest

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

Fournit les données de journal ou de débogage associées à l'appel de test.

Doit être appelé avant ERROR(/ITestInvocationListener#invocationFailed(Throwable)) ou ERROR(/ITestInvocationListener#invocationEnded(long))

Le framework Tradefédération appelle automatiquement cette méthode et fournit le journal de l'hôte. et, le cas échéant, le fichier logcat de l'appareil.

Paramètres
`dataName`	`String`: nom descriptif `String` des données. Ex. : "device_logcat". Remarque Le champ dataName ne peut pas être unique par appel. Autrement dit, les responsables de la mise en œuvre doivent plusieurs appels avec le même dataName
`dataType`	`LogDataType`: `LogDataType` des données
`dataStream`	`InputStreamSource`: `InputStreamSource` des données. Les responsables de la mise en œuvre doivent appeler createInputStream pour commencer à lire les données, et veillez à fermer le résultat InputStream une fois l'opération terminée. Les appelants doivent s'assurer que la source des données est conservée et accessibles jusqu'à la fin de la méthode testLog.

TestModuleEnded

public void testModuleEnded ()

Indique la fin d'une exécution de module.

Module de test démarré

public void testModuleStarted (IInvocationContext moduleContext)

Indique le début d'un module en cours d'exécution. Ce rappel est associé à testModuleEnded() et est facultatif dans la séquence. Il n'est utilisé que lors d'une exécution qui utilise modules: exécuteurs basés sur une suite.

Paramètres
`moduleContext`	`IInvocationContext`: `IInvocationContext` du module.

TestRunEnded

public void testRunEnded (long time, 
                 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
`time`	`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 reason)

Échec de l'exécution du test des rapports en raison d'une erreur fatale.

Paramètres
`reason`	`String`: `String` décrivant la raison de l'échec de l'exécution.

Exécution du test démarrée

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

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

Paramètres
`runName`	`String`: nom de l'exécution du test
`testCount`	`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 runName, 
                int testCount)

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

Paramètres
`runName`	`String`: nom de l'exécution du test
`testCount`	`int`: nombre total de tests en cours d'exécution

Exécution du test démarrée

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

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

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

Exécution de test arrêtée

public void testRunStopped (long arg0)

L'exécution des tests des rapports a été interrompue en raison d'une demande de l'utilisateur.

À FAIRE: actuellement non utilisé, pensez à le supprimer

Paramètres
`arg0`	`long`: temps écoulé indiqué par l'appareil, en millisecondes

Test ignoré

public void testSkipped (TestDescription testId, 
                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
`testId`	`TestDescription`: identifie le test.
`reason`	`SkipReason` : `SkipReason`

Démarrage du test démarré

public void testStarted (TestDescription testId, 
                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
`testId`	`TestDescription`: identifie le test.
`startTime`	`long`: heure de début du test, mesurée via `System.currentTimeMillis()`

Démarrage du test démarré

public void testStarted (TestDescription testId)

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
`testId`	`TestDescription`: identifie le test.