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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Bekannte direkte Unterklassen

AtraceCollector	Ein `IMetricCollector`, das atrace während eines Tests ausführt, das Ergebnis erfasst und es im Aufruf protokolliert.
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ählt und meldet die Anzahl der Testläufe für eine bestimmte `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 am Ende die Trace-Datei protokolliert.
FilePullerDeviceMetricCollector	Ein `BaseDeviceMetricCollector`, das auf den vom Gerät gesendeten Messwertschlüssel wartet und die Messwerte als Datei vom Gerät abruft.
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.
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 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.
ModulePerfettoCollector	Collector, der den Perfetto-Trace startet, wenn ein Testmodul beginnt und endet und das Gerät neu gestartet wird.
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.
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.

Bekannte indirekte Unterklassen

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

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.
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.
FilePullerLogCollector	Logger der Datei, die von der Geräteseite gemeldet wird.
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)`.
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.

Die Basisimplementierung von IMetricCollector ermöglicht das Starten und Beenden der Erhebung auf onTestRunStart(DeviceMetricData) und onTestRunEnd(DeviceMetricData,Map).

Zusammenfassung

Konstanten
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Öffentliche Konstruktoren
`BaseDeviceMetricCollector()`

Öffentliche Methoden
`boolean`	`doesModuleContainFailure()` Gibt „true“ zurück, wenn das aktuelle Modul Testlauf- oder Testfallfehler enthält.
`void`	`enableDefaultMetricCollection()` Ermöglicht es Collectoren, die standardmäßige Messwerterfassung zu aktivieren.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` Gibt die Liste der Build-Informationen zurück, die im Aufruf verfügbar sind.
`final List<ITestDevice>`	`getDevices()` Gibt die Liste der in der Anfrage verfügbaren Geräte zurück.
`File`	`getFileFromTestArtifacts(String fileName)` Rufen Sie die Datei aus den Testartefakten oder Modulartefakten ab und speichern Sie sie für die nachfolgenden Aufrufe in einer Map.
`final ITestInvocationListener`	`getInvocationListener()` Gibt die ursprüngliche `ITestInvocationListener` zurück, an die die Ergebnisse weitergeleitet werden.
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` Gibt alle Geräte zurück, die keine Stub-Geräte sind, aus der Liste `getDevices()`.
`String`	`getRunName()` Gibt den Namen des Testlaufs `mRunName` zurück, der den Collector auslöst.
`String`	`getTestName()` Gibt den Namen des Tests `mTestName` zurück, der den Collector auslöst.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisierung des Collectors mit dem aktuellen Kontext und Angabe des Ziels für die Weiterleitung der Ergebnisse.
`final void`	`invocationEnded(long elapsedTime)` Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
`final void`	`invocationFailed(FailureDescription failure)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`final void`	`invocationFailed(Throwable cause)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationSkipped(SkipReason reason)` Meldet einen Aufruf als übersprungen
`final void`	`invocationStarted(IInvocationContext context)` Invocation-Listener für die Weiterleitung
`boolean`	`isDefaultMetricCollectionEnabled()` Gibt an, ob der Collector Messwerte im Rahmen der Standardmesswerterfassung erfasst.
`final boolean`	`isDisabled()` Gibt „True“ zurück, wenn das gesamte Objekt deaktiviert ist (sowohl Einrichtung als auch Abbau werden übersprungen).
`boolean`	`isDisabledReceiver()` Gibt an, ob `IDeviceActionReceiver` deaktiviert ist.
`final void`	`logAssociation(String dataName, LogFile logFile)` Verwenden Sie keine Implementierung für die Erfassung von Messwerten im Innenbereich.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf aufgrund eines Annahmefehlers fehlschlägt.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback, wenn ein Testlauf beendet wird.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback, wenn ein Testlauf beendet wird.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf fehlschlägt.
`void`	`onTestModuleEnded()` Ermöglicht das Erfassen des Ereignisses „Modul beendet“.
`void`	`onTestModuleStarted()` Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback, wenn ein Testlauf beendet wird.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Rückruf für testRunFailed-Ereignisse
`void`	`onTestRunStart(DeviceMetricData runData)` Callback, wenn ein Testlauf gestartet wird.
`void`	`onTestStart(DeviceMetricData testData)` Callback, wenn ein Testlauf gestartet wird.
`void`	`rebootEnded(ITestDevice device)` Erhält eine Benachrichtigung, wenn der Neustart des Geräts abgeschlossen ist.
`void`	`rebootStarted(ITestDevice device)` Erhält eine Benachrichtigung, wenn der Neustart auf dem Gerät gestartet wurde.
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Legt die Ebene fest, auf der der Collector unabhängig von Fehlern Logs erfassen soll.
`final void`	`setDisable(boolean isDisabled)` Legt fest, ob das Objekt deaktiviert werden soll.
`void`	`setDisableReceiver(boolean isDisabled)` Legt fest, ob `IDeviceActionReceiver` deaktiviert werden soll.
`final void`	`setLogSaver(ILogSaver logSaver)` Verwenden Sie keine Implementierung für die Erfassung von Messwerten im Innenbereich.
`void`	`setModuleContainsFailure()` Gibt an, ob im Modul Fehler aufgetreten sind (Testlauf, Testlauf).
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Legt die Ebene fest, auf der der Collector bei Fehlern Logs erfassen soll.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wird aufgerufen, wenn ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
`final 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.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Meldet das Ende der Ausführung eines einzelnen Testlaufs.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Meldet das Fehlschlagen eines einzelnen Testlaufs.
`final void`	`testFailed(TestDescription test, String trace)` Meldet das Fehlschlagen eines einzelnen Testlaufs.
`final 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.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Verwenden Sie keine Implementierung für die Erfassung von Messwerten im Innenbereich.
`final void`	`testModuleEnded()` Meldet das Ende einer Modulausführung.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Meldet den Beginn der Ausführung eines Moduls.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Meldet das Ende des Testlaufs.
`final void`	`testRunFailed(FailureDescription failure)` Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch `FailureDescription` beschrieben wird, nicht abgeschlossen werden.
`final void`	`testRunFailed(String errorMessage)` Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Meldet den Beginn eines Testlaufs.
`final void`	`testRunStarted(String runName, int testCount)` Testlauf-Callbacks
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Meldet den Beginn eines Testlaufs.
`final void`	`testRunStopped(long elapsedTime)` Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor dem Abschluss beendet.
`final 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.
`final 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.
`final void`	`testStarted(TestDescription test)` Testlauf-Callbacks

Konstanten

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Konstanter Wert: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Konstanter Wert: "test-case-include-group"

Öffentliche Konstruktoren

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Öffentliche Methoden

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Gibt „true“ zurück, wenn das aktuelle Modul Testlauf- oder Testfallfehler enthält.

Gibt Folgendes zurück:
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Ermöglicht es Collectoren, die standardmäßige Messwerterfassung zu aktivieren. Wenn die Standarderfassung von Messwerten aktiviert ist, sollte der Collector nur auf der angegebenen Erfassungsebene Daten erfassen.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Gibt Folgendes zurück:
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

Gibt Folgendes zurück:
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

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

Gibt Folgendes zurück:
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Rufen Sie die Datei aus den Testartefakten oder Modulartefakten ab und speichern Sie sie für die nachfolgenden Aufrufe in einer Map.

Parameter
`fileName`	`String`: Name der Datei, die in den Artefakten gesucht werden soll.

Gibt Folgendes zurück:
`File`	Datei aus dem Testartefakt oder Modulartefakt. Gibt „null“ zurück, wenn die Datei nicht gefunden wird.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

Gibt Folgendes zurück:
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Gibt Folgendes zurück:
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Gibt Folgendes zurück:
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

Gibt alle Geräte zurück, die keine Stub-Geräte sind, aus der Liste getDevices().

Gibt Folgendes zurück:
`List<ITestDevice>`

getRunName

public String getRunName ()

Gibt den Namen des Testlaufs mRunName zurück, der den Collector auslöst.

Gibt Folgendes zurück:
`String`	mRunName, der Name des aktuellen Testlaufs.

getTestName

public String getTestName ()

Gibt den Namen des Tests mTestName zurück, der den Collector auslöst.

Gibt Folgendes zurück:
`String`	mTestName, der aktuelle Testname.

init

public final 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 die Funktion nur, wenn Sie wissen, was Sie tun.

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

Gibt Folgendes zurück:
`ITestInvocationListener`	Der neue Listener umschließt den ursprünglichen Listener.

Löst aus
`DeviceNotAvailableException`

invocationEnded

public final 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 final 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

invocationFailed

public final 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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Invocation-Listener für die Weiterleitung

Parameter
`context`	`IInvocationContext`: Informationen zum Aufruf

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Gibt an, ob der Collector Messwerte im Rahmen der Standardmesswerterfassung erfasst.

Gibt Folgendes zurück:
`boolean`

isDisabled

public final boolean isDisabled ()

Gibt „True“ zurück, wenn das gesamte Objekt deaktiviert ist (sowohl Einrichtung als auch Abbau werden übersprungen). Andernfalls „Falsch”.

Gibt Folgendes zurück:
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Gibt an, ob IDeviceActionReceiver deaktiviert ist.

Gibt Folgendes zurück:
`boolean`	Gibt „true“ zurück, wenn deaktiviert, andernfalls „false“.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Verwenden Sie keine Implementierung für die Erfassung von Messwerten im Innenbereich. Das ist reine Weiterleitung.

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

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback, wenn ein Testlauf aufgrund eines Annahmefehlers fehlschlägt.

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

Löst aus
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> 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(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Die aktuelle Zuordnung von Messwerten, die an `testEnded(TestDescription,Map)` übergeben werden.

Löst aus
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> 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(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: Die aktuelle Zuordnung von Messwerten, die an `testEnded(TestDescription,Map)` übergeben werden.
`test`	`TestDescription`: die `TestDescription` des laufenden Testlaufs.

Löst aus
`DeviceNotAvailableException`

onTestFail

public 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 laufenden Testlaufs.

Löst aus
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

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

Löst aus
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

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

Löst aus
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> 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(DeviceMetricData)`.
`currentRunMetrics`	`Map`: Die aktuelle Zuordnung von Messwerten, die an `testRunEnded(long,Map)` übergeben werden.

Löst aus
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Rückruf für testRunFailed-Ereignisse

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback, wenn ein Testlauf gestartet wird.

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

Löst aus
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback, wenn ein Testlauf gestartet wird.

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

Löst aus
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Erhält eine Benachrichtigung, wenn der Neustart des Geräts abgeschlossen ist.

HINWEIS: Empfänger sollten während dieses Rückrufs nicht neu starten. Alle Versuche, das Gerät neu zu starten, werden ignoriert.

Parameter
`device`	`ITestDevice`: `ITestDevice`, wo der Neustart beendet wurde.

Löst aus
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Erhält eine Benachrichtigung, wenn der Neustart auf dem Gerät gestartet wurde.

HINWEIS: Empfänger sollten während dieses Rückrufs nicht neu starten. Alle Versuche, das Gerät neu zu starten, werden ignoriert.

Parameter
`device`	`ITestDevice`: `ITestDevice`, in der der Neustart begonnen hat.

Löst aus
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Legt die Ebene fest, auf der der Collector unabhängig von Fehlern Logs erfassen soll.

Bei NULL-Level erfolgt keine Erhebung.

Parameter
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel`, auf der die Logs erfasst werden.

setDisable

public final void setDisable (boolean isDisabled)

Legt fest, ob das Objekt deaktiviert werden soll. „Deaktiviert“ bedeutet, dass sowohl die Einrichtungs- als auch die Abbauvorgänge übersprungen werden sollen. Kann verwendet werden, um ein Objekt im Standardkonstruktor standardmäßig zu deaktivieren.

Parameter
`isDisabled`	`boolean`: Der Status, in den das Objekt versetzt werden soll.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Legt fest, ob IDeviceActionReceiver deaktiviert werden soll. Wenn Sie die Registrierung deaktivieren, wird die App nicht auf dem Gerät registriert, um Geräteaktionsereignisse zu empfangen.

Parameter
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Verwenden Sie keine Implementierung für die Erfassung von Messwerten im Innenbereich. Das ist reine Weiterleitung.

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

setModuleContainsFailure

public void setModuleContainsFailure ()

Gibt an, ob im Modul Fehler aufgetreten sind (Testlauf, Testlauf).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Legt die Ebene fest, auf der der Collector bei Fehlern Logs erfassen soll.

Bei NULL-Level erfolgt keine Erhebung.

Parameter
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel`, auf der die Logs erfasst werden.

testAssumptionFailure

public final 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 final 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 final 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

testEnded

public final 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 final 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 final 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 final 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 final 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.

testLogSaved

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

Verwenden Sie keine Implementierung des Messwerterfassungstools für interne Zwecke. Das ist reine Weiterleitung.

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.

testModuleEnded

public final void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public final 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 final 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 final 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 final 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 final 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 final void testRunStarted (String runName, 
                int testCount)

Testlauf-Callbacks

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

testRunStarted

public final 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()`

testRunStopped

public final 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.

testSkipped

public final 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 final 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()`

testStarted

public final void testStarted (TestDescription test)

Testlauf-Callbacks

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