自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知間接子類別

ATestFileSystemLogSaver	ATest 會使用這個 LogSaver 類別，將記錄檔儲存在特定路徑中。
AndroidBuildApiLogSaver	這個類別會將記錄檔儲存至 Android Build API。
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) 後，TradeFederation 架構會自動呼叫這個方法。

參數
`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 架構就會自動呼叫這個方法。這個方法也可用於儲存額外的記錄資料。

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

參數
`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)

這個 Helper 方法會儲存未修改的記錄資料。

記錄可能儲存在 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`。

擲回
	如果無法產生記錄檔