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

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Un écouteur proxy pour traduire les noms de méthode, de classe et de package de test lorsque les résultats sont signalés.

Résumé

Constructeurs publics
`NameMangleListener(ITestInvocationListener listener)`

Méthodes publiques
`TestSummary`	`getSummary()` Permet à InvocationListener de renvoyer un récapitulatif.
`void`	`invocationEnded(long elapsedTime)` Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.
`void`	`invocationFailed(Throwable cause)` Signale une invocation incomplète en raison d'une condition d'erreur.
`void`	`invocationStarted(IInvocationContext context)` Indique le début de l'appel du test.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
`void`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution d'un cas de test individuel.
`void`	`testFailed(TestDescription test, String trace)` Signale l'échec d'un cas de test individuel.
`void`	`testIgnored(TestDescription test)` Appelé lorsqu'un test ne sera 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`	`testRunEnded(long elapsedTime, runMetrics)` Signale la fin de l'exécution du test.
`void`	`testRunFailed(String errorMessage)` L'exécution du test des rapports a échoué en raison d'une erreur fatale.
`void`	`testRunStarted(String runName, int testCount)` Indique le début d'une exécution de test.
`void`	`testRunStopped(long elapsedTime)` L'exécution du test des rapports s'est arrêtée avant la fin en raison d'une requête de l'utilisateur.
`void`	`testStarted(TestDescription test)` Indique le début d'un scénario de test individuel.

Méthodes protégées
`TestDescription`	`mangleTestId(TestDescription test)` Cette méthode est exécutée sur tous les `TestDescription` transmis aux rappels `testStarted(com.android.tradefed.result.TestDescription)`, `testFailed(com.android.tradefed.result.TestDescription, String)` et `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))`.
`String`	`mangleTestRunName(String name)` Cette méthode est exécutée sur tous les noms d'exécution de test transmis au rappel `testRunStarted(String, int)`.

Constructeurs publics

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Paramètres
`listener`	`ITestInvocationListener`

Méthodes publiques

getSummary

public TestSummary getSummary ()

Permet à InvocationListener de renvoyer un récapitulatif.

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

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

Signale une invocation incomplète en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

Appelé automatiquement par le framework TradeFederation. Les rapporteurs doivent remplacer cette méthode pour prendre en charge les rapports sur plusieurs appareils.

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

testAssumptionFailure

public 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 l'échec

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 est 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, 
                String trace)

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

Appelé entre testStarted et testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

Appelé lorsqu'un test ne sera 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

testLog

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 TradeFederation appelle automatiquement cette méthode, en fournissant le journal de l'hôte et, le cas échéant, le logcat de l'appareil.

Paramètres
`dataName`	`String`: nom descriptif `String` des données (par exemple, "device_logcat"). Remarque : Le nom de données ne doit pas nécessairement être unique par appel. Autrement dit, les implémentateurs doivent pouvoir gérer plusieurs appels avec le même nom de données.
`dataType`	`LogDataType`: `LogDataType` des données
`dataStream`	`InputStreamSource`: `InputStreamSource` des données. Les implémentateurs doivent appeler createInputStream pour commencer à lire les données et s'assurer de fermer l'InputStream généré une fois la lecture terminée. Les appelants doivent s'assurer que la source des données reste présente et accessible jusqu'à la fin de la méthode testLog.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Signale la fin de l'exécution du test.

Paramètres
`elapsedTime`	`long`: durée écoulée, en millisecondes, indiquée par l'appareil
`runMetrics`	: paires clé-valeur signalées à la fin d'une exécution de test

testRunFailed

public void testRunFailed (String errorMessage)

L'exécution du test des rapports a échoué 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)

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 dans l'exécution du test

testRunStopped

public void testRunStopped (long elapsedTime)

L'exécution du test des rapports s'est arrêtée avant la fin en raison d'une requête de l'utilisateur.

À FAIRE: actuellement inutilisé, envisagez de le supprimer

Paramètres
`elapsedTime`	`long`: durée écoulée, en millisecondes, indiquée par l'appareil

testStarted

public void testStarted (TestDescription test)

Indique le début d'un scénario de test individuel. Interface plus ancienne. Utilisez testStarted(com.android.tradefed.result.TestDescription) dans la mesure du possible.

Paramètres
`test`	`TestDescription`: identifie le test

Méthodes protégées

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Cette méthode est exécutée sur tous les TestDescription transmis aux rappels testStarted(com.android.tradefed.result.TestDescription), testFailed(com.android.tradefed.result.TestDescription, String) et ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)). La méthode doit renvoyer un TestDescription éventuellement différent qui sera transmis au ITestInvocationListener en aval spécifié lors de la création.

L'implémentation doit veiller à ne pas modifier l'TestDescription d'origine.

L'implémentation par défaut transmet l'identifiant entrant sans le modifier.

Paramètres
`test`	`TestDescription`

Renvoie
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Cette méthode est exécutée sur tous les noms d'exécution de test transmis au rappel testRunStarted(String, int). La méthode doit renvoyer un nom d'exécution de test qui peut être différent et qui sera transmis à l'ITestInvocationListener en aval spécifié lors de la création.

L'implémentation doit veiller à ne pas modifier le nom d'exécution d'origine.

L'implémentation par défaut transmet le nom de l'exécution de test entrante sans modification.

Paramètres
`name`	`String`

Renvoie
`String`