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, ModulePerfettoCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenRecordOnFailureCollector, ScreenshotOnFailureCollector 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.