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

ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.proto.ProtoResultReporter

Sous-classes directes connues

FileProtoResultReporter, StreamProtoResultReporter

FileProtoResultReporter	Rapporteur Proto qui transfère `TestRecord` dans un fichier.
StreamProtoResultReporter	Implémentation de `ProtoResultReporter`

L'outil de rapport des résultats crée un tampon de protocole TestRecord contenant tous les résultats. Doit être étendu pour gérer ce qu'il faut faire avec le prototype final dans processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord).

Résumé

Constructeurs publics
`ProtoResultReporter()`

Méthodes publiques
`final 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`	`invocationSkipped(SkipReason reason)` Signale un appel comme ignoré
`final void`	`invocationStarted(IInvocationContext context)` Indique le début de l'appel de test.
`final 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`	`processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)` Utilisez l'enregistrement d'appel pour envoyer un par un tous les journaux finaux de l'appel.
`void`	`processFinalProto(TestRecordProto.TestRecord finalRecord)` Gestion du prototype final avec tous les résultats.
`void`	`processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)` Gestion du protocole d'enregistrement de test d'appel partiel après `invocationStarted(com.android.tradefed.invoker.IInvocationContext)`.
`void`	`processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)` Gestion du protocole d'enregistrement du scénario de test finalisé après `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))`.
`void`	`processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)` Gestion du fichier proto d'enregistrement du scénario de test partiel après `testStarted(com.android.tradefed.result.TestDescription, long)`.
`void`	`processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)` Gestion du fichier proto finalisé de l'enregistrement du module après `testModuleEnded()`.
`void`	`processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)` Gestion du fichier proto d'enregistrement de module partiel après `testModuleStarted(com.android.tradefed.invoker.IInvocationContext)`.
`void`	`processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)` Gestion du protocole d'enregistrement d'exécution finalisé après `ERROR(/#testRunEnded(long,HashMap))` s'est produit.
`void`	`processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)` Gestion du fichier proto d'enregistrement d'exécution de test partielle après `testRunStarted(String, int)` s'est produit.
`void`	`setGranularResults(boolean granularResults)`
`void`	`setInlineRecordOfChildren(boolean inline)`
`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.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternative à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, où nous pouvons spécifier l'heure de fin directement.
`void`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution d'un scénario de test individuel.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Indique l'échec d'un scénario de test individuel.
`final void`	`testFailed(TestDescription test, String trace)` Indique l'échec d'un scénario de test individuel.
`final void`	`testIgnored(TestDescription test)` 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.
`final void`	`testModuleEnded()` Indique la fin d'une exécution de module.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Indique le début d'un module en cours d'exécution.
`final void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Signale la fin de l'exécution du test.
`final void`	`testRunFailed(FailureDescription failure)` Échec de l'exécution du test des rapports en raison d'un échec décrit par `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` É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.
`final 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.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue.
`final void`	`testStarted(TestDescription test, 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.
`final void`	`testStarted(TestDescription test)` Indique le début d'un scénario de test individuel.

Méthodes protégées
`TestRecordProto.ChildReference`	`createModuleChildReference(TestRecordProto.TestRecord record)` Crée une référence enfant pour un module.

Constructeurs publics

ProtoResultReporter

public ProtoResultReporter ()

Méthodes publiques

invocationEnded

public final 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 ignoré

public void invocationSkipped (SkipReason reason)

Signale un appel comme ignoré

Paramètres
`reason`	`SkipReason`

appel démarré

public final 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 final 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.

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Utilisez l'enregistrement d'appel pour envoyer un par un tous les journaux finaux de l'appel.

Paramètres
`invocationLogs`	`TestRecordProto.TestRecord`: protocole finalisé représentant l'appel.

processusFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Gestion du prototype final avec tous les résultats.

Paramètres
`finalRecord`	`TestRecordProto.TestRecord`: le protocole finalisé contenant tous les résultats d'appel.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Gestion du protocole d'enregistrement de test d'appel partiel après invocationStarted(com.android.tradefed.invoker.IInvocationContext).

Paramètres
`invocationStartRecord`	`TestRecordProto.TestRecord`: fichier proto partiel renseigné après invocationStart.
`invocationContext`	`IInvocationContext`: appel `IInvocationContext`.

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Gestion du protocole d'enregistrement du scénario de test finalisé après ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)).

Paramètres
`testCaseRecord`	`TestRecordProto.TestRecord`: protocole finalisé représentant un scénario de test.

processTestCase démarré

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Gestion du fichier proto d'enregistrement du scénario de test partiel après testStarted(com.android.tradefed.result.TestDescription, long).

Paramètres
`testCaseStartedRecord`	`TestRecordProto.TestRecord`: prototype partiel représentant le scénario de test.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Gestion du fichier proto finalisé de l'enregistrement du module après testModuleEnded().

Paramètres
`moduleRecord`	`TestRecordProto.TestRecord`: prototype finalisé représentant le module.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Gestion du fichier proto d'enregistrement de module partiel après testModuleStarted(com.android.tradefed.invoker.IInvocationContext).

Paramètres
`moduleStartRecord`	`TestRecordProto.TestRecord`: prototype partiel représentant le module.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Gestion du protocole d'enregistrement d'exécution finalisé après ERROR(/#testRunEnded(long,HashMap)) s'est produit.

Paramètres
`runRecord`	`TestRecordProto.TestRecord`: prototype final représentant l'exécution.
`moduleInProgress`	`boolean`: indique si un module est en cours ou non.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Gestion du fichier proto d'enregistrement d'exécution de test partielle après testRunStarted(String, int) s'est produit.

Paramètres
`runStartedRecord`	`TestRecordProto.TestRecord`: fichier proto partiel représentant l'exécution.

setGranularResults

public void setGranularResults (boolean granularResults)

Paramètres
`granularResults`	`boolean`

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Paramètres
`inline`	`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 final 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 défaillance

TestAssumptionFailure

public final 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.

Terminé

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

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

Terminé

public void testEnded (TestDescription test, 
                 testMetrics)

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

Échec du test

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Indique l'échec d'un scénario 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.

Échec du test

public final void testFailed (TestDescription test, 
                String trace)

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

Sera appelé entre testStarted et testEnded.

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

TestIgnoré

public final void testIgnored (TestDescription test)

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

TestModuleEnded

public final void testModuleEnded ()

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

Module de test démarré

public final 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 final void testRunEnded (long elapsedTimeMillis, 
                 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
`elapsedTimeMillis`	`long`: temps écoulé indiqué par l'appareil, en millisecondes
`runMetrics`	: paires clé/valeur signalées à la fin d'un test avec `Metric`.

TestRunFailed

public final 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 final void testRunFailed (String errorMessage)

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

Paramètres
`errorMessage`	`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 final 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()`

Test ignoré

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

Démarrage du test démarré

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

Démarrage du test démarré

public final 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.

Méthodes protégées

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Crée une référence enfant pour un module.

Paramètres
`record`	`TestRecordProto.TestRecord`

Renvoie
`TestRecordProto.ChildReference`