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 和其他 49 个。 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 覆盖率测量结果，并将其记录为测试工件。  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 使用 statsd 实用程序命令从主机端收集 statsd 指标的 IMetricCollector。  IMetricCollector 报告测试结果时，系统会将此接口添加为装饰器，以便收集匹配的指标。  IPostProcessor Post processors 是一种 Trade Federation 对象，用于在测试之后和结果报告之前处理指标和日志。  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 结果报告程序仅报告模块级结果。  PerfettoGenericPostProcessor 一种后处理程序，通过递归展开包含字符串值的 proto 消息和字段，直到遇到包含数值的字段，将文本/二进制指标 Perfetto proto 文件处理为键值对。  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector 的基础实现，允许从设备中提取 Perfetto 文件并从中收集指标。  ProtoResultReporter 结果报告程序会构建一个包含所有结果的 TestRecord protobuf。  RebootReasonCollector 收集测试运行期间设备重启情况的收集器，并按原因和计数报告这些情况。  ReportPassedTests 在文件中报告可能的过滤条件，以排除已通过的测试。  ResultAggregator 一种特殊的转发器，可根据所采用的重试策略，在需要时汇总结果。  ResultAndLogForwarder 用于转发结果和日志事件的转发器。  RetryLogSaverResultForwarder 转发器，也负责传递我们所处的当前尝试。  RuntimeRestartCollector 该收集器用于收集测试运行期间运行时重启（系统服务器崩溃）的时间戳（如果有）。  ScreenshotOnFailureCollector 在测试用例失败时捕获并记录屏幕截图的收集器。  ShardListener 用于从调用分片（也称为在多个资源上并行运行的调用分块）收集结果并将其转发给另一个监听器的 ITestInvocationListener。  ShardMainResultForwarder 用于组合分片测试调用的结果的 ResultForwarder。  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector 的基础实现，允许从设备中提取 showmap 文件并从中收集指标。  StatsdBeforeAfterGaugeMetricPostProcessor 用于处理以“前/后”方式收集的平均值指标的后处理器，即 StatsdEventMetricPostProcessor 一个后处理程序，用于使用处理器上指定的格式设置将 statsd 报告中的事件指标处理为键值对。  StatsdGenericPostProcessor 一种后置处理器，通过将二进制 proto 统计信息报告扩展为树结构，将报告处理为键值对。  StreamProtoResultReporter ProtoResultReporter 的实现 SubprocessResultsReporter 实现要指定为 result_reporter 的 ITestInvocationListener，并从子进程转发测试、测试运行和测试调用的结果。  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：数据的 String 描述性名称，例如“device_logcat”。注意：每次调用时，dataName 可能不唯一。即，实现者必须能够处理具有相同 dataName 的多次调用
dataType	LogDataType：数据的 LogDataType
dataStream	InputStreamSource：数据的 InputStreamSource。实现人员应调用 createInputStream 以开始读取数据，并确保在完成后关闭生成的 InputStream。
logFile	LogFile：包含已保存文件的元数据的 LogFile。