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

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知間接子類別

ATestFileSystemLogSaver	ATest 會使用這個 LogSaver 類別將記錄儲存在特定路徑中。
ClusterLogSaver	用於上傳測試輸出內容至 TFC 的 `ILogSaver` 類別。
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)。

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

public abstract void invocationStarted (IInvocationContext context)

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

會由 TradeFederation 架構自動呼叫，早於系統會呼叫 ITestInvocationListener#invocationStarted(IInvocationContext)。

參數
`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 架構會自動呼叫。這可能會也能做為儲存其他記錄資料的輔助方法。

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

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

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

擲回
	如果無法產生記錄檔

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

此方法已淘汰。
改用 saveLogData(String, com.android.tradefed.result.LogDataType, InputStream)

一種輔助方法，可在未經修改的情況下儲存記錄資料。

記錄檔可能會儲存在交易無法存取的位置。

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

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

擲回
	如果無法產生記錄檔

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

儲存記錄檔。

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

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

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

擲回
	如果無法產生記錄檔