TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

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


Der Listener hat bei einem Testfehler auf Anfrage Maßnahmen ergriffen, z. B. einen Screenshot, einen Fehlerbericht oder eine Logcat-Erfassung.

Zusammenfassung

Öffentliche Bauträger

TestFailureListener ( devices, boolean bugReportOnFailure, boolean rebootOnFailure) TestFailureListener ( devices, boolean bugReportOnFailure, boolean rebootOnFailure)

Öffentliche Methoden

void applyModuleConfiguration (boolean bugreportOnFailure)

Ermöglicht das Überschreiben der Aufrufeinstellungen der Erfassung bei Fehler durch die modulspezifischen Konfigurationen.

void join ()

Treten Sie allen Logcat-Erfassungsthreads bei, um sicherzustellen, dass sie beendet werden.

void setLogger ( ITestLogger logger)

Legt fest, wo die Protokolle gespeichert werden sollen.

void testFailed ( TestDescription test, String trace)

Meldet den Fehler eines einzelnen Testfalls.

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

Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.

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

Leiten Sie das Protokoll an den Logger weiter. Führen Sie dies nicht innerhalb des #testLog-Rückrufs aus, denn wenn TestFailureListener Teil der Kette wäre, würde dies zu einer Endlosschleife führen.

Öffentliche Bauträger

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

Parameter
devices

bugReportOnFailure boolean

rebootOnFailure boolean

Öffentliche Methoden

applyModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

Ermöglicht das Überschreiben der Aufrufeinstellungen der Erfassung bei Fehler durch die modulspezifischen Konfigurationen.

Parameter
bugreportOnFailure boolean : true, um einen Fehlerbericht bei Testfehlern zu erfassen. Sonst falsch.

verbinden

public void join ()

Treten Sie allen Logcat-Erfassungsthreads bei, um sicherzustellen, dass sie beendet werden.

setLogger

public void setLogger (ITestLogger logger)

Legt fest, wo die Protokolle gespeichert werden sollen.

Parameter
logger ITestLogger

im Test durchgefallen

public void testFailed (TestDescription test, 
                String trace)

Meldet den Fehler eines einzelnen Testfalls.

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)

Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.

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

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

Parameter
dataName String : ein String der den Namen der Daten beschreibt. zB „device_logcat“. Beachten Sie, dass dataName pro Aufruf möglicherweise nicht eindeutig ist. Das heißt, Implementierer müssen in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten

dataType LogDataType : der LogDataType der Daten

dataStream InputStreamSource : die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und sicherstellen, dass der resultierende InputStream nach Abschluss geschlossen wird. Aufrufer sollten sicherstellen, dass die Datenquelle vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist.

testLogForward

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

Leiten Sie das Protokoll an den Logger weiter. Führen Sie dies nicht innerhalb des #testLog-Rückrufs aus, denn wenn TestFailureListener Teil der Kette wäre, würde dies zu einer Endlosschleife führen.

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource