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.

EventsLoggerListener

public class EventsLoggerListener
extends Object implements ILogSaverListener

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

Listener, der alle empfangenen Ereignisse in einer Datei protokolliert

Zusammenfassung

Öffentliche Konstruktoren
`EventsLoggerListener(String name)`

Öffentliche Methoden
`File`	`getLoggedEvents()`
`void`	`invocationEnded(long elapsedTime)` Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
`void`	`invocationFailed(FailureDescription failure)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationSkipped(SkipReason reason)` Meldet einen Aufruf als übersprungen
`void`	`invocationStarted(IInvocationContext context)` Meldet den Beginn des Testaufrufs.
`void`	`logAssociation(String dataName, LogFile logFile)` In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`-Callback nicht.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternative zu `testEnded(TestDescription,Map)`, mit der wir die Endzeit direkt angeben können.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Meldet das Fehlschlagen 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`	`testModuleEnded()` Meldet das Ende einer Modulausführung.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Meldet den Beginn der Ausführung eines Moduls.
`void`	`testRunEnded(long elapsedTimeMillis, HashMap<String, MetricMeasurement.Metric> runMetrics)` Meldet das Ende des Testlaufs.
`void`	`testRunFailed(FailureDescription failure)` Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch `FailureDescription` beschrieben wird, nicht abgeschlossen werden.
`void`	`testRunFailed(String errorMessage)` Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStarted(String runName, int testCount)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Meldet den Beginn eines Testlaufs.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Wird aufgerufen, wenn ein Test übersprungen wurde und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird.
`void`	`testStarted(TestDescription test, long startTime)` Alternative zu `testStarted(TestDescription)`, bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit `testEnded(TestDescription,long,Map)` für eine genaue Messung.

Öffentliche Konstruktoren

EventsLoggerListener

public EventsLoggerListener (String name)

Parameter
`name`	`String`

Öffentliche Methoden

getLoggedEvents

public File getLoggedEvents ()

Gibt Folgendes zurück:
`File`

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 (FailureDescription failure)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`failure`	`FailureDescription`: die `FailureDescription`, in der die Ursache des Fehlers beschrieben wird

invocationSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
`reason`	`SkipReason`

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String,LogDataType,InputStreamSource,LogFile)-Callback nicht. Mit diesem Callback kann also explizit eine starke Zuordnung angegeben werden.

Parameter
`dataName`	`String`: Der Name der Daten
`logFile`	`LogFile`: Die `LogFile`, die zuvor protokolliert wurde und dem Testlauf zugeordnet werden soll.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Parameter
`test`	`TestDescription`: Gibt den Test an.
`failure`	`FailureDescription`: `FailureDescription`, in dem der Fehler und sein Kontext beschrieben werden.

testEnded

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

Alternative zu testEnded(TestDescription,Map), mit der wir die Endzeit direkt angeben können. Kombinieren Sie sie mit testStarted(TestDescription,long), um genaue Ergebnisse zu erhalten.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`endTime`	`long`: Die Uhrzeit, zu der der Test beendet wurde, gemessen über `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `Map` der ausgegebenen Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`failure`	`FailureDescription`: `FailureDescription`, in dem der Fehler und sein Kontext beschrieben werden.

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.

testModuleEnded

public void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn der Ausführung eines Moduls. Dieser Callback ist mit testModuleEnded() verknüpft und in der Sequenz optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: Suite-basierte Runner.

Parameter
`moduleContext`	`IInvocationContext`: Die `IInvocationContext` des Moduls.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                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
`elapsedTimeMillis`	`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 (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch FailureDescription beschrieben wird, nicht abgeschlossen werden.

Parameter
`failure`	`FailureDescription`: `FailureDescription`, in dem der Fehler und sein Kontext beschrieben 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, 
                int attemptNumber)

Meldet den Beginn eines Testlaufs.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.

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

testRunStarted

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

Meldet den Beginn eines Testlaufs.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Beispiel: Ein Test wird dreimal wiederholt. Er sollte insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.
`startTime`	`long`: Der Zeitpunkt, zu dem der Lauf begonnen hat, gemessen mit `System.currentTimeMillis()`

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen wurde und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird. Diese Tests werden wiederholt, um eine ordnungsgemäße Ausführung zu erreichen.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit testEnded(TestDescription,long,Map) für eine genaue Messung.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`startTime`	`long`: Die Uhrzeit, zu der der Test begonnen hat, gemessen über `System.currentTimeMillis()`