此页面由 Cloud Translation API 翻译。

日志保存程序

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知的间接子类

ATestFileSystemLogSaver	ATest 使用该 LogSaver 类将日志保存在特定路径中。
集群日志保存器	用于将测试输出上传到 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` ：数据的`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)

保存日志文件。

根据实施和策略，日志可能以压缩形式保存。日志也可能存储在 Tradefed 无法访问的位置。

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

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

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