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

此页面由 Cloud Translation API 翻译。

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

已知的间接子类

AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector、CollectingTestListener 以及其他 57 个。

AggregatePostProcessor	一种指标聚合器，用于提供多次迭代测试运行期间收集的数值指标的最小值、最大值、平均值、方差、标准差、总和、数量，以及可选的百分位数（将这些指标视为双精度浮点数）。
AtraceCollector	一种在测试期间运行 atrace 并收集结果和日志，然后将它们记录到调用中的 `IMetricCollector`。
AtraceRunMetricCollector	从测试设备收集给定目录下的所有测试目录中的轨迹，记录测试目录，对测试目录下的轨迹文件进行后处理并汇总指标。
AveragePostProcessor	实现后处理器，用于计算指标列表的平均值。
BaseDeviceMetricCollector	`IMetricCollector` 的基本实现，允许在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上开始和停止收集。
BasePostProcessor	每个实现都应扩展的基本 `IPostProcessor`。
BluetoothConnectionLatencyCollector	收集器会将预定义的 statsd 时长指标配置推送到设备，并收集每个配置文件的蓝牙连接时长。
BluetoothConnectionStateCollector	此收集器将收集 BluetoothConnectionStateChanged 指标，并记录每个配置的连接状态编号。
BluetoothConnectionSuccessRatePostProcessor	实现用于计算蓝牙配置文件成功率的后处理器使用“metric-key-match”指定包含蓝牙连接状态（以数字数组表示）的指标，例如 [0, 1, 2, 3, 0, 1, 2, 3]。
BluetoothHciSnoopLogCollector	用于在 DUT 上启用蓝牙 HCI 信息收集日志记录并收集每次测试的日志的收集器。
BugreportzOnFailureCollector	在测试用例失败时收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在运行中的测试用例失败时收集 bugreportz。
ClangCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备拉取 Clang 覆盖率测量结果并将其记录为测试制品。
CodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备中提取 Java 和原生覆盖率测量结果，并将其记录为测试制品。
CollectingTestListener	用于收集所有测试结果的 `ITestInvocationListener`。
ConsoleResultReporter	用于将测试结果输出到控制台的结果报告程序。
CountTestCasesCollector	统计并报告给定 `IRemoteTest` 的测试用例数量。
DebugHostLogOnFailureCollector	一种收集器，用于在测试用例失败时收集并记录主机端日志。
DeviceTraceCollector	在测试运行开始时启动 Perfetto 跟踪，并在结束时记录跟踪文件的收集器。
EventsLoggerListener	将接收到的所有事件记录到文件中的监听器
FileProtoResultReporter	将 `TestRecord` 转储到文件中的 Proto 报告器。
FilePullerDeviceMetricCollector	一个 `BaseDeviceMetricCollector`，用于监听来自设备的指标密钥，并以文件形式从设备拉取这些密钥。
FilePullerLogCollector	设备端报告的文件的记录器。
FormattedGeneratorReporter	允许以特定格式生成报告的报告器。
GcovCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备中提取 gcov 覆盖率测量结果，并将其记录为测试制品。
GcovKernelCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从 debugfs 和设备中提取 gcov 内核覆盖率测量结果，然后最终将其记录为测试制品。
GranularRetriableTestWrapper.StartEndCollector	用于捕获缺失的跑步开始和结束的类辅助程序。
HostStatsdMetricCollector	一种 `IMetricCollector`，用于使用 statsd 实用程序命令从主机端收集 statsd 指标。
IMetricCollector	在报告测试结果时，此接口将作为装饰器添加，以便收集匹配的指标。
IPostProcessor	后处理器是一种 Trade Federation 对象，旨在允许在测试结束后和报告结果之前处理指标和日志。
InvocationProtoResultReporter	用于存储调用级缓存信息及其模块列表的报告器
JavaCodeCoverageCollector	一个 `BaseDeviceMetricCollector`，用于从设备拉取 Java 覆盖率测量结果并将其记录为测试制品。
JsonHttpTestResultReporter	一种结果报告程序，可将测试指标结果和分支、设备信息编码为 JSON 并 POST 到 HTTP 服务端点
LUCIResultReporter	一种结果报告程序，可将 ResultDB 和 LUCI 所需的测试结果保存为 JSON 格式 (go/result-sink)，并在控制台中记录文件位置。
LegacySubprocessResultsReporter	子进程结果报告器的冻结实现，尽管其超类发生了变化，但仍应与旧版 TF/CTS（例如 8 及更高版本）保持兼容。
LogSaverResultForwarder	用于使用全局文件保存程序保存日志的 `ResultForwarder`。
LogcatOnFailureCollector	在测试用例失败时捕获并记录 logcat 的收集器。
LogcatTimingMetricCollector	一种指标收集器，通过使用给定的正则表达式模式从 logcat 行解析事件的开始和结束信号，在一次或多次重复测试期间从 logcat 收集时间信息（例如用户切换时间）。
MetricFilePostProcessor	用于上传在测试和运行级别收集的指标日志文件。
MetricsXMLResultReporter	MetricsXMLResultReporter 会在测试的 invocationEnded 阶段将测试指标和运行指标写入 metrics-folder 参数指定的文件夹中的 XML 文件。
ModuleListener	附加到每个模块的每个 `IRemoteTest` 的监听器，用于收集结果列表。
ModuleLogcatCollector	logcat 收集器的版本（但适用于模块）。
ModuleProtoResultReporter	一种旨在仅报告模块级结果的结果报告程序。
ModuleResultsAndMetricsForwarder	`ResultAndLogForwarder` 的扩展，可向测试结果添加额外的模块相关指标。
PerfettoFilePullerCollector	一种收集器，用于从设备拉取 Perfetto 轨迹文件，可选择性地压缩这些文件，并将其添加到测试日志中。
PerfettoGenericPostProcessor	一种后处理器，用于通过以下方式将文本/二进制指标 perfetto proto 文件处理为键值对：以递归方式展开具有字符串值的 proto 消息和字段，直到遇到具有数值的字段。
PerfettoPullerMetricCollector	此类已弃用。请改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
PerfettoTracePostProcessor	一种后处理器，用于从测试日志中检索 Perfetto 轨迹文件，并在这些文件上运行轨迹处理器以生成 Perfetto 指标 proto。
ProtoResultReporter	结果报告程序会构建一个包含所有结果的 `TestRecord` protobuf。
RebootReasonCollector	收集器，用于收集测试运行期间的设备重启情况，并按原因和次数报告。
RemoteTestTimeOutEnforcer	监听器，用于检查给定测试配置的执行时间，如果超过给定的超时时间，则使测试失败。
ReportPassedTests	报告了文件中的可能过滤条件，以排除通过的测试。
ResultAggregator	一种特殊的转发器，可根据所采取的重试策略在需要时汇总结果。
ResultAndLogForwarder	用于转发结果和日志事件的转发器。
ResultDBReporter	将测试结果上传到 ResultDB 的结果报告程序。
ResultReporter
RetryLogSaverResultForwarder	转发器，还负责传递当前尝试次数。
RuntimeRestartCollector	用于收集测试运行期间运行时重启（系统服务器崩溃）的时间戳（如有）。
ScreenshotOnFailureCollector	在测试用例失败时捕获并记录屏幕截图的收集器。
ShardListener	一种 `ITestInvocationListener`，用于从调用分片（即拆分后的调用，可在多个资源上并行运行）收集结果，并将结果转发给另一个监听器。
ShardMainResultForwarder	一种用于合并分片测试调用结果的 `ResultForwarder`。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本实现，允许从设备拉取 showmap 文件并从中收集指标。
StatsdBeforeAfterGaugeMetricPostProcessor	一种后处理器，用于处理以“前后”方式（即
StatsdEventMetricPostProcessor	一种后处理器，用于使用处理器上指定的格式化程序将 statsd 报告中的事件指标处理为键值对。
StatsdGenericPostProcessor	一种后处理器，用于通过将二进制 proto statsd 报告扩展为树结构，将其处理为键值对。
StreamProtoResultReporter	`ProtoResultReporter` 的实现
SubprocessResultsReporter	实现 `ITestInvocationListener` 以指定为 result_reporter，并从子进程转发测试、测试运行、测试调用的结果。
SuiteResultReporter	收集整个套件调用的测试结果，并输出最终结果。
TextResultReporter	一种测试结果报告程序，可将结果转发给 JUnit 文本结果打印程序。
TraceCmdCollector	一个 `IMetricCollector`，用于在测试期间使用 trace-cmd 收集轨迹，并将轨迹记录到调用中。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter` 的实现，用于以 XML 格式设置测试套件结果的格式。
XmlResultReporter	以与 Ant 的 XMLJUnitResultFormatter 一致的格式将 JUnit 结果写入 XML 文件。

允许 ITestInvocationListener 监听日志文件何时保存。

这样一来，多个 ITestInvocationListener 在生成报告时可以使用同一已保存的日志文件，并且避免了在调用 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 时让每个监听器单独保存文件。

实现此接口的类应注意，每当调用 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 时，系统都会调用 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)。

此类还会传递全局 ILogSaver 实例，以便 ITestInvocationListener 可以将其他文件保存到同一位置。

摘要

公共方法
`default void`	`logAssociation(String dataName, LogFile logFile)` 在某些情况下，日志必须与测试用例紧密关联，但无法在直接 `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` 回调中实现此目的。
`default void`	`setLogSaver(ILogSaver logSaver)` 将 `ILogSaver` 设置为允许实现者保存文件。
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 在保存测试日志时调用。

公共方法

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情况下，日志必须与测试用例紧密关联，但无法在直接 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 回调中实现这一点。因此，此回调允许明确提供强关联。

参数
`dataName`	`String`：数据的名称
`logFile`	`LogFile`：之前记录的 `LogFile`，应与测试用例相关联。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

将 ILogSaver 设置为允许实现者保存文件。

参数
`logSaver`	`ILogSaver`：`ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

在保存测试日志时调用。

应取代 ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) 使用。

参数
`dataName`	`String`：数据的描述性名称。例如“device_logcat”。`String`请注意，dataName 在每次调用时可能不是唯一的。也就是说，实现者必须能够处理具有相同 dataName 的多次调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`dataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现人员应调用 createInputStream 开始读取数据，并确保在完成后关闭生成的 InputStream。
`logFile`	`LogFile`：包含已保存文件的元数据的 `LogFile`。