ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

已知的间接子类 在<p>AggregatePostProcessor、AtracePostProcessor、AtraceCollect20 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 在测试用例失败时收集 bug 报告。  BugreportzOnTestCaseFailureCollector 当运行中的测试用例失败时收集 bugreportz。  ClangCodeCoverageCollector 一个 BaseDeviceMetricCollector，用于拉取 Clang 测量结果，并将其记录为测试工件。  CollectingTestListener 将收集所有测试结果的 ITestInvocationListener。  ConsoleResultReporter 结果报告程序，用于将测试结果输出到控制台。  CountTestCasesCollector 统计并报告给定 IRemoteTest 的测试用例数量。  DebugHostLogOnFailureCollector 收集器，用于在测试用例失败时收集并记录主机端日志。  DeviceTraceCollector 该收集器将在测试运行开始时启动 Perfetto 跟踪记录，并在测试结束时记录跟踪文件。  EventsLoggerListener 将收到的所有事件记录到文件的监听器 FileProtoResultReporter 用于将 TestRecord 转储到文件的 Proto 报告程序。  FilePullerDeviceMetricCollector 一个 BaseDeviceMetricCollector，用于监听来自设备的指标键并拉取 从设备中导入和导出应用  FilePullerLogCollector 设备端报告的文件的记录器。  FormattedGeneratorReporter 允许生成特定格式的报告的报告程序。  GcovCodeCoverageCollector 用于拉取 gcov 的 BaseDeviceMetricCollector 测量结果，并将其记录为测试工件。  GcovKernelCodeCoverageCollector 用于拉取 gcov 内核的 BaseDeviceMetricCollector 在 debugfs 和在设备之外进行覆盖率测量，最后将其记录为测试 工件  GranularRetriableTestWrapper.StartEndCollector 用于捕获缺失的运行开始和结束的类辅助程序。  HostStatsdMetricCollector 一个使用 statsd 实用程序从主机端收集 statsd 指标的 IMetricCollector 命令。  IMetricCollector 报告测试结果时，系统会将此接口添加为装饰器，以便收集 匹配指标。  IPostProcessor Post processors 是一种 Trade Federation 对象，旨在允许处理指标和日志 测试之后和结果报告之前。  JavaCodeCoverageCollector 用于拉取 Java 的 BaseDeviceMetricCollector 测量结果，并将其记录为测试工件。  JsonHttpTestResultReporter 结果报告程序，可将测试结果和分支、设备信息编码为 JSON 和 POST HTTP 服务端点 LUCIResultReporter 一个结果报告程序，用于保存 ResultDB 和 LUCI 所需的测试结果 转换为 JSON 格式 (go/result-sink)，并在控制台中记录文件位置。  LegacySubprocessResultsReporter 子进程结果报告程序的冻结实现，应与 早期版本的 TF/CTS（例如 8 及更高版本），尽管其父类发生了变化。  LogSaverResultForwarder ResultForwarder，用于通过全局文件保存程序保存日志。  LogcatOnFailureCollector 当测试用例失败时，将捕获并记录 logcat 的收集器。  LogcatTimingMetricCollector 一个指标收集器，用于从 logcat 收集时间信息（例如，用户切换时间） 通过使用给定的正则表达式模式来解析 该事件对象。  MetricFilePostProcessor 用于上传在测试和运行级别收集的指标日志文件。  MetricsXMLResultReporter MetricsXMLResultReporter 将测试指标和运行指标写入指定文件夹内的 XML 文件中 。  ModuleListener 附加到每个模块的每个 IRemoteTest 的监听器，以便收集 结果。  ModuleLogcatCollector logcat 收集器的版本，但适用于模块。  PerfettoGenericPostProcessor 后期处理器，通过 以递归方式扩展带字符串值的 proto 消息和字段，直到带有 遇到数值。  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector 的基本实现，允许 从设备中提取 Perfetto 文件并从中收集指标。  ProtoResultReporter 结果报告程序会构建一个包含所有结果的 TestRecord protobuf。  RebootReasonCollector 收集器，在测试运行期间收集设备重新启动数据，并按原因和计数进行报告。  ReportPassedTests 文件中的报告可能会用来排除已通过测试的过滤条件。  ResultAggregator 一种特殊转发器，可根据已安排的重试策略，根据需要汇总结果 。  ResultAndLogForwarder 用于结果和日志事件的转发器。  RetryLogSaverResultForwarder 转发器，也负责传递我们所处的当前尝试。  RuntimeRestartCollector 收集器，用于收集测试期间运行时重启（系统服务器崩溃）的时间戳 若有，则会发生该错误  ScreenshotOnFailureCollector 收集器，用于在测试用例失败时捕获并记录屏幕截图。  ShardListener（分片监听器） 一个 ITestInvocationListener，用于收集调用分片（也称为 调用拆分以并行运行多个资源），并将其转发到另一个资源 监听器。  ShardMainResultForwarder 一个 ResultForwarder，用于合并分片测试调用的结果。  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector 的基本实现，允许拉取节目地图 文件，并从设备中收集指标。  StatsdBeforeAfterGaugeMetricPostProcessor 后期处理程序，处理在“之前/之后”收集的测量指标方法，即 StatsdEventMetricPostProcessor 使用 处理器上指定的格式处理工具。  StatsdGenericPostProcessor 后处理器，通过扩展 采用树形结构的报告  StreamProtoResultReporter ProtoResultReporter 的实现 SubprocessResultsReporter 实现 ITestInvocationListener，以将其指定为 result_reporter 并从 子处理测试结果、测试运行情况、测试调用。  SuiteResultReporter 收集整个套件调用的测试结果，并输出最终结果。  TextResultReporter 用于将结果转发到 JUnit 文本结果打印机的测试结果报告程序。  TraceCmdCollector 一个 IMetricCollector，用于在测试期间使用 trace-cmd 收集跟踪记录并将其记录到 调用。  XmlFormattedGeneratorReporter FormattedGeneratorReporter 的实现，用于为套件结果设置 xml 格式 格式。  XmlResultReporter 以与以下项一致的格式将 JUnit 结果写入 XML 文件 Ant 的 XMLJUnitResultFormatter。

---

允许 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。