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