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

此页面由 Cloud Translation API 翻译。

FileSystemLogSaver

public class FileSystemLogSaver
extends Object implements ILogSaver

java.lang.Object
↳	com.android.tradefed.result.FileSystemLogSaver

已知的直接子类

ATestFileSystemLogSaver ATest 使用此 LogSaver 类将日志保存在特定路径中。

将日志保存到文件系统。

摘要

公共构造函数
`FileSystemLogSaver()`

公共方法
`LogFile`	`getLogReportDir()` 获取包含日志保存目录的路径和/或网址的 `LogFile`。
`void`	`invocationEnded(long elapsedTime)` 报告调用已终止，无论是成功终止还是因某种错误条件而终止。
`void`	`invocationStarted(IInvocationContext context)` 报告测试调用的开始。此外，请在 `report-dir/[branch/]build-id/test-tag/unique_dir` 下创建一个唯一的文件系统目录以保存日志。
`LogFile`	`saveLogData(String dataName, LogDataType dataType, InputStream dataStream)` 保存日志数据。如果 `LogDataType.isCompressed()` 针对 `dataType` 返回 false 且 `compressed-files` 已设置，则会压缩并保存日志文件；否则，将以未压缩的形式保存数据流。
`LogFile`	`saveLogFile(String dataName, LogDataType dataType, File fileToLog)` 保存日志文件。
`void`	`setCompressFiles(boolean compress)`

受保护的方法
`File`	`generateLogReportDir(IBuildInfo buildInfo, File reportDir)` 一个公开的方法，允许子类自定义生成路径逻辑。

public FileSystemLogSaver ()

public LogFile getLogReportDir ()

获取包含日志保存目录的路径和/或网址的 LogFile。

返回
`LogFile`	`LogFile`。

public void invocationEnded (long elapsedTime)

报告调用已终止，无论是成功终止还是因某种错误条件而终止。

在调用 ITestInvocationListener.invocationEnded(long) 后，TradeFederation 框架会自动调用此方法。

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

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

在调用 ITestInvocationListener.invocationStarted(IInvocationContext) 之前，TradeFederation 框架会自动调用此方法。

此外，请在 report-dir/[branch/]build-id/test-tag/unique_dir 下创建一个唯一的文件系统目录以保存日志。如果目录创建失败，则会将日志写入本地文件系统上的临时目录。

参数
`context`	`IInvocationContext`：有关调用的相关信息。

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

保存日志数据。

每当调用 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 时，TradeFederation 框架都会自动调用此方法。它还可用作辅助方法来保存其他日志数据。

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

如果 LogDataType.isCompressed() 针对 dataType 返回 false 且 compressed-files 已设置，则会压缩并保存日志文件；否则，将以未压缩的形式保存数据流。

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

public void setCompressFiles (boolean compress)

参数
`compress`	`boolean`

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir)

一个公开的方法，允许子类自定义生成路径逻辑。

参数
`buildInfo`	`IBuildInfo`：`IBuildInfo`
`reportDir`	`File`：报告目录的 `ERROR(/File)`。

返回
`File`	创建的目录。