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.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Bekannte indirekte Unterklassen

AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector und 63 weitere.

AggregatePostProcessor	Ein Messwert-Aggregator, der das Minimum, Maximum, den Mittelwert, die Varianz, die Standardabweichung, die Summe, die Anzahl und optional die Perzentile für numerische Messwerte liefert, die bei Testläufen mit mehreren Iterationen erfasst werden und als Doubles behandelt werden.
AndroidBuildResultReporter	Meldet Testergebnisse an die Android Build API.
AtraceCollector	Ein `IMetricCollector`, das atrace während eines Tests ausführt, das Ergebnis erfasst und es im Aufruf protokolliert.
AtraceRunMetricCollector	Sammelt die Traces aus allen Testverzeichnissen unter dem angegebenen Verzeichnis vom Testgerät, protokolliert das Testverzeichnis und verarbeitet die Trace-Dateien im Testverzeichnis nach und fasst die Messwerte zusammen.
AveragePostProcessor	Implementierung des Postprozessors, der den Durchschnitt der Liste der Messwerte berechnet.
BaseDeviceMetricCollector	Die Basisimplementierung von `IMetricCollector` ermöglicht das Starten und Beenden der Erhebung auf `onTestRunStart(DeviceMetricData)` und `onTestRunEnd(DeviceMetricData,Map)`.
BasePostProcessor	Die Basis-`IPostProcessor`, die für jede Implementierung erweitert werden sollte.
BluetoothConnectionLatencyCollector	Der Collector überträgt eine vordefinierte statsd-Messwertkonfiguration für die Dauer an Geräte und erfasst die Dauer der Bluetooth-Verbindung für jedes Profil.
BluetoothConnectionStateCollector	Dieser Collector erfasst BluetoothConnectionStateChanged-Messwerte und zeichnet die Verbindungsstatusnummer für jedes Profil auf.
BluetoothConnectionSuccessRatePostProcessor	Implementierung eines Postprozessors, der die Erfolgsrate für ein Bluetooth-Profil berechnet Verwenden Sie „metric-key-match“, um Messwerte anzugeben, die Bluetooth-Verbindungsstatus in einem numerischen Array enthalten, z. B. [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Collector zum Aktivieren der Bluetooth-HCI-Snoop-Protokollierung auf dem DUT und zum Erfassen des Protokolls für jeden Test.
BugreportzOnFailureCollector	Erstellen Sie einen Fehlerbericht, wenn ein Testlauf fehlschlägt.
BugreportzOnTestCaseFailureCollector	Erstellen Sie einen bugreportz, wenn ein Testlauf fehlschlägt.
ClangCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Clang-Coverage-Messungen vom Gerät abruft und als Testartefakte protokolliert.
CodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Java- und native Abdeckungsmessungen vom Gerät abruft und als Testartefakte protokolliert.
CollectingTestListener	Eine `ITestInvocationListener`, in der alle Testergebnisse erfasst werden.
ConsoleResultReporter	Ergebnisreporter zum Ausgeben der Testergebnisse in der Konsole.
CountTestCasesCollector	Zählt und meldet die Anzahl der Testläufe für eine bestimmte `IRemoteTest`.
CoverageMetadataCollector	Ein `ILogSaverListener`, das protokollierte Messungen der Codeabdeckung erfasst und ein CoverageMetadataProto für die Verarbeitung durch den Android Code Coverage-Dienst generiert.
DebugHostLogOnFailureCollector	Collector, der die Host-seitigen Logs erfasst und protokolliert, wenn ein Testlauf fehlschlägt.
DeviceTraceCollector	Collector, der beim Start eines Testlaufs einen Perfetto-Trace startet und am Ende die Trace-Datei protokolliert.
EventsLoggerListener	Listener, der alle empfangenen Ereignisse in einer Datei protokolliert
FileProtoResultReporter	Proto-Reporter, der `TestRecord` in eine Datei schreibt.
FilePullerDeviceMetricCollector	Ein `BaseDeviceMetricCollector`, das auf den vom Gerät gesendeten Messwertschlüssel wartet und die Messwerte als Datei vom Gerät abruft.
FilePullerLogCollector	Logger der Datei, die von der Geräteseite gemeldet wird.
FormattedGeneratorReporter	Reporter, mit dem Berichte in einem bestimmten Format generiert werden können.
GcovCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das gcov-Abdeckungsdaten vom Gerät abruft und als Testartefakte protokolliert.
GcovKernelCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das gcov-Kernel-Abdeckungsdaten aus debugfs und vom Gerät abruft und sie schließlich als Testartefakte protokolliert.
GeminiDebuggingPostProcessor	Der Post-Prozessor erstellt Prompt-Anfragen zum Debuggen von Fehlern.
GranularRetriableTestWrapper.StartEndCollector	Klassenhelfer, um fehlende Start- und Endpunkte von Läufen zu erkennen.
HostStatsdMetricCollector	Ein `IMetricCollector`, das StatsD-Messwerte von der Hostseite mit StatsD-Dienstprogramm-Befehlen erfasst.
IMetricCollector	Diese Schnittstelle wird als Decorator hinzugefügt, wenn Testergebnisse gemeldet werden, um passende Messwerte zu erfassen.
IPostProcessor	Post-Prozessoren sind Trade Federation-Objekte, mit denen sich Messwerte und Logs NACH den Tests und VOR der Ergebnisberichterstellung verarbeiten lassen.
InvocationProtoResultReporter	Reporter zum Speichern von Informationen zum Caching auf Aufrufebene und der zugehörigen Modulliste
JavaCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Java-Abdeckungsdaten vom Gerät abruft und als Testartefakte protokolliert.
JsonHttpTestResultReporter	Ein Ergebnisreporter, der Testergebnisse und Informationen zu Zweig und Gerät in JSON codiert und an einen HTTP-Dienstendpunkt sendet
LUCIResultReporter	Ein Ergebnisreporter, der für ResultDB und LUCI erforderliche Testergebnisse im JSON-Format speichert (go/result-sink) und den Dateispeicherort in der Konsole protokolliert.
LegacySubprocessResultsReporter	Eine eingefrorene Implementierung des Unterprozess-Ergebnisberichts, die trotz Änderungen in der Basisklasse mit früheren Versionen von TF/CTS (z.B. 8+) kompatibel bleiben sollte.
LogSaverResultForwarder	Ein `ResultForwarder` zum Speichern von Logs mit dem globalen Dateispeichermodul.
LogcatOnFailureCollector	Collector, der einen Logcat erfasst und protokolliert, wenn ein Testlauf oder Testlauf fehlschlägt.
LogcatTimingMetricCollector	Ein Messwert-Collector, der Zeitinformationen (z. B. die Zeit für den Nutzerwechsel) aus Logcat während eines oder mehrerer wiederholter Tests erfasst. Dazu werden die Start- und Endsignale eines Ereignisses aus Logcat-Zeilen mit den angegebenen regulären Ausdrücken geparst.
MetricFilePostProcessor	Wird zum Hochladen der Messwert-Logdatei verwendet, die während des Tests und auf Ausführungsebene erfasst wurde.
MetricsXMLResultReporter	MetricsXMLResultReporter schreibt Testmesswerte und Laufzeitmesswerte in eine XML-Datei in einem Ordner, der durch den Parameter „metrics-folder“ in der Phase „invocationEnded“ des Tests angegeben wird.
ModuleListener	Listener, der an jedes `IRemoteTest` jedes Moduls angehängt ist, um die Liste der Ergebnisse zu erfassen.
ModuleLogcatCollector	Version des Logcat-Collectors, aber für das Modul.
ModulePerfettoCollector	Collector, der den Perfetto-Trace startet, wenn ein Testmodul beginnt und endet und das Gerät neu gestartet wird.
ModuleProtoResultReporter	Ein Ergebnisreporter, der nur Ergebnisse auf Modulebene meldet.
ModuleResultsAndMetricsForwarder	Eine Erweiterung von `ResultAndLogForwarder`, die den Testergebnissen zusätzliche modulbezogene Messwerte hinzufügt.
PerfettoFilePullerCollector	Ein Collector, der Perfetto-Tracedateien vom Gerät abruft, sie optional komprimiert und den Testlogs hinzufügt.
PerfettoGenericPostProcessor	Ein Post-Prozessor, der eine Perfetto-Proto-Datei mit Text-/Binärmesswerten in Schlüssel/Wert-Paare umwandelt, indem er die Proto-Nachrichten und -Felder mit Stringwerten rekursiv erweitert, bis das Feld mit dem numerischen Wert erreicht wird.
PerfettoPullerMetricCollector	Diese Klasse wurde eingestellt. Verwenden Sie stattdessen `PerfettoFilePullerCollector` und `ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	Ein Post-Prozessor, der Perfetto-Tracedateien aus den Testprotokollen abruft und den Trace-Prozessor darauf ausführt, um ein Perfetto-Messwert-Proto zu erstellen.
ProtoResultReporter	Der Ergebnisreporter erstellt einen `TestRecord`-Protobuf mit allen Ergebnissen.
RebootReasonCollector	Collector, der Geräte-Neustarts während des Testlaufs erfasst und nach Grund und Anzahl meldet.
RemoteTestTimeOutEnforcer	Listener, mit denen die Ausführungszeit einer bestimmten Testkonfiguration geprüft und der Test als fehlgeschlagen markiert werden kann, wenn ein bestimmtes Zeitlimit überschritten wird.
ReportPassedTests	Im Bericht in einer Datei können Filter angegeben werden, um bestandene Tests auszuschließen.
ResultAggregator	Spezieller Forwarder, der die Ergebnisse bei Bedarf basierend auf der verwendeten Wiederholungsstrategie zusammenfasst.
ResultAndLogForwarder	Forwarder für Ergebnisse und Log-Ereignisse.
ResultDBReporter	Ein Tool, das Testergebnisse in ResultDB hochlädt.
ResultReporter
RetryLogSaverResultForwarder	Forwarder, der auch den aktuellen Versuch weiterleitet.
RuntimeRestartCollector	Collector, der Zeitstempel von Laufzeitneustarts (Systemserverabstürzen) während des Testlaufs erfasst, sofern vorhanden.
ScreenRecordOnFailureCollector	Collector, der eine Bildschirmaufzeichnung aufzeichnet und protokolliert, wenn ein Testlauf fehlschlägt.
ScreenshotOnFailureCollector	Collector, der einen Screenshot aufnimmt und protokolliert, wenn ein Testlauf fehlschlägt.
ShardListener	Ein `ITestInvocationListener`, das Ergebnisse aus einem Aufruf-Shard (d. h. einem Aufruf, der parallel auf mehreren Ressourcen ausgeführt wird) erfasst und an einen anderen Listener weiterleitet.
ShardMainResultForwarder	Ein `ResultForwarder`, in dem die Ergebnisse von fragmentierten Testaufrufen zusammengefasst werden.
ShowmapPullerMetricCollector	Basisimplementierung von `FilePullerDeviceMetricCollector`, mit der die Showmap-Dateien vom Gerät abgerufen und die Messwerte daraus erfasst werden können.
SimpleperfProfilePostProcessor	Ein Postprozessor, der simpleperf-Profildaten findet und ein pprof-Profil generiert.
StatsdBeforeAfterGaugeMetricPostProcessor	Ein Post-Prozessor, der Messwerte für Messgeräte verarbeitet, die nach dem „Vorher/Nachher“-Ansatz erfasst wurden, d.h.
StatsdEventMetricPostProcessor	Ein Post-Prozessor, der Ereignismesswerte in statsd-Berichten mithilfe der im Prozessor angegebenen Formatierungen in Schlüssel/Wert-Paare umwandelt.
StatsdGenericPostProcessor	Ein Postprozessor, der binäre Proto-Statsd-Berichte in Schlüssel/Wert-Paare umwandelt, indem er den Bericht als Baumstruktur erweitert.
StreamProtoResultReporter	Eine Implementierung von `ProtoResultReporter`
SubprocessResultsReporter	Implementiert `ITestInvocationListener`, das als „result_reporter“ angegeben werden soll, und leitet die Ergebnisse von Tests, Testläufen und Testaufrufen vom untergeordneten Prozess weiter.
SuiteResultReporter	Testergebnisse für einen gesamten Suite-Aufruf erfassen und die endgültigen Ergebnisse ausgeben.
TextResultReporter	Ein Testresult-Reporter, der Ergebnisse an den JUnit-Textresult-Printer weiterleitet.
TraceCmdCollector	Eine `IMetricCollector`, die während des Tests mit trace-cmd Traces erfasst und sie im Aufruf protokolliert.
XmlFormattedGeneratorReporter	Implementierung von `FormattedGeneratorReporter`, die die Suite-Ergebnisse in einem XML-Format formatiert.
XmlResultReporter	Schreibt JUnit-Ergebnisse in XML-Dateien in einem Format, das mit dem XMLJUnitResultFormatter von Ant kompatibel ist.

Ermöglicht es ITestInvocationListener, darauf zu warten, dass Logdateien gespeichert werden.

So können mehrere ITestInvocationListeners dieselbe gespeicherte Protokolldatei verwenden, wenn Berichte generiert werden. Außerdem wird verhindert, dass jeder Listener die Datei einzeln speichert, wenn ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) aufgerufen wird.

Klassen, die diese Schnittstelle implementieren, sollten sich darüber im Klaren sein, dass testLogSaved(String,LogDataType,InputStreamSource,LogFile) immer dann aufgerufen wird, wenn ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) aufgerufen wird.

Diese Klasse übergibt auch die globale ILogSaver-Instanz, damit ITestInvocationListeners zusätzliche Dateien am selben Speicherort speichern können.

Zusammenfassung

Öffentliche Methoden
`default 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.
`default void`	`setLogSaver(ILogSaver logSaver)` Legen Sie `ILogSaver` fest, damit der Implementierer Dateien speichern kann.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

Öffentliche Methoden

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.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Legen Sie ILogSaver fest, damit der Implementierer Dateien speichern kann.

Parameter
`logSaver`	`ILogSaver`: Der `ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

Sollte anstelle von ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) verwendet werden.

Parameter
`dataName`	`String`: Ein `String` aussagekräftiger Name der Daten, z. B. „device_logcat“. Hinweis: dataName ist möglicherweise nicht eindeutig pro Aufruf. 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.
`logFile`	`LogFile`: das `LogFile` mit den Metadaten der gespeicherten Datei.