TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.testtype.suite.TestFailureListener

---

Listener, mit denen bei einem Testfehler Aktionen wie Screenshots, Fehlerberichte und Logcat-Daten erfasst werden können.

Zusammenfassung

Öffentliche Konstruktoren
TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)

Öffentliche Methoden
void	applyModuleConfiguration(boolean bugreportOnFailure) Hiermit können die Aufrufeinstellungen von „Bei Fehler erfassen“ durch die modulspezifischen Konfigurationen überschrieben werden.
void	join() Schließen Sie sich allen Logcat-Aufzeichnungsthreads an, um sicherzustellen, dass sie beendet werden.
void	setLogger(ITestLogger logger) Legt fest, wo die Protokolle gespeichert werden sollen.
void	testFailed(TestDescription test, String trace) Hier wird der Fehler eines einzelnen Testfalls gemeldet.
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.
void	testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream) Leite das Protokoll an den Protokoller weiter, nicht über den #testLog-Callback. Wenn TestFailureListener Teil der Kette ist, führt dies zu einer unendlichen Schleife.

Öffentliche Konstruktoren

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

Parameter
devices
bugReportOnFailure	boolean
rebootOnFailure	boolean

Öffentliche Methoden

applyModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

Hiermit können die Aufrufeinstellungen von „Bei Fehler erfassen“ durch die modulspezifischen Konfigurationen überschrieben werden.

Parameter
bugreportOnFailure	boolean: „true“, um bei einem Testfehler einen Fehlerbericht zu erfassen. Andernfalls „false“.

zu betreten

public void join ()

Schließen Sie sich allen Logcat-Aufzeichnungsthreads an, um sicherzustellen, dass sie beendet werden.

setLogger

public void setLogger (ITestLogger logger)

Legt fest, wo die Protokolle gespeichert werden sollen.

Parameter
logger	ITestLogger

testFailed

public 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

testLog

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

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

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

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

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

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Leite das Protokoll an den Protokoller weiter, nicht über den #testLog-Callback. Wenn TestFailureListener Teil der Kette ist, führt dies zu einer unendlichen Schleife.

Parameter
dataName	String
dataType	LogDataType
dataStream	InputStreamSource