日志保存程序

public interface ILogSaver

com.android.tradefed.result.ILogSaver


实现此接口的类提供将日志存储到中央位置的方法。

ILogSaver在配置中声明,负责将日志存储到中央位置。它还公开方法,以便ILogSaverListener可以将其他文件保存到同一位置。

概括

公共方法

abstract LogFile getLogReportDir ()

获取包含保存日志的目录的路径和/或 URL 的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 ()

获取包含保存日志的目录的路径和/或 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。

投掷
如果无法生成日志文件