自 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 及其他 53 个。

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`，用于从调试文件系统和设备中提取 gcov 内核覆盖率测量结果，并最终将其作为测试工件记录下来。
GranularRetriableTestWrapper.StartEndCollector	用于捕获缺失的运行开始和结束时间的类辅助程序。
HostStatsdMetricCollector	使用 statsd 实用程序命令从主机端收集 statsd 指标的 `IMetricCollector`。
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` 的扩展，用于向测试结果添加额外的模块相关指标。
PerfettoGenericPostProcessor	一种后处理程序，通过递归展开包含字符串值的 proto 消息和字段，直到遇到包含数值的字段，将文本/二进制指标 Perfetto proto 文件处理为键值对。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基础实现，允许从设备中提取 Perfetto 文件并从中收集指标。
ProtoResultReporter	结果报告程序会构建一个包含所有结果的 `TestRecord` protobuf。
RebootReasonCollector	收集测试运行期间设备重启情况的收集器，并按原因和计数报告这些情况。
ReportPassedTests	在文件中报告可能的过滤条件，以排除已通过的测试。
ResultAggregator	一种特殊的转发器，可根据所采用的重试策略，在需要时汇总结果。
ResultAndLogForwarder	用于结果和日志事件的转发器。
ResultDBReporter
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	将 JUnit 结果以与 Ant 的 XMLJUnitResultFormatter 一致的格式写入 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`：数据的 `String` 描述性名称，例如“device_logcat”。注意：每次调用时，dataName 可能不唯一。即，实现者必须能够处理具有相同 dataName 的多次调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`dataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现人员应调用 createInputStream 以开始读取数据，并确保在完成后关闭生成的 InputStream。
`logFile`	`LogFile`：包含已保存文件的元数据的 `LogFile`。