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 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ä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.
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.
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.

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 aggregiert die Messwerte.
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 vom Gerät gemeldeten Datei.
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(com.android.tradefed.device.metric.DeviceMetricData) und ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).

Zusammenfassung

Konstanten
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`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 im Aufruf verfügbar sind.
`final`	`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 in einer Map für die nachfolgenden Aufrufe.
`final ITestInvocationListener`	`getInvocationListener()` Gibt die ursprüngliche `ITestInvocationListener` zurück, an die die Ergebnisse weitergeleitet werden.
`String`	`getModuleName()`
`final`	`getRealDevices()` Gibt alle Geräte zurück, die keine Stubs 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)` Meldet, dass der Aufruf beendet wurde, unabhängig davon, ob dies erfolgreich oder aufgrund eines Fehlerzustands geschehen ist.
`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
`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 oder nicht.
`final void`	`logAssociation(String dataName, LogFile logFile)` Verwenden Sie keine Implementierung des Messwerterfassungstools für den Innenbereich.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback, wenn ein Testlauf aufgrund eines fehlgeschlagenen Assertions fehlschlägt.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Callback, wenn ein Testlauf beendet wird.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 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, currentRunMetrics)` Callback, wenn ein Testlauf beendet wird.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Callback 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.
`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 des Messwerterfassungstools für den Innenbereich.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
`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)` 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 des Messwerterfassungstools für den 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, 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 Abschluss beendet.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Wird aufgerufen, wenn ein Test übersprungen wird und aus einem Grund, der normalerweise nicht erwartet wird, nicht ausgeführt wurde.
`final void`	`testStarted(TestDescription test, long startTime)` Alternative zu `testStarted(com.android.tradefed.result.TestDescription)`, bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit `ERROR(/#testEnded(com.android.tradefed.result.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

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 im Aufruf verfügbar sind.

Returns

getDevices

public final  getDevices ()

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

Returns

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

Returns
`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.

Returns
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Returns
`String`

getRealDevices

public final  getRealDevices ()

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

Returns

getRunName

public String getRunName ()

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

Returns
`String`	mRunName, der Name des aktuellen Testlaufs.

getTestName

public String getTestName ()

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

Returns
`String`	mTestName, der Name des aktuellen Tests.

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 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`

invocationEnded

public final void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf beendet wurde, unabhängig davon, ob dies erfolgreich oder aufgrund eines Fehlerzustands geschehen ist.

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`, die die Ursache des Fehlers beschreibt

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

isDisabled

public final boolean isDisabled ()

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

Returns
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Gibt an, ob IDeviceActionReceiver deaktiviert ist oder nicht.

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

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Verwenden Sie keine Implementierung des Messwerterfassungstools für den 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 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 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 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 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.

Ausgabe
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

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

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 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`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback für testRunFailed-Ereignisse

Ausgabe
	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.

Ausgabe
`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.

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 nicht neu starten. Alle Versuche, das Gerät neu zu starten, werden ignoriert.

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

Ausgabe
`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.

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 Abbauvorgänge übersprungen werden sollten. 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 des Messwerterfassungstools für den Innenbereich. Das ist reine Weiterleitung.

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird

Parameter
`test`	`TestDescription`: Gibt den Test an.
`trace`	`String`: Stacktrace des Fehlers

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird

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

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 sie mit testStarted(com.android.tradefed.result.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`	: eine `ERROR(/Map)` der ausgegebenen Messwerte

testEnded

public final void testEnded (TestDescription test, 
                 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`	: eine `ERROR(/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`, die den Fehler und seinen Kontext beschreibt.

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)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Diese Methode wird automatisch vom TradeFederation-Framework aufgerufen und stellt das Host-Log und gegebenenfalls das Device-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 testLog-Methode 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 den Innenbereich. Das ist reine Weiterleitung.

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.
`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, 
                 runMetrics)

Meldet das Ende des Testlaufs.

Parameter
`elapsedTime`	`long`: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
`runMetrics`	: Schlüssel/Wert-Paare, die am Ende eines Testlaufs 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`, 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`, in der 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`: Die Startzeit des Laufs, gemessen mit `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor 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 wird und aus einem Grund, der normalerweise nicht erwartet wird, nicht ausgeführt wurde. 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(com.android.tradefed.result.TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit ERROR(/#testEnded(com.android.tradefed.result.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.