日誌保存程序

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知的間接子類 ATestFileSystemLogSaver 、 ClusterLogSaver 、 FileSystemLogSaver ATestFileSystemLogSaver ATest 使用該 LogSaver 類將日誌保存在特定路徑中。 集群日誌保存器 用於將測試輸出上傳到 TFC 的ILogSaver類。 文件系統日誌保存程序 將日誌保存到文件系統。

---

實現此接口的類提供將日誌存儲到中央位置的方法。

ILogSaver在配置中聲明，負責將日誌存儲到中央位置。它還公開方法，以便ILogSaverListener可以將其他文件保存到同一位置。

概括

公共方法
abstract LogFile	getLogReportDir () 獲取包含保存日誌的目錄的路徑和/或 URL 的LogFile 。
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 ()

獲取包含保存日誌的目錄的路徑和/或 URL 的LogFile 。

退貨
LogFile	LogFile 。

調用結束

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包含已保存文件的路徑和 URL。

投擲
	如果無法生成日誌文件

保存日誌數據原始

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

此方法已被棄用。
使用saveLogData(String, com.android.tradefed.result.LogDataType, InputStream)代替

一種保存未修改的日誌數據的輔助方法。

日誌可能存儲在 Tradefed 無法訪問的位置。

參數
dataName	String ：數據的String描述性名稱。例如“device_logcat”。
dataType	LogDataType ：包含文件類型和擴展名的LogDataType
dataStream	InputStream ：數據的ERROR(/InputStream) 。

退貨
LogFile	LogFile包含已保存文件的路徑和 URL。

投擲
	如果無法生成日誌文件

保存日誌文件

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包含已保存文件的路徑和 URL。

投擲
	如果無法生成日誌文件