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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

Bekannte direkte Unterklassen

AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector

AtraceCollector	Eine `IMetricCollector`, die während eines Tests atrace ausführt, das Ergebnis erfasst und in der Aufrufabfolge protokolliert.
BugreportzOnFailureCollector	Erfassen Sie einen Fehlerbericht, wenn ein Testlauf fehlschlägt.
BugreportzOnTestCaseFailureCollector	Erstellen Sie einen Fehlerbericht, wenn ein Testfall in einem Durchlauf fehlschlägt.
ClangCodeCoverageCollector	Eine `BaseDeviceMetricCollector`, die Clang-Abdeckungsmessungen vom Gerät abruft und als Testartefakte protokolliert.
CodeCoverageCollector	Eine `BaseDeviceMetricCollector`, die Java- und native Abdeckungsmessungen vom Gerät abruft und als Testartefakte protokolliert.
CountTestCasesCollector	Anzahl der Testfälle für eine bestimmte `IRemoteTest` zählen und erfassen
DebugHostLogOnFailureCollector	Collector, der die hostseitigen Protokolle erfasst und protokolliert, wenn ein Testfall fehlschlägt.
DeviceTraceCollector	Dieser Collector startet den perfetto-Trace, wenn ein Testlauf beginnt, und protokolliert die Tracedatei am Ende.
FilePullerDeviceMetricCollector	Eine `BaseDeviceMetricCollector`, die auf Messwertschlüssel vom Gerät wartet und diese als Datei vom Gerät abruft.
GcovCodeCoverageCollector	Eine `BaseDeviceMetricCollector`, die Abdeckungsmessungen von gcov vom Gerät abruft und als Testartefakte protokolliert.
GcovKernelCodeCoverageCollector	Eine `BaseDeviceMetricCollector`, die gcov-Kernelabdeckungsmessungen aus debugfs und vom Gerät abruft und schließlich als Testartefakte protokolliert.
HostStatsdMetricCollector	Ein `IMetricCollector`, das StatsD-Messwerte mithilfe von StatsD-Dienstprogrammbefehlen auf Hostseite erfasst.
JavaCodeCoverageCollector	Eine `BaseDeviceMetricCollector`, die Java-Abdeckungsmessungen vom Gerät abruft und als Testartefakte protokolliert.
LogcatOnFailureCollector	Collector, der ein Logcat erfasst und protokolliert, wenn ein Test fehlschlägt.
LogcatTimingMetricCollector	Ein Messwert-Erfassungstool, das während eines oder mehrerer wiederholter Tests Zeitinformationen (z. B. die Zeit für den Nutzerwechsel) aus Logcat erfasst. Dazu werden Start- und Endsignale eines Ereignisses aus Logcat-Zeilen mithilfe bestimmter regulärer Ausdrücke geparst.
RebootReasonCollector	Dieser Collector erfasst Neustarts des Geräts während des Testlaufs und meldet sie nach Grund und Häufigkeit.
RuntimeRestartCollector	Collector, der Zeitstempel von Laufzeitneustarts (Systemserverabstürzen) während des Tests erfasst, falls vorhanden.
ScreenshotOnFailureCollector	Erfasst und protokolliert einen Screenshot, wenn ein Testfall fehlschlägt.

Bekannte indirekte Unterklassen

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

AtraceRunMetricCollector	Hiermit werden die Protokolle aus dem gesamten Testverzeichnis unter dem angegebenen Verzeichnis auf dem Testgerät erfasst, das Testverzeichnis protokolliert, die Protokolldateien im Testverzeichnis nachbearbeitet und die Messwerte zusammengefasst.
BluetoothConnectionLatencyCollector	Der Collector sendet eine vordefinierte StatsD-Konfiguration für den Messwert „Dauer“ an die Geräte und erfasst die Dauer der Bluetooth-Verbindung für jedes Profil.
BluetoothConnectionStateCollector	Dieser Collector erfasst Messwerte vom Typ „BluetoothConnectionStateChanged“ und zeichnet die Verbindungsstatusnummer für jedes Profil auf.
BluetoothHciSnoopLogCollector	Collector, um die Bluetooth HCI-Snoop-Protokollierung auf der DUT zu aktivieren und das Protokoll für jeden Test zu erfassen.
FilePullerLogCollector	Logger der vom Gerät gemeldeten Datei.
ModuleLogcatCollector	Version des Logcat-Collectors, aber für das Modul.
PerfettoPullerMetricCollector	Basisimplementierung von `FilePullerDeviceMetricCollector`, mit der die perfetto-Dateien vom Gerät abgerufen und die Messwerte daraus erfasst werden können.
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 Protokolle erfasst und in der Aufrufdatei protokolliert.

Basisimplementierung von IMetricCollector, mit der die Erhebung auf onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) und ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) gestartet und beendet werden kann.

Zusammenfassung

Felder
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Öffentliche Konstruktoren
`BaseDeviceMetricCollector()`

Öffentliche Methoden
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`final`	`getBuildInfos()` Gibt die Liste der Build-Informationen zurück, die in der Aufrufanfrage verfügbar sind.
`final`	`getDevices()` Gibt die Liste der Geräte zurück, die bei der Aufrufung verfügbar sind.
`File`	`getFileFromTestArtifacts(String fileName)` Rufen Sie die Datei aus den Test- oder Modulartefakten ab und speichern Sie sie für die nachfolgenden Aufrufe in einer Map im Cache.
`final ITestInvocationListener`	`getInvocationListener()` Gibt die ursprüngliche `ITestInvocationListener` zurück, an die die Ergebnisse weitergeleitet werden.
`String`	`getModuleName()`
`final`	`getRealDevices()` Gibt alle Geräte aus der Liste `getDevices()` zurück, die keine Stub-Geräte sind.
`String`	`getRunName()` Gibt den Namen des Testlaufs `mRunName` zurück, der den Collector auslöst.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisierung des Collectors mit dem aktuellen Kontext und der Information, wohin die Ergebnisse weitergeleitet werden sollen.
`final void`	`invocationEnded(long elapsedTime)` Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.
`final void`	`invocationFailed(FailureDescription failure)` Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.
`final void`	`invocationFailed(Throwable cause)` Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.
`void`	`invocationSkipped(SkipReason reason)` Eine Aufrufung wird als übersprungen gemeldet.
`final void`	`invocationStarted(IInvocationContext context)` Aufruf-Listener für die Weiterleitung
`final boolean`	`isDisabled()` Gibt „True“ zurück, wenn das gesamte Objekt deaktiviert ist (Einrichtung und Deaktivierung werden übersprungen).
`boolean`	`isDisabledReceiver()` Gibt an, ob die `IDeviceActionReceiver` deaktiviert ist oder nicht.
`final void`	`logAssociation(String dataName, LogFile logFile)` Nicht in der Implementierung von Messwert-Collectors verwenden.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Rückruf, wenn ein Testfall mit einem Annahmefehler fehlschlägt.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Rückruf, wenn ein Testfall beendet ist.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Rückruf, wenn ein Testfall beendet ist.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Rückruf, wenn ein Testlauf fehlschlägt.
`void`	`onTestModuleEnded()` Ermöglicht das Erfassen des Ereignisses „Modulende“.
`void`	`onTestModuleStarted()` Ermöglicht das Erfassen des Ereignisses „Modul gestartet“.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback, wenn ein Testlauf beendet ist.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Rückruf für Ereignisse vom Typ „testRunFailed“
`void`	`onTestRunStart(DeviceMetricData runData)` Callback, wenn ein Test gestartet wird.
`void`	`onTestStart(DeviceMetricData testData)` Callback, wenn ein Testfall 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 des Geräts gestartet wird.
`final void`	`setDisable(boolean isDisabled)` Legt fest, ob das Objekt deaktiviert werden soll.
`void`	`setDisableReceiver(boolean isDisabled)` Legt fest, ob die `IDeviceActionReceiver` deaktiviert werden soll.
`final void`	`setLogSaver(ILogSaver logSaver)` Nicht in der Implementierung von Messwert-Collectors verwenden.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternative zu `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, mit der wir die Endzeit direkt angeben können.
`final void`	`testEnded(TestDescription test, testMetrics)` Gibt das Ende der Ausführung eines einzelnen Testfalls an.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Hier wird der Fehler eines einzelnen Testfalls gemeldet.
`final void`	`testFailed(TestDescription test, String trace)` Hier wird der Fehler eines einzelnen Testfalls gemeldet.
`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)` Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Nicht in der Implementierung von Messwert-Collectors verwenden.
`final void`	`testModuleEnded()` Gibt das Ende eines Modullaufs an.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Gibt den Beginn der Ausführung eines Moduls an.
`final void`	`testRunEnded(long elapsedTime, runMetrics)` Gibt das Ende des Testlaufs an.
`final void`	`testRunFailed(FailureDescription failure)` Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von `FailureDescription` beschrieben wurde, 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)` Gibt den Beginn eines Testlaufs an.
`final void`	`testRunStarted(String runName, int testCount)` Callbacks für Testläufe
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Gibt den Beginn eines Testlaufs an.
`final void`	`testRunStopped(long elapsedTime)` Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird.
`final void`	`testStarted(TestDescription test, long startTime)` Alternative zu `testStarted(com.android.tradefed.result.TestDescription)`, bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` kombiniert, um genaue Messungen zu ermöglichen.
`final void`	`testStarted(TestDescription test)` Callbacks für Testfälle

Felder

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Öffentliche Konstruktoren

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Öffentliche Methoden

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getBuildInfos

public final  getBuildInfos ()

Gibt die Liste der Build-Informationen zurück, die in der Aufrufanfrage verfügbar sind.

Returns

getDevices

public final  getDevices ()

Gibt die Liste der Geräte zurück, die bei der Aufrufung verfügbar sind.

Returns

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

Returns
`File`	Datei aus dem Test- oder Modul-Artefakt 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.

Returns
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Returns
`String`

getRealDevices

public final  getRealDevices ()

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

Returns

getRunName

public String getRunName ()

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

Returns
`String`	mRunName, der Name der aktuellen Testausführung.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialisierung des Collectors mit dem aktuellen Kontext und der Information, wohin die Ergebnisse weitergeleitet werden sollen. Wird nur einmal pro Instanz aufgerufen. Der Collector soll seinen internen Kontext und Listener aktualisieren. Init wird nie während eines Testlaufs aufgerufen, sondern immer davor.

Überschreiben Sie die Standardeinstellungen nur, wenn Sie wissen, was Sie tun.

Parameter
`context`	`IInvocationContext`: den `IInvocationContext` für die laufende Aufrufabfolge.
`listener`	`ITestInvocationListener`: die `ITestInvocationListener`, in der die Ergebnisse platziert werden sollen.

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

Ausgabe
`DeviceNotAvailableException`

invocationEnded

public final void invocationEnded (long elapsedTime)

Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`elapsedTime`	`long`: die verstrichene Zeit seit der Aufrufung in ms

invocationFailed

public final void invocationFailed (FailureDescription failure)

Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`failure`	`FailureDescription`: die `FailureDescription`, die die Ursache des Fehlers beschreibt

invocationFailed

public final void invocationFailed (Throwable cause)

Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`cause`	`Throwable`: die `Throwable` Ursache des Fehlers

invocationSkipped

public void invocationSkipped (SkipReason reason)

Eine Aufrufung wird als übersprungen gemeldet.

Parameter
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Aufruf-Listener für die Weiterleitung

Parameter
`context`	`IInvocationContext`: Informationen zur Aufrufung

isDisabled

public final boolean isDisabled ()

Gibt „True“ zurück, wenn das gesamte Objekt deaktiviert ist (Einrichtung und Deaktivierung werden übersprungen). Andernfalls „false“.

Returns
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Gibt an, ob die IDeviceActionReceiver deaktiviert ist oder nicht.

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

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Nicht in der Implementierung von Messwert-Collectors verwenden. Das ist eine reine Weiterleitung.

Parameter
`dataName`	`String`: Der Name der Daten
`logFile`	`LogFile`: die zuvor protokollierte `LogFile`, die mit dem Testfall verknüpft werden soll.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Rückruf, wenn ein Testfall mit einem Annahmefehler fehlschlägt.

Parameter
`testData`	`DeviceMetricData`: die `DeviceMetricData`, die die Daten für den Testfall enthält.
`test`	`TestDescription`: die `TestDescription` des laufenden Testfalls.

Ausgabe
`DeviceNotAvailableException`

onTestEnd

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

Rückruf, wenn ein Testfall beendet ist. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: die `DeviceMetricData`, die die Daten für den Testfall enthält. Dies ist dasselbe Objekt wie bei `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 Testfalls.

Ausgabe
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Rückruf, wenn ein Testfall beendet ist. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: die `DeviceMetricData`, die die Daten für den Testfall enthält. Dies ist dasselbe Objekt wie bei `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 void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Rückruf, wenn ein Testlauf fehlschlägt.

Parameter
`testData`	`DeviceMetricData`: die `DeviceMetricData`, die die Daten für den Testfall enthält.
`test`	`TestDescription`: die `TestDescription` des laufenden Testfalls.

Ausgabe
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Ermöglicht das Erfassen des Ereignisses „Modulende“.

Ausgabe
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

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

Ausgabe
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

Ausgabe
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Rückruf für Ereignisse vom Typ „testRunFailed“

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

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback, wenn ein Test gestartet wird.

Parameter
`runData`	`DeviceMetricData`: die `DeviceMetricData`, die die Daten für den Lauf enthält.

Ausgabe
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback, wenn ein Testfall gestartet wird.

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

Ausgabe
`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 keinen Neustart ausführen. Alle Neustartversuche werden ignoriert.

Parameter
`device`	`ITestDevice`: `ITestDevice`, an dem der Neustart beendet wurde.

Ausgabe
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Erhält eine Benachrichtigung, wenn der Neustart des Geräts gestartet wird.

HINWEIS: Empfänger sollten während dieses Rückrufs keinen Neustart ausführen. Alle Neustartversuche werden ignoriert.

Parameter
`device`	`ITestDevice`: `ITestDevice`, von wo aus der Neustart gestartet wurde.

Ausgabe
`DeviceNotAvailableException`

setDisable

public final void setDisable (boolean isDisabled)

Legt fest, ob das Objekt deaktiviert werden soll. „Deaktiviert“ bedeutet, dass sowohl die Einrichtungs- als auch die Deaktivierungsschritte übersprungen werden sollten. Damit kann ein Objekt im Standardkonstruktor standardmäßig deaktiviert werden.

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

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

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

Parameter
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Nicht in der Implementierung von Messwert-Collectors verwenden. Das ist eine reine Weiterleitung.

Parameter
`logSaver`	`ILogSaver`: die `ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
`test`	`TestDescription`: identifiziert den Test
`trace`	`String`: Stack-Trace des Fehlers

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
`test`	`TestDescription`: identifiziert den Test
`failure`	`FailureDescription`: `FailureDescription`, die den Fehler und seinen Kontext beschreiben.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können. Kombinieren Sie diesen Messwert mit testStarted(com.android.tradefed.result.TestDescription, long), um genaue Ergebnisse zu erhalten.

Parameter
`test`	`TestDescription`: identifiziert den Test
`endTime`	`long`: Die Uhrzeit, zu der der Test beendet wurde, gemessen über `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` der gesendeten Messwerte

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Außerdem werden alle Schlüssel/Wert-Messwerte zurückgegeben, die während der Ausführung des Testfalls gesendet wurden.

Parameter
`test`	`TestDescription`: identifiziert den Test
`testMetrics`	: `ERROR(/Map)` der gesendeten Messwerte

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: identifiziert den Test
`failure`	`FailureDescription`: `FailureDescription`, die den Fehler und seinen Kontext beschreibt.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: identifiziert den Test
`trace`	`String`: Stack-Trace 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`: identifiziert den Test

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.

Muss vor dem ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Hostprotokoll und gegebenenfalls das Geräte-Logcat bereit.

Parameter
`dataName`	`String`: Ein `String` aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis: Der Datenname muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten.
`dataType`	`LogDataType`: die `LogDataType` der Daten
`dataStream`	`InputStreamSource`: die `InputStreamSource` der Daten. Implementer müssen createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss schließen. Die Aufrufer müssen dafür sorgen, dass die Datenquelle bis zum Abschluss der testLog-Methode vorhanden und zugänglich ist.

testLogSaved

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

Nicht in der Implementierung von Messwert-Collectors verwenden. Das ist eine reine Weiterleitung.

Parameter
`dataName`	`String`: Ein `String` aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis: „dataName“ muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also mehrere Aufrufe mit demselben „dataName“ verarbeiten können.
`dataType`	`LogDataType`: die `LogDataType` der Daten
`dataStream`	`InputStreamSource`: die `InputStreamSource` der Daten. Implementer müssen createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss schließen.
`logFile`	`LogFile`: die `LogFile` mit den Metadaten der gespeicherten Datei.

testModuleEnded

public final void testModuleEnded ()

Gibt das Ende eines Modullaufs an.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Gibt den Beginn der Ausführung eines Moduls an. Dieser Rückruf ist mit testModuleEnded() verknüpft und in der Abfolge optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: suitebasierte Auslöser.

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

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Gibt das Ende des Testlaufs an.

Parameter
`elapsedTime`	`long`: Vom Gerät gemeldete verstrichene Zeit in Millisekunden
`runMetrics`	: Schlüssel/Wert-Paare, die am Ende eines Testlaufs erfasst werden

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

Parameter
`failure`	`FailureDescription`: `FailureDescription`, die den Fehler und seinen Kontext beschreibt.

testRunFailed

public final void testRunFailed (String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
`errorMessage`	`String`: `String` mit einer Beschreibung des Grunds für den Ausführungsfehler.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Gibt den Beginn eines Testlaufs an.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Die Reihenfolgenummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt viermal unter demselben „runName“ ausgeführt werden und die „attemptNumber“ sollte von 0 auf 3 steigen.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callbacks für Testläufe

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)

Gibt den Beginn eines Testlaufs an.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte es insgesamt vier Durchläufe mit demselben „runName“ geben und die „attemptNumber“ sollte zwischen 0 und 3 liegen.
`startTime`	`long`: Zeitpunkt des Beginns der Ausführung, gemessen über `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: Vom Gerät gemeldete verstrichene Zeit in Millisekunden

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

Parameter
`test`	`TestDescription`: identifiziert den Test
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) kombiniert, um genaue Messungen zu ermöglichen.

Parameter
`test`	`TestDescription`: identifiziert den Test
`startTime`	`long`: Die Uhrzeit, zu der der Test gestartet wurde, gemessen über `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Callbacks für Testfälle

Parameter
`test`	`TestDescription`: identifiziert den Test