自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

已知的间接子类

ATestFileSystemLogSaver	ATest 使用此 LogSaver 类将日志保存在特定路径中。
AndroidBuildApiLogSaver	一种将日志文件保存到 Android Build API 的类。
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`：数据的描述性名称。例如“device_logcat”`String`
`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`：数据的描述性名称。例如“device_logcat”。`String`
`dataType`	`LogDataType`：包含文件类型和扩展名的 `LogDataType`
`dataStream`	`InputStream`：数据的 `ERROR(/InputStream)`。

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

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

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

保存日志文件。

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

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

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

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