ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知間接子類別 ATestFileSystemLogSaver、ClusterLogSaver、FileSystemLogSaver ATestFileSystemLogSaver ATest 會使用這個 LogSaver 類別，在特定路徑中儲存記錄檔。  ClusterLogSaver ILogSaver 類別，可將測試輸出內容上傳至 TFC。  FileSystemLogSaver 將記錄儲存至檔案系統。

---

實作此介面的類別會提供方法，用於將記錄儲存至集中位置。

設定中會宣告 ILogSaver，負責將記錄儲存在集中位置。它也會公開方法，讓 ILogSaverListener 將其他檔案儲存到相同位置。

摘要

公用方法
abstract LogFile	getLogReportDir() 取得包含記錄儲存目錄路徑和/或網址的 LogFile。
default void	init(IInvocationContext context) 在任何建構資訊可用之前，提早通知初始化。
abstract void	invocationEnded(long elapsedTime) 回報叫用已終止，無論是成功或因某些錯誤條件而終止。
abstract void	invocationStarted(IInvocationContext context) 回報測試叫用作業的開始時間。
abstract LogFile	saveLogData(String dataName, LogDataType dataType, InputStream dataStream) 儲存記錄資料。
default LogFile	saveLogDataRaw(String dataName, LogDataType dataType, InputStream dataStream) 這個方法已淘汰。 改用 saveLogData(String, com.android.tradefed.result.LogDataType, InputStream)
default LogFile	saveLogFile(String dataName, LogDataType dataType, File fileToLog) 儲存記錄檔。

公用方法

getLogReportDir

public abstract LogFile getLogReportDir ()

取得包含記錄儲存目錄路徑和/或網址的 LogFile。

傳回
LogFile	LogFile。

init

public void init (IInvocationContext context)

在任何建構資訊可用之前，提早通知初始化作業。這可讓您設定接收記錄檔的任何必要條件。

參數
context	IInvocationContext：叫用作業相關資訊。

invocationEnded

public abstract void invocationEnded (long elapsedTime)

回報叫用已終止，無論是成功或因某些錯誤條件而終止。

系統會在呼叫 ITestInvocationListener.invocationEnded(long) 後，自動呼叫 TradeFederation 架構。

參數
elapsedTime	long：叫用作業的經過時間 (以毫秒為單位)

invocationStarted

public abstract void invocationStarted (IInvocationContext context)

回報測試叫用作業的開始時間。

在呼叫 ITestInvocationListener.invocationStarted(IInvocationContext) 之前，TradeFederation 架構會自動呼叫此方法。

參數
context	IInvocationContext：叫用作業相關資訊。

saveLogData

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

儲存記錄資料。

每當呼叫 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 時，TradeFederation 架構就會自動呼叫此函式。也可以用做輔助方法，用於儲存其他記錄資料。

視導入方式和政策而定，記錄可能會以壓縮格式儲存。記錄檔也可能儲存在 Tradefed 無法存取的位置。

參數
dataName	String：資料的String描述性名稱，例如「device_logcat」
dataType	LogDataType：檔案的 LogDataType。
dataStream	InputStream：資料的 ERROR(/InputStream)。

傳回
LogFile	LogFile 包含儲存檔案的路徑和網址。

擲回
	如果無法產生記錄檔

saveLogDataRaw

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

This method is deprecated.
請改用 saveLogData(String, com.android.tradefed.result.LogDataType, InputStream)

用於儲存未經修改的記錄資料的輔助方法。

記錄檔可能儲存在 Tradefed 無法存取的位置。

參數
dataName	String：資料的 String 描述性名稱，例如「device_logcat」。
dataType	LogDataType：包含檔案類型和副檔名的 LogDataType
dataStream	InputStream：資料的 ERROR(/InputStream)。

傳回
LogFile	LogFile 包含儲存檔案的路徑和網址。

擲回
	如果無法產生記錄檔

saveLogFile

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

儲存記錄檔。

只要呼叫 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 且串流參照檔案，TradeFederation 架構就會自動呼叫此方法。

視導入方式和政策而定，記錄可能會以壓縮格式儲存。記錄檔也可能儲存在 Tradefed 無法存取的位置。

參數
dataName	String：資料的String描述性名稱，例如「device_logcat」
dataType	LogDataType：檔案的 LogDataType。
fileToLog	File：要儲存的 ERROR(/File)。

傳回
LogFile	LogFile 包含儲存檔案的路徑和網址。

擲回
	如果無法產生記錄檔