本頁面由 Cloud Translation API 翻譯而成。

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知間接子類別

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)` 儲存記錄檔。

public abstract LogFile getLogReportDir ()

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

傳回
`LogFile`	`LogFile`。

public void init (IInvocationContext context)

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

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

public abstract void invocationEnded (long elapsedTime)

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

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

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

public abstract void invocationStarted (IInvocationContext context)

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

會在 ITestInvocationListener.invocationStarted(IInvocationContext) 呼叫前，由 TradeFederation 架構自動呼叫。

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

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` 包含儲存檔案的路徑和網址。

擲回
	如果無法產生記錄檔

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

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

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

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

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

擲回
	如果無法產生記錄檔

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

儲存記錄檔。

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

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

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

擲回
	如果無法產生記錄檔