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.

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

Bekannte indirekte Unterklassen

AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector und 89 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.
BugreportCollector	Ein Pass-Through-`ITestInvocationListener`, das Fehlerberichte erfasst, wenn konfigurierbare Ereignisse auftreten, und dann `ITestInvocationListener.testLog` für seine untergeordneten Elemente aufruft, nachdem jeder Fehlerbericht erfasst wurde.
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.
CommandStatusHandler	Handler, mit dem der Status eines Aufrufs überwacht und aktualisiert werden kann.
ConditionFailureMonitor	Achten Sie auf Fehler bei der Ausführung.
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.
DeviceReleaseReporter	Gerätefreigabe-Reporter, der die Kommunikation mit dem übergeordneten Prozess für die freizugebenden Geräte übernimmt.
DeviceTraceCollector	Collector, der beim Start eines Testlaufs einen Perfetto-Trace startet und am Ende die Trace-Datei protokolliert.
DeviceUnavailableMonitor	Dieser Listener versucht, nur DNAE auf Testfall-Ebene zu erfassen.
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.
FilteredResultForwarder	Variante von `ResultForwarder`, bei der nur eine Zulassungsliste von `TestDescription` gemeldet werden kann.
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.
ICommandScheduler.IScheduledInvocationListener	Listener für Aufrufereignisse, wenn der Aufruf abgeschlossen ist.
ILogSaverListener	Ermöglicht es `ITestInvocationListener`, darauf zu warten, dass Logdateien gespeichert werden.
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.
IShardableListener	Eine `ITestInvocationListener`, die partitioniert werden kann.
ISupportGranularResults	Schnittstelle, die angibt, ob ein `ITestInvocationListener` detaillierte Ergebnisse empfangen kann.
ITestInvocationListener	Listener für Testergebnisse aus dem Testaufruf.
ITestSummaryListener	Schnittstelle, über die `ITestInvocationListener` einige begrenzte Informationen über Zusammenfassungen austauschen kann.
InvocationProtoResultReporter	Reporter zum Speichern von Informationen zum Caching auf Aufrufebene und der zugehörigen Modulliste
InvocationToJUnitResultForwarder	Eine Klasse, die auf `ITestInvocationListener`-Ereignisse wartet und sie an einen `TestListener` weiterleitet.
JarHostTest.HostTestListener	Wrapper-Listener, der alle Ereignisse mit Ausnahme von testRunStarted() und testRunEnded() an den eingebetteten Listener weiterleitet.
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.
LastShardDetector	Beim lokalen Sharding möchten wir manchmal nur dann bestimmte Aktionen ausführen, wenn der letzte Shard `invocationEnded(long)` erreicht.
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.
LogcatCrashResultForwarder	Spezifischer Listener: Bei Fehlern (Absturz des Instrumentierungsprozesses) wird versucht, den Absturz aus dem Logcat zu extrahieren und der Fehlermeldung hinzuzufügen, die mit dem Test verknüpft ist.
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.
NameMangleListener	Ein Proxy-Listener zum Übersetzen von Testmethoden-, Klassen- und Paketnamen, wenn Ergebnisse gemeldet werden.
PassingTestFileReporter	Eine `ITestInvocationListener`, die die Liste der bestandenen Testläufe in einer Testdatei speichert
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.
PrettyTestEventLogger	Logger, der die Ereignisse abgleicht und protokolliert, um das Debugging zu erleichtern.
ProtoResultReporter	Der Ergebnisreporter erstellt einen `TestRecord`-Protobuf mit allen Ergebnissen.
PtsBotTest	PTS-Bot-Tests ausführen
PythonBinaryHostTest.PythonForwarder	Ergebnis-Forwarder, um den Namen der Ausführung durch den Namen der Binärdatei zu ersetzen.
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.
ResultForwarder	Ein `ITestInvocationListener`, das Aufrufergebnisse an eine Liste anderer Listener weiterleitet.
ResultReporter
RetryLogSaverResultForwarder	Forwarder, der auch den aktuellen Versuch weiterleitet.
RetryResultForwarder	Eine Erweiterung von `ResultForwarder`, die immer auf eine bestimmte Versuchsnummer verweist.
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.
TestRunResultListener	Listener, mit dem der endgültige Status des Testlaufs gelesen werden kann.
TestTimeoutEnforcer	Listener, mit denen die Ausführungszeit eines bestimmten Testlaufs geprüft und der Testlauf als fehlgeschlagen markiert werden kann, wenn ein bestimmtes Zeitlimit überschritten wird.
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.
TradefedSandboxRunner.StubScheduledInvocationListener	Ein Stub `IScheduledInvocationListener`, der nichts tut.
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.

Eine Entität, die Datenstreams verschiedener Typen protokollieren kann.

Zusammenfassung

Öffentliche Methoden
`default void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.

Öffentliche Methoden

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.