此页面由 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 , CollectingTestListener , ConsoleResultReporter , and 47 others.

聚合后处理器	一个度量聚合器，它为在多次迭代测试运行期间收集的数字度量提供最小值、最大值、平均值、方差、标准差、总数、计数和可选的百分位数，将它们视为双精度数。
跟踪收集器	在测试期间运行 atrace 并收集结果并将其记录到调用中的`IMetricCollector` 。
AtraceRunMetricCollector	从测试设备的给定目录下的所有测试目录中收集跟踪，记录测试目录并后处理测试目录下的跟踪文件并聚合指标。
平均后处理器	计算指标列表平均值的后处理器的实现。
BaseDeviceMetricCollector	`IMetricCollector`的基本实现，允许在`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`和`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`上开始和停止收集。
基础后处理器	每个实现都应该扩展的基础`IPostProcessor` 。
BluetoothConnectionLatencyCollector	收集器会将预定义的 statsd 持续时间指标配置推送到设备，并收集每个配置文件的蓝牙连接持续时间。
蓝牙连接状态收集器	此收集器将收集 BluetoothConnectionStateChanged 指标并记录每个配置文件的连接状态数。
蓝牙连接成功率后处理器	计算蓝牙配置文件成功率的后处理器的实现使用“metric-key-match”指定包含数字数组示例 [0, 1, 2, 3, 0, 1, 2, 3] 中的蓝牙连接状态的指标。
蓝牙HciSnoopLog收集器	收集器，用于在 DUT 上启用蓝牙 HCI 侦听日志记录并收集每个测试的日志。
BugreportzOnFailureCollector	当测试用例失败时收集错误报告。
错误报告 zOnTestCaseFailureCollector	当运行中的测试用例失败时收集错误报告。
ClangCodeCoverageCollector	一个`BaseDeviceMetricCollector` ，它将从设备中提取 Clang 覆盖测量并将它们记录为测试工件。
收集测试监听器	将收集所有测试结果的`ITestInvocationListener` 。
控制台结果报告器	结果报告器将测试结果打印到控制台。
计数测试用例收集器	计算并报告给定`IRemoteTest`测试用例数。
DebugHostLogOnFailureCollector	发生测试用例失败时收集并记录主机端日志的收集器。
设备跟踪收集器	收集器将在测试运行开始时启动 perfetto trace 并在结束时记录跟踪文件。
事件记录器监听器	将接收到的所有事件记录到文件中的侦听器
FileProtoResultReporter	将`TestRecord`转储到文件中的原型记者。
FilePullerDeviceMetricCollector	一个`BaseDeviceMetricCollector` ，它侦听来自设备的指标键并将它们作为文件从设备中提取。
FilePuller日志收集器	设备端上报文件的Logger。
FormattedGeneratorReporter	允许以特定格式生成报告的记者。
GcovCodeCoverageCollector	一个`BaseDeviceMetricCollector` ，它将从设备中提取 gcov 覆盖测量并将它们记录为测试工件。
GcovKernelCodeCoverageCollector	一个`BaseDeviceMetricCollector` ，它将 gcov 内核覆盖测量从 debugfs 和设备中拉出，然后最终将它们记录为测试工件。
GranularRetriableTestWrapper.StartEndCollector	捕捉缺失的运行开始和结束的类助手。
HostStatsdMetricCollector	一个`IMetricCollector` ，它使用 statsd 实用程序命令从主机端收集 statsd 指标。
指标收集器	当报告测试结果以收集匹配指标时，此接口将作为装饰器添加。
后处理器	后处理器是一个 Trade Federation 对象，旨在允许在测试之后和结果报告之前处理指标和日志。
JavaCodeCoverageCollector	一个`BaseDeviceMetricCollector` ，它将从设备中提取 Java 覆盖率测量并将它们记录为测试工件。
JsonHttpTestResultReporter	将测试指标结果和分支、设备信息编码为 JSON 并 POST 到 HTTP 服务端点的结果报告器
LegacySubprocessResultsReporter	子流程结果报告器的冻结实现，尽管其超类发生了变化，但仍应与早期版本的 TF/CTS（例如 8+）兼容。
LogSaverResultForwarder	用于使用全局文件保护程序保存日志的`ResultForwarder` 。
LogcatOnFailure 收集器	当测试用例失败时将捕获并记录 logcat 的收集器。
LogcatTimingMetricCollector	一种度量收集器，通过使用给定的正则表达式模式从 logcat 行解析事件的开始和结束信号，在一次或多次重复测试期间从 logcat 收集计时信息（例如用户切换时间）。
公制文件后处理器	用于上传在测试和运行级别收集的指标日志文件。
指标 XMLResultReporter	MetricsXMLResultReporter 在测试的 invocationEnded 阶段将测试指标和运行指标写入 metrics-folder 参数指定的文件夹中的 XML 文件。
模块监听器	附加到每个模块的每个`IRemoteTest`侦听器，以收集结果列表。
模块LogcatCollector	logcat 收集器的版本，但用于模块。
PerfettoGeneric后处理器	一个后处理器，通过递归地扩展原始消息和具有字符串值的字段，直到遇到具有数值的字段，将文本/二进制度量 perfetto proto 文件处理成键值对。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector`的基本实现，允许从设备中拉取 perfetto 文件并从中收集指标。
ProtoResultReporter	结果报告器构建一个包含所有结果的`TestRecord` protobuf。
重启原因收集器	在测试运行期间收集设备重启并按原因和计数报告的收集器。
报告通过测试	在文件中报告可能的过滤器以排除通过的测试。
结果聚合器	根据所采用的重试策略，在需要时聚合结果的特殊转发器。
结果和日志转发器	结果和日志事件的转发器。
RetryLogSaverResultForwarder	还处理传递我们当前尝试的转发器。
运行时重启收集器	收集测试运行期间运行时重启（系统服务器崩溃）时间戳的收集器（如果有）。
ScreenshotOnFailure收集器	当测试用例失败时将捕获并记录屏幕截图的收集器。
分片监听器	一个`ITestInvocationListener` ，它从调用分片（又名调用拆分以并行运行在多个资源上）收集结果，并将它们转发给另一个侦听器。
ShardMainResultForwarder	一个`ResultForwarder` ，它结合了分片测试调用的结果。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector`的基本实现，它允许从设备中拉取显示地图文件并从中收集指标。
StatsdBeforeAfterGaugeMetricPostProcessor	一个后处理器，它处理以“之前/之后”的方式收集的测量指标，即
StatsdEventMetric后处理器	使用处理器上指定的格式化程序将 statsd 报告中的事件指标处理为键值对的后处理器。
Statsd通用后处理器	通过将报告扩展为树结构，将二进制原型 statsd 报告处理为键值对的后处理器。
StreamProtoResultReporter	`ProtoResultReporter`的实现
子进程结果报告器	实现`ITestInvocationListener`以指定为 result_reporter 并从子进程转发测试、测试运行、测试调用的结果。
套件结果报告器	收集整个套件调用的测试结果并输出最终结果。
文本结果报告器	将结果转发到 JUnit 文本结果打印机的测试结果报告器。
跟踪命令收集器	一个`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)被调用。

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

此类还传递全局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)` 保存测试日志时调用。

公共方法

日志关联

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` ，应该与测试用例相关联。

设置日志保存器

public void setLogSaver (ILogSaver logSaver)

设置ILogSaver以允许实施者保存文件。

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

测试日志已保存

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

保存测试日志时调用。

应该用来代替ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) 。

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