LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
   ↳ com.android.tradefed.result.ResultForwarder
     ↳ com.android.tradefed.result.LogSaverResultForwarder

Ein ResultForwarder zum Speichern von Protokollen mit dem globalen Datei-Saver.

Zusammenfassung

Öffentliche Konstruktoren

LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)

Öffentliche Methoden

void invocationEnded(long elapsedTime)

Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.

void invocationStarted(IInvocationContext context)

Gibt den Beginn der Testausführung an.

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.

static void logFile( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)

Vor Abschluss eine finale Datei protokollieren

static void reportEndHostLog( listeners, ILogSaver saver, String name)

Berichtet „host_log“ aus einer laufenden Sitzung.

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

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

Speichere außerdem die Protokolldatei mit dem globalen ILogSaver und rufe ILogSaverListener.testLogSaved(String, LogDataType, InputStreamSource, LogFile) für die Listener auf, die die ILogSaverListener-Schnittstelle implementieren.

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

Reichen Sie nur das Testprotokoll ein, anstatt es zuerst zu speichern.

void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

Wenn LogSaverResultForwarder in einem anderen Element verpackt ist, muss der Rückruf „testLogSaved“ an die darunter liegenden Listener weitergeleitet werden.

Öffentliche Konstruktoren

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

Parameter
logSaver ILogSaver

listeners

config IConfiguration

Öffentliche Methoden

invocationEnded

public 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

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 für mehrere Geräte zu unterstützen.

Parameter
context IInvocationContext: Informationen zur Aufrufung

logAssociation

public 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 LogFile, die zuvor protokolliert wurde und mit dem Testfall verknüpft werden soll.

logFile

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

Vor Abschluss eine finale Datei protokollieren

Parameter
listeners

saver ILogSaver

source InputStreamSource

name String

type LogDataType

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

Berichtet „host_log“ aus einer laufenden Sitzung.

Parameter
listeners

saver ILogSaver

name String

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.

Speichere außerdem die Protokolldatei mit dem globalen ILogSaver und rufe ILogSaverListener.testLogSaved(String, LogDataType, InputStreamSource, LogFile) für die Listener auf, die die ILogSaverListener-Schnittstelle implementieren.

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)

Reichen Sie nur das Testprotokoll ein, anstatt es zuerst zu speichern.

Parameter
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Wird aufgerufen, wenn das Testprotokoll gespeichert wird.

Sollte anstelle von ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) verwendet werden.

Wenn LogSaverResultForwarder in einem anderen Element verpackt ist, muss der Rückruf „testLogSaved“ an die darunter liegenden Listener weitergeleitet werden.

Parameter
dataName String: Ein String aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis: „dataName“ muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also mehrere Aufrufe mit demselben „dataName“ verarbeiten können.
dataType LogDataType: die LogDataType der Daten
dataStream InputStreamSource: die InputStreamSource der Daten. Implementer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss schließen.
logFile LogFile: die LogFile mit den Metadaten der gespeicherten Datei.