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 die TestRecord in eine Datei ablegt.  StreamProtoResultReporter Eine Implementierung von ProtoResultReporter

Bekannte indirekte Unterklassen InvocationProtoResultReporter, ModuleProtoResultReporter InvocationProtoResultReporter Berichter zum Speichern von Caching-Informationen auf Aufrufebene und der Liste der Module  ModuleProtoResultReporter Ein Ergebnisbericht, der nur die Ergebnisse auf Modulebene enthält.

---

Der Ergebnisberichter erstellt ein TestRecord-Protobuf mit allen Ergebnissen. Sollte erweitert werden, um zu steuern, was mit dem endgültigen Prototyp in processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) geschehen soll.

Zusammenfassung

Öffentliche Konstruktoren
ProtoResultReporter()

Öffentliche Methoden
final void	invocationEnded(long elapsedTime) Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.
void	invocationFailed(FailureDescription failure) Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.
void	invocationFailed(Throwable cause) Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.
void	invocationSkipped(SkipReason reason) Eine Aufrufung wird als übersprungen gemeldet.
void	invocationStarted(IInvocationContext context) Gibt den Beginn der Testausführung an.
final void	logAssociation(String dataName, LogFile logFile) In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist.
void	processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs) Verwenden Sie den Aufrufeintrag, um alle endgültigen Protokolle der Aufrufe einzeln zu senden.
void	processFinalProto(TestRecordProto.TestRecord finalRecord) Umgang mit dem endgültigen Prototyp mit allen Ergebnissen
void	processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) Umgang mit dem Testprotokoll für die teilweise Aufrufung nach invocationStarted(com.android.tradefed.invoker.IInvocationContext)
void	processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord) Umgang mit dem finalisierten Testfall-Prototyp nach ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
void	processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord) Umgang mit dem teilweisen Testfall-Prototyp nach testStarted(com.android.tradefed.result.TestDescription, long)
void	processTestModuleEnd(TestRecordProto.TestRecord moduleRecord) Umgang mit dem Prototyp des finalisierten Modul-Eintrags nach testModuleEnded()
void	processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord) Umgang mit dem Prototyp des teilweisen Moduleintrags nach testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
void	processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress) Umgang mit dem finalisierten Ausführungsprotokoll-Proto nach ERROR(/#testRunEnded(long,HashMap))
void	processTestRunStarted(TestRecordProto.TestRecord runStartedRecord) Umgang mit dem Prototyp des Datensatzes für den teilweisen Testlauf nach testRunStarted(String, int)
void	setGranularResults(boolean granularResults)
void	setInlineRecordOfChildren(boolean inline)
boolean	supportGranularResults() Gibt „True“ zurück, wenn der Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“.
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.
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	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 elapsedTimeMillis, 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.
void	testRunStarted(String runName, int testCount, int attemptNumber) Gibt den Beginn eines Testlaufs an.
final void	testRunStarted(String runName, int testCount) Gibt den Beginn eines Testlaufs an.
void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Gibt den Beginn eines Testlaufs an.
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) Gibt den Beginn eines einzelnen Testfalls an.

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, 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 void invocationFailed (FailureDescription failure)

Eine unvollständige Aufrufung wird aufgrund eines Fehlers gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

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

invocationFailed

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

Gibt den Beginn der Testausführung an.

Wird automatisch vom TradeFederation-Framework aufgerufen. Meldende müssen diese Methode überschreiben, um Berichte zu mehreren Geräten zu unterstützen.

Parameter
context	IInvocationContext: Informationen zur Aufrufung

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

In einigen Fällen muss das Protokoll eng mit den Testfällen verknüpft sein, was über den direkten testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)-Callback jedoch nicht möglich ist. So kann mit diesem Rückruf eine starke Verknüpfung explizit angegeben werden.

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

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

Verwenden Sie den Aufrufeintrag, um alle endgültigen Protokolle der Aufrufe einzeln zu senden.

Parameter
invocationLogs	TestRecordProto.TestRecord: Das fertige Proto, das die Aufrufe darstellt.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

Umgang mit dem endgültigen Prototyp mit allen Ergebnissen

Parameter
finalRecord	TestRecordProto.TestRecord: Das fertige Proto mit allen Aufrufergebnissen.

processStartInvocation

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

Umgang mit dem Testprotokoll für die teilweise Aufrufung nach invocationStarted(com.android.tradefed.invoker.IInvocationContext)

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

processTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

Umgang mit dem finalisierten Testfall-Prototyp nach ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))

Parameter
testCaseRecord	TestRecordProto.TestRecord: Das fertige Proto, das einen Testfall darstellt.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

Umgang mit dem teilweisen Testfall-Prototyp nach testStarted(com.android.tradefed.result.TestDescription, long)

Parameter
testCaseStartedRecord	TestRecordProto.TestRecord: Der Teil des Prototyps, der den Testfall darstellt.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

Umgang mit dem Prototyp des finalisierten Modul-Eintrags nach testModuleEnded()

Parameter
moduleRecord	TestRecordProto.TestRecord: Das fertige Proto, das das Modul darstellt.

processTestModuleStarted

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

Umgang mit dem Prototyp des teilweisen Modul-Eintrags nach testModuleStarted(com.android.tradefed.invoker.IInvocationContext)

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

processTestRunEnded

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

Umgang mit dem finalisierten Ausführungsprotokoll-Proto nach ERROR(/#testRunEnded(long,HashMap))

Parameter
runRecord	TestRecordProto.TestRecord: Das fertige Proto, das den Lauf darstellt.
moduleInProgress	boolean: ob ein Modul gerade bearbeitet wird.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

Umgang mit dem Prototyp des Datensatzes für den teilweisen Testlauf nach testRunStarted(String, int)

Parameter
runStartedRecord	TestRecordProto.TestRecord: Das teilweise 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 Berichter detaillierte Ergebnisse unterstützt, andernfalls „False“.

Returns
boolean

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

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

Gibt das Ende des Testlaufs an.

Parameter
elapsedTimeMillis	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 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 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 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)

Gibt den Beginn eines Testlaufs an.

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)

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

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)

Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
test	TestDescription: identifiziert den Test

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

Returns
TestRecordProto.ChildReference