此页面由 Cloud Translation API 翻译。

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver 接口

已知的间接子类

ATestFileSystemLogSaver	ATest 使用此 LogSaver 类将日志保存在特定路径中。
ClusterLogSaver（集群日志保存者）	`ILogSaver` 类，用于将测试输出上传到 TFC。
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)` <ph type="x-smartling-placeholder"></ph> 此方法已被弃用。改用 `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)

报告调用已终止（无论是成功终止还是由于某些错误）条件。

稍后由 TradeFederation 框架自动调用调用 ITestInvocationListener#invocationEnded(long)。

参数
`elapsedTime`	`long`：调用所用的时间（以毫秒为单位）

public abstract void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将在以下日期之前由 TradeFederation 框架自动调用：调用 ITestInvocationListener#invocationStarted(IInvocationContext)。

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

<ph type="x-smartling-placeholder"></ph> 此方法已废弃。
改用 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`。

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