ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver


Klasy implementujące ten interfejs udostępniają metody przechowywania logów w centralnej lokalizacji.

A ILogSaver jest deklarowany w konfiguracji i odpowiada za przechowywanie logów w a centralnej lokalizacji. Udostępnia też metody, dzięki którym ILogSaverListener mogą zapisywać dodatkowe pliki w tej samej lokalizacji.

Podsumowanie

Metody publiczne

abstract LogFile getLogReportDir()

Pobiera LogFile zawierający ścieżkę i/lub adres URL katalogu, w którym są zapisywane logi.

default void init(IInvocationContext context)

Wczesne powiadomienie o inicjowaniu, zanim będą dostępne jakiekolwiek informacje o kompilacji.

abstract void invocationEnded(long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się pomyślnie, czy z powodu błędu.

abstract void invocationStarted(IInvocationContext context)

Informuje o rozpoczęciu wywołania testu.

abstract LogFile saveLogData(String dataName, LogDataType dataType, InputStream dataStream)

Zapisuje dane logu.

default LogFile saveLogDataRaw(String dataName, LogDataType dataType, InputStream dataStream)

Ta metoda została wycofana. Zamiast niej użyj metody saveLogData(String,LogDataType,InputStream)

default LogFile saveLogFile(String dataName, LogDataType dataType, File fileToLog)

Zapisuje plik dziennika.

default void testModuleEnded()

Informuje, że moduł testowy został zakończony.

default void testModuleStarted(IInvocationContext context)

Informuje o rozpoczęciu modułu testowego.

Metody publiczne

getLogReportDir

public abstract LogFile getLogReportDir ()

Pobiera LogFile zawierający ścieżkę i/lub adres URL katalogu, w którym są zapisywane logi.

Zwraca
LogFile LogFile.

init

public void init (IInvocationContext context)

Wczesne powiadomienie o inicjowaniu, zanim będą dostępne jakiekolwiek informacje o kompilacji. Pozwala to skonfigurować wymagania dotyczące otrzymywania logów.

Parametry
context IInvocationContext: informacje o wywołaniu.

invocationEnded

public abstract void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się pomyślnie, czy z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation po wywołaniu ITestInvocationListener.invocationEnded(long).

Parametry
elapsedTime long: czas trwania wywołania w milisekundach.

invocationStarted

public abstract void invocationStarted (IInvocationContext context)

Informuje o rozpoczęciu wywołania testu.

Zostanie automatycznie wywołana przez platformę TradeFederation przed wywołaniem ITestInvocationListener.invocationStarted(IInvocationContext).

Parametry
context IInvocationContext: informacje o wywołaniu.

saveLogData

public abstract LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

Zapisuje dane logu.

Zostanie automatycznie wywołana przez platformę TradeFederation, gdy wywołana zostanie metoda ITestInvocationListener.testLog(String,LogDataType,InputStreamSource). Może też służyć jako metoda pomocnicza do zapisywania dodatkowych danych logu.

W zależności od implementacji i zasad logi mogą być zapisywane w postaci skompresowanej. Logi mogą być też przechowywane w lokalizacji niedostępnej dla Tradefed.

Parametry
dataName String: opisowa nazwa danych, np. „device_logcat”.String

dataType LogDataType: LogDataType pliku.

dataStream InputStream: InputStream danych.

Zwraca
LogFile LogFile zawierający ścieżkę i adres URL zapisanego pliku.

Zgłasza
IOException jeśli nie udało się wygenerować pliku dziennika.

saveLogDataRaw

public LogFile saveLogDataRaw (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

Ta metoda została wycofana.
Zamiast niej użyj metody saveLogData(String,LogDataType,InputStream).

Metoda pomocnicza do zapisywania danych logu bez zmian.

Logi mogą być przechowywane w lokalizacji niedostępnej dla Tradefed.

Parametry
dataName String: opisowa nazwa danych, np. "device_logcat".String

dataType LogDataType: LogDataType zawierający typ i rozszerzenie pliku.

dataStream InputStream: InputStream danych.

Zwraca
LogFile LogFile zawierający ścieżkę i adres URL zapisanego pliku.

Zgłasza
IOException jeśli nie udało się wygenerować pliku dziennika.

saveLogFile

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

Zapisuje plik dziennika.

Zostanie automatycznie wywołana przez platformę TradeFederation, gdy wywołana zostanie metoda ITestInvocationListener.testLog(String,LogDataType,InputStreamSource), a strumień będzie odwoływać się do pliku.

W zależności od implementacji i zasad logi mogą być zapisywane w postaci skompresowanej. Logi mogą być też przechowywane w lokalizacji niedostępnej dla Tradefed.

Parametry
dataName String: opisowa nazwa danych, np. „device_logcat”.String

dataType LogDataType: LogDataType pliku.

fileToLog File: File do zapisania.

Zwraca
LogFile LogFile zawierający ścieżkę i adres URL zapisanego pliku.

Zgłasza
IOException jeśli nie udało się wygenerować pliku dziennika.

testModuleEnded

public void testModuleEnded ()

Informuje, że moduł testowy został zakończony.

testModuleStarted

public void testModuleStarted (IInvocationContext context)

Informuje o rozpoczęciu modułu testowego.

Parametry
context IInvocationContext: informacje o module.