ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知的间接子类 ATestFileSystemLogSaver , ClusterLogSaver , FileSystemLogSaver ATestFileSystemLogSaver ATest 使用这个 LogSaver 类将日志保存在特定路径中。 ClusterLogSaver 用于将测试输出上传到 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 ：数据的ERROR(/String)描述性名称。例如“device_logcat”
dataType	LogDataType ：文件的LogDataType 。
dataStream	InputStream ：数据的ERROR(/InputStream) 。

退货
LogFile	包含保存文件的路径和 URL 的LogFile 。

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

保存日志数据原始

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

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

一种保存日志数据未修改的辅助方法。

日志可能存储在 Tradefed 无法访问的位置。

参数
dataName	String ：数据的ERROR(/String)描述性名称。例如“device_logcat”。
dataType	LogDataType ：包含文件类型和扩展名的LogDataType
dataStream	InputStream ：数据的ERROR(/InputStream) 。

退货
LogFile	包含保存文件的路径和 URL 的LogFile 。

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

保存日志文件

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 ：数据的ERROR(/String)描述性名称。例如“device_logcat”
dataType	LogDataType ：文件的LogDataType 。
fileToLog	File ：要保存的ERROR(/File) 。

退货
LogFile	包含保存文件的路径和 URL 的LogFile 。

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