Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.proto.ProtoResultReporter

Bekannte direkte Unterklassen

FileProtoResultReporter, StreamProtoResultReporter

FileProtoResultReporter	Proto-Reporter, der `TestRecord` in eine Datei schreibt.
StreamProtoResultReporter	Eine Implementierung von `ProtoResultReporter`

Bekannte indirekte Unterklassen

InvocationProtoResultReporter, ModuleProtoResultReporter

InvocationProtoResultReporter	Reporter zum Speichern von Informationen zum Caching auf Aufrufebene und der zugehörigen Modulliste
ModuleProtoResultReporter	Ein Ergebnisreporter, der nur Ergebnisse auf Modulebene meldet.

Der Ergebnisreporter erstellt einen TestRecord-Protobuf mit allen Ergebnissen. Sollte erweitert werden, um zu berücksichtigen, was mit dem finalen Proto in processFinalProto(TestRecord) geschehen soll.

Zusammenfassung

Öffentliche Konstruktoren
`ProtoResultReporter()`

Öffentliche Methoden
`final void`	`invocationEnded(long elapsedTime)` Gibt an, dass der Aufruf beendet wurde, entweder erfolgreich oder aufgrund eines Fehlerzustands.
`void`	`invocationFailed(FailureDescription failure)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationFailed(Throwable cause)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationSkipped(SkipReason reason)` Meldet einen Aufruf als übersprungen
`void`	`invocationStarted(IInvocationContext context)` Meldet den Beginn des Testaufrufs.
`final void`	`logAssociation(String dataName, LogFile logFile)` In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten `testLogSaved(String,LogDataType,InputStreamSource,LogFile)`-Callback nicht.
`void`	`processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)` Verwenden Sie den Aufrufdatensatz, um alle endgültigen Logs des Aufrufs einzeln zu senden.
`void`	`processFinalProto(TestRecordProto.TestRecord finalRecord)` Verarbeitung des endgültigen Protokolls mit allen Ergebnissen.
`void`	`processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)` Verarbeitung des Testdatensatz-Protos für den Teilaufruf nach `invocationStarted(IInvocationContext)`.
`void`	`processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)` Umgang mit dem finalisierten Testlauf-Protokoll nach `testEnded(TestDescription,long,HashMap)`.
`void`	`processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)` Verarbeitung des partiellen Testlauf-Protokolls nach dem Auftreten von `testStarted(TestDescription,long)`.
`void`	`processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)` Verarbeitung des finalisierten Moduldatensatz-Protos nach `testModuleEnded()`.
`void`	`processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)` Verarbeitung des partiellen Moduldatensatz-Protokolls nach `testModuleStarted(IInvocationContext)`.
`void`	`processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)` Verarbeitung des finalen Laufdatensatz-Protos nach dem Ereignis `testRunEnded(long,HashMap)`.
`void`	`processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)` Verarbeitung des Proto für den Datensatz des partiellen Testlaufs nach dem Auftreten von `testRunStarted(String,int)`.
`void`	`setGranularResults(boolean granularResults)`
`void`	`setInlineRecordOfChildren(boolean inline)`
`boolean`	`supportGranularResults()` Gibt „True“ zurück, wenn der Bericht detaillierte Ergebnisse unterstützt, andernfalls „False“.
`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.
`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`	`testModuleEnded()` Meldet das Ende einer Modulausführung.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Meldet den Beginn der Ausführung eines Moduls.
`final void`	`testRunEnded(long elapsedTimeMillis, 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.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Meldet den Beginn eines Testlaufs.
`final void`	`testRunStarted(String runName, int testCount)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Meldet den Beginn eines Testlaufs.
`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)` Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden
`void`	`afterModuleEnd()`
`void`	`beforeModuleStart()`
`TestRecordProto.ChildReference`	`createModuleChildReference(TestRecordProto.TestRecord record)` Erstellt eine untergeordnete Referenz für ein Modul.

Öffentliche Konstruktoren

ProtoResultReporter

public ProtoResultReporter ()

Öffentliche Methoden

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 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 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 void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, um die Berichterstellung für mehrere Geräte zu unterstützen.

Parameter
`context`	`IInvocationContext`: Informationen zum Aufruf

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Log eng mit einem Testlauf verknüpft sein, aber die Möglichkeit dazu besteht beim direkten testLogSaved(String,LogDataType,InputStreamSource,LogFile)-Callback nicht. Mit diesem Callback kann also explizit eine starke Zuordnung angegeben werden.

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Verwenden Sie den Aufrufdatensatz, um alle endgültigen Logs des Aufrufs einzeln zu senden.

Parameter
`invocationLogs`	`TestRecordProto.TestRecord`: Das endgültige Proto, das den Aufruf darstellt.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Verarbeitung des endgültigen Protokolls mit allen Ergebnissen.

Parameter
`finalRecord`	`TestRecordProto.TestRecord`: Das endgültige Proto mit allen Aufrufergebnissen.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

Verarbeitung des Testdatensatz-Protos für den Teilaufruf nach invocationStarted(IInvocationContext).

Parameter
`invocationStartRecord`	`TestRecordProto.TestRecord`: Das teilweise Proto, das nach dem invocationStart ausgefüllt wird.
`invocationContext`	`IInvocationContext`: Der Aufruf `IInvocationContext`.

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Umgang mit dem finalisierten Testlauf-Protokoll nach testEnded(TestDescription,long,HashMap).

Parameter
`testCaseRecord`	`TestRecordProto.TestRecord`: Das endgültige Proto, das einen Testlauf darstellt.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Verarbeitung des partiellen Testlauf-Protokolls nach dem Auftreten von testStarted(TestDescription,long).

Parameter
`testCaseStartedRecord`	`TestRecordProto.TestRecord`: Das partielle Proto, das den Testlauf darstellt.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Verarbeitung des finalisierten Moduldatensatz-Protos nach testModuleEnded().

Parameter
`moduleRecord`	`TestRecordProto.TestRecord`: Das endgültige Proto, das das Modul darstellt.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Verarbeitung des partiellen Moduldatensatz-Protokolls nach testModuleStarted(IInvocationContext).

Parameter
`moduleStartRecord`	`TestRecordProto.TestRecord`: Das partielle Proto, das das Modul darstellt.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

Verarbeitung des finalen Laufdatensatz-Protos nach dem Ereignis testRunEnded(long,HashMap).

Parameter
`runRecord`	`TestRecordProto.TestRecord`: Das endgültige Proto, das den Lauf darstellt.
`moduleInProgress`	`boolean`: Gibt an, ob ein Modul gerade bearbeitet wird.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Verarbeitung des Proto für den Datensatz des partiellen Testlaufs nach dem Auftreten von testRunStarted(String,int).

Parameter
`runStartedRecord`	`TestRecordProto.TestRecord`: Das partielle Proto, das den Lauf darstellt.

setGranularResults

public void setGranularResults (boolean granularResults)

Parameter
`granularResults`	`boolean`

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

Parameter
`inline`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Gibt „True“ zurück, wenn der Bericht detaillierte Ergebnisse unterstützt, andernfalls „False“.

Gibt Folgendes zurück:
`boolean`

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

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 elapsedTimeMillis, 
                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
`elapsedTimeMillis`	`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 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)

Meldet den Beginn eines Testlaufs.

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

testRunStarted

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

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)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(TestDescription).

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

Geschützte Methoden

afterModuleEnd

protected void afterModuleEnd ()

beforeModuleStart

protected void beforeModuleStart ()

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

Erstellt eine untergeordnete Referenz für ein Modul.

Parameter
`record`	`TestRecordProto.TestRecord`

Gibt zurück
`TestRecordProto.ChildReference`