日誌保存程式
public interface ILogSaver
com.android.tradefed.result.ILogSaver |
實作此介面的類別提供將日誌儲存到中央位置的方法。
ILogSaver
在配置中聲明,負責將日誌儲存到中央位置。它也公開方法,以便ILogSaverListener
可以將其他檔案保存到相同位置。
概括
公共方法 | |
---|---|
abstract LogFile | getLogReportDir () 取得包含保存日誌的目錄的路徑和/或 URL 的 |
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) 此方法已被棄用。使用 |
default LogFile | saveLogFile (String dataName, LogDataType dataType, File fileToLog) 保存日誌檔。 |
公共方法
取得日誌報告目錄
public abstract LogFile getLogReportDir ()
取得包含保存日誌的目錄的路徑和/或 URL 的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 包含已儲存檔案的路徑和 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。 |
投擲 | |
---|---|
| 如果無法產生日誌文件 |