此页面由 Cloud Translation API 翻译。

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知的间接子类

ATestFileSystemLogSaver	ATest 使用此 LogSaver 类将日志保存在特定路径中。
ClusterLogSaver	用于将测试输出上传到 TFC 的 `ILogSaver` 类。
FileSystemLogSaver	将日志保存到文件系统。

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

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

摘要

公共方法
`abstract LogFile`	`getLogReportDir()` 获取包含日志保存目录的路径和/或网址的 `LogFile`。
`default void`	`init(IInvocationContext context)` 在任何 build 信息可用之前，提前通知初始化。
`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)

在任何 build 信息可用之前，提前通知初始化。这样，您就可以设置接收日志的任何要求。

参数
`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`。

抛出
	如果无法生成日志文件

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`。

抛出
	如果无法生成日志文件

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

保存日志文件。

日志可能会以压缩形式保存，具体取决于实现和政策。日志还可以存储在 Tradefed 无法访问的位置。

参数
`dataName`	`String`：数据的 `String` 描述性名称，例如“device_logcat”
`dataType`	`LogDataType`：文件的 `LogDataType`。
`fileToLog`	`File`：要保存的 `ERROR(/File)`。

返回
`LogFile`	包含已保存文件的路径和网址的 `LogFile`。

抛出
	如果无法生成日志文件