Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Bekannte indirekte Unterklassen

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector und 14 weitere.

AtraceCollector	Eine `IMetricCollector`, die während eines Tests „atrace“ 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 aggregiert die Messwerte.
BaseDeviceMetricCollector	Die Basisimplementierung von `IMetricCollector` ermöglicht das Starten und Beenden der Erhebung auf `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` und `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
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.
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.
CountTestCasesCollector	Zählen und melden Sie die Anzahl der Testläufe für ein bestimmtes `IRemoteTest`.
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 die Trace-Datei am Ende protokolliert.
FilePullerDeviceMetricCollector	Ein `BaseDeviceMetricCollector`, das auf den Messwertschlüssel vom Gerät wartet und ihn als Datei vom Gerät abruft.
FilePullerLogCollector	Logger der vom Gerät gemeldeten Datei.
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 dann als Testartefakte protokolliert.
HostStatsdMetricCollector	Ein `IMetricCollector`, das StatsD-Messwerte von der Hostseite mit StatsD-Dienstprogramm-Befehlen erfasst.
JavaCodeCoverageCollector	Ein `BaseDeviceMetricCollector`, das Java-Abdeckungsdaten vom Gerät abruft und als Testartefakte protokolliert.
LogcatOnFailureCollector	Collector, der ein Logcat erfasst und protokolliert, wenn ein 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.
ModuleLogcatCollector	Version des Logcat-Collectors, aber für das Modul.
PerfettoFilePullerCollector	Ein Collector, der Perfetto-Tracedateien vom Gerät abruft, sie optional komprimiert und den Testlogs hinzufügt.
PerfettoPullerMetricCollector	Diese Klasse wurde eingestellt. Verwenden Sie stattdessen `PerfettoFilePullerCollector` und `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Collector, der Geräte-Neustarts während des Testlaufs erfasst und nach Grund und Anzahl meldet.
RuntimeRestartCollector	Collector, der Zeitstempel von Laufzeitneustarts (Systemserverabstürzen) während des Testlaufs erfasst, sofern vorhanden.
ScreenshotOnFailureCollector	Collector, der einen Screenshot aufnimmt und protokolliert, wenn ein Testlauf fehlschlägt.
ShowmapPullerMetricCollector	Basisimplementierung von `FilePullerDeviceMetricCollector`, mit der die Showmap-Dateien vom Gerät abgerufen und die Messwerte daraus erfasst werden können.
TraceCmdCollector	Eine `IMetricCollector`, die während des Tests mit trace-cmd Traces erfasst und sie im Aufruf protokolliert.

Diese Schnittstelle wird als Decorator hinzugefügt, wenn Testergebnisse gemeldet werden, um passende Messwerte zu erfassen.

Diese Schnittstelle kann nicht als verwendet werden, auch wenn sie ITestInvocationListener erweitert. Die Konfigurationsprüfung lehnt sie ab. Sie muss als „metrics_collector“ verwendet werden.

Von Collectors wird nicht erwartet, dass sie einen internen Status beibehalten, da sie an mehreren Stellen wiederverwendet werden können. Wenn ein interner Status wirklich verwendet werden muss, sollte er bei init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) bereinigt werden.

Zusammenfassung

Öffentliche Methoden
`default boolean`	`captureModuleLevel()` Gibt an, ob der Collector für die Erfassung auf Modulebene geeignet ist und initialisiert werden sollte.
`abstract`	`getBuildInfos()` Gibt die Liste der Build-Informationen zurück, die im Aufruf verfügbar sind.
`abstract`	`getDevices()` Gibt die Liste der in der Anfrage verfügbaren Geräte zurück.
`abstract ITestInvocationListener`	`getInvocationListener()` Gibt die ursprüngliche `ITestInvocationListener` zurück, an die die Ergebnisse weitergeleitet werden.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisierung des Collectors mit dem aktuellen Kontext und Angabe des Ziels für die Weiterleitung der Ergebnisse.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf aufgrund eines Annahmefehlers fehlschlägt.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf fehlschlägt.
`default void`	`onTestModuleEnded()` Ermöglicht das Erfassen des Ereignisses „Modul beendet“.
`default void`	`onTestModuleStarted()` Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback, wenn ein Testlauf gestartet wird.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Callback, wenn ein Testlauf gestartet wird.
`abstract void`	`onTestStart(DeviceMetricData testData)` Callback, wenn ein Testlauf gestartet wird.

Öffentliche Methoden

captureModuleLevel

public boolean captureModuleLevel ()

Gibt an, ob der Collector für die Erfassung auf Modulebene geeignet ist und initialisiert werden sollte.

Returns
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Gibt die Liste der Build-Informationen zurück, die im Aufruf verfügbar sind.

Returns

getDevices

public abstract  getDevices ()

Gibt die Liste der in der Anfrage verfügbaren Geräte zurück.

Returns

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Gibt die ursprüngliche ITestInvocationListener zurück, an die die Ergebnisse weitergeleitet werden.

Returns
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialisierung des Collectors mit dem aktuellen Kontext und Angabe des Ziels für die Weiterleitung der Ergebnisse. Wird nur einmal pro Instanz aufgerufen. Der Collector muss seinen internen Kontext und Listener aktualisieren. „Init“ wird während eines Testlaufs nie aufgerufen, sondern immer davor.

Überschreiben Sie diese Funktion nur, wenn Sie wissen, was Sie tun.

Parameter
`context`	`IInvocationContext`: Die `IInvocationContext` für den laufenden Aufruf.
`listener`	`ITestInvocationListener`: Der `ITestInvocationListener`, in dem die Ergebnisse platziert werden sollen.

Returns
`ITestInvocationListener`	Der neue Listener umschließt den ursprünglichen Listener.

Ausgabe
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback, wenn ein Testlauf aufgrund eines fehlgeschlagenen Assertions fehlschlägt.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält.
`test`	`TestDescription`: die `TestDescription` des laufenden Testlaufs.

Ausgabe
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält. Ist dasselbe Objekt wie während `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: Die aktuelle Zuordnung von Messwerten, die an `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` übergeben werden.
`test`	`TestDescription`: die `TestDescription` des laufenden Testlaufs.

Ausgabe
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält. Ist dasselbe Objekt wie während `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: Die aktuelle Zuordnung von Messwerten, die an `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` übergeben werden.

Ausgabe
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback, wenn ein Testlauf fehlschlägt.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält.
`test`	`TestDescription`: die `TestDescription` des Testlaufs.

Ausgabe
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Ermöglicht das Erfassen des Ereignisses „Modul beendet“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf. Ist dasselbe Objekt wie während `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: Die aktuelle Zuordnung von Messwerten, die an `ERROR(/#testRunEnded(long,Map))` übergeben werden.

Ausgabe
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback, wenn ein Testlauf gestartet wird.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf.

Ausgabe
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback, wenn ein Testlauf gestartet wird.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf.
`testCount`	`int`: Die Anzahl der Testläufe in diesem Testlauf.

Ausgabe
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback, wenn ein Testlauf gestartet wird.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält.

Ausgabe
`DeviceNotAvailableException`