Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

Ein Proxy-Listener zum Übersetzen von Testmethoden-, Klassen- und Paketnamen, wenn Ergebnisse gemeldet werden.

Zusammenfassung

Öffentliche Konstruktoren
`NameMangleListener(ITestInvocationListener listener)`

Öffentliche Methoden
`TestSummary`	`getSummary()` Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.
`void`	`invocationEnded(long elapsedTime)` Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
`void`	`invocationFailed(Throwable cause)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationStarted(IInvocationContext context)` Meldet den Beginn des Testaufrufs.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Meldet das Ende der Ausführung eines einzelnen Testlaufs.
`void`	`testFailed(TestDescription test, String trace)` Meldet das Fehlschlagen eines einzelnen Testlaufs.
`void`	`testIgnored(TestDescription test)` Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Meldet das Ende des Testlaufs.
`void`	`testRunFailed(String errorMessage)` Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
`void`	`testRunStarted(String runName, int testCount)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStopped(long elapsedTime)` Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.
`void`	`testStarted(TestDescription test)` Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden
`TestDescription`	`mangleTestId(TestDescription test)` Diese Methode wird für alle `TestDescription` ausgeführt, die an die Rückrufe `testStarted(TestDescription)`, `testFailed(TestDescription,String)` und `testEnded(TestDescription,HashMap)` übergeben werden.
`String`	`mangleTestRunName(String name)` Diese Methode wird für alle Testlaufnamen ausgeführt, die an den `testRunStarted(String,int)`-Callback übergeben werden.

Öffentliche Konstruktoren

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

Parameter
`listener`	`ITestInvocationListener`

Öffentliche Methoden

getSummary

public TestSummary getSummary ()

Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.

Gibt Folgendes zurück:
`TestSummary`	Eine `TestSummary`, die den Lauf zusammenfasst, oder „null“

invocationEnded

public void invocationEnded (long elapsedTime)

Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`elapsedTime`	`long`: die verstrichene Zeit des Aufrufs in Millisekunden

invocationFailed

public void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`cause`	`Throwable`: die `Throwable`-Ursache des Fehlers

invocationStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, um die Berichterstellung für mehrere Geräte zu unterstützen.

Parameter
`context`	`IInvocationContext`: Informationen zum Aufruf

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`trace`	`String`: Stacktrace des Fehlers

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Messwerte zurück, die während der Ausführung des Testlaufs ausgegeben wurden.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`testMetrics`	`HashMap`: `Map` der ausgegebenen Messwerte

testFailed

public void testFailed (TestDescription test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`trace`	`String`: Stacktrace des Fehlers

testIgnored

public void testIgnored (TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.

Parameter
`test`	`TestDescription`: Gibt den Test an.

testLog

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

Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.

Muss vor ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Log und gegebenenfalls das Geräte-Logcat bereit.

Parameter
`dataName`	`String`: Ein `String` aussagekräftiger Name der Daten, z. B. „device_logcat“. Hinweis: dataName ist möglicherweise nicht pro Aufruf eindeutig. Implementierer müssen also mehrere Aufrufe mit demselben dataName verarbeiten können.
`dataType`	`LogDataType`: die `LogDataType` der Daten
`dataStream`	`InputStreamSource`: die `InputStreamSource` der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream schließen, wenn sie fertig sind. Anrufer sollten dafür sorgen, dass die Datenquelle bis zum Abschluss der Methode „testLog“ vorhanden und zugänglich bleibt.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichen Typen haben, daher müssen wir hier HashMap verwenden.

Parameter
`elapsedTime`	`long`: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
`runMetrics`	`HashMap`: Schlüssel/Wert-Paare, die am Ende eines Testlaufs mit `Metric` gemeldet werden.

testRunFailed

public void testRunFailed (String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
`errorMessage`	`String`: `String`, in dem der Grund für den Fehler bei der Ausführung beschrieben wird.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Beginn eines Testlaufs.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.

testStarted

public void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(TestDescription).

Parameter
`test`	`TestDescription`: Gibt den Test an.

Geschützte Methoden

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

Diese Methode wird für alle TestDescription ausgeführt, die an die Rückrufe testStarted(TestDescription), testFailed(TestDescription,String) und testEnded(TestDescription,HashMap) übergeben werden. Die Methode sollte ein möglicherweise anderes TestDescription zurückgeben, das an das Downstream-ITestInvocationListener übergeben wird, das bei der Erstellung angegeben wurde.

Bei der Implementierung sollte darauf geachtet werden, dass das ursprüngliche TestDescription nicht geändert wird.

Bei der Standardimplementierung wird die eingehende Kennung unverändert weitergegeben.

Parameter
`test`	`TestDescription`

Gibt Folgendes zurück:
`TestDescription`

mangleTestRunName

protected String mangleTestRunName (String name)

Diese Methode wird für alle Testlaufnamen ausgeführt, die an den testRunStarted(String,int)-Callback übergeben werden. Die Methode sollte einen möglicherweise anderen Testlaufnamen zurückgeben, der an den Downstream-ITestInvocationListener übergeben wird, der bei der Erstellung angegeben wurde.

Bei der Implementierung sollte darauf geachtet werden, dass der ursprüngliche Ausführungsname nicht geändert wird.

Bei der Standardimplementierung wird der eingehende Testlaufname unverändert weitergegeben.

Parameter
`name`	`String`

Gibt zurück
`String`