ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

已知的间接子类 AggregatePostProcessor、AtraceCollector2 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 信息收集日志记录，并收集每项测试的日志。  BugreportCollector 一个传递 ITestInvocationListener，用于在可配置事件时收集 bug 报告 发生，然后在每次发生后对其子级调用 ITestInvocationListener#testLog 收集错误报告  BugreportzOnFailureCollector 在测试用例失败时收集 bug 报告。  BugreportzOnTestCaseFailureCollector 当运行中的测试用例失败时收集 bugreportz。  ClangCodeCoverageCollector 一个 BaseDeviceMetricCollector，用于拉取 Clang 测量结果，并将其记录为测试工件。  CollectingTestListener 将收集所有测试结果的 ITestInvocationListener。  CommandStatusHandler 帮助监控和更新调用状态的处理程序。  ConditionFailureMonitor 监控调用引起的任何失败情况。  ConsoleResultReporter 结果报告程序，用于将测试结果输出到控制台。  CountTestCasesCollector 统计并报告给定 IRemoteTest 的测试用例数量。  DebugHostLogOnFailureCollector 收集器，用于在测试用例失败时收集并记录主机端日志。  DeviceReleaseReporter 负责处理与要作为设备的父级进程通信的设备版本报告程序 发布。  DeviceTraceCollector 该收集器将在测试运行开始时启动 Perfetto 跟踪记录，并在测试结束时记录跟踪文件。  DeviceUnavailableMonitor 此监听器尝试仅捕获测试用例级 DNAE。  EventsLoggerListener 将收到的所有事件记录到文件的监听器 FileProtoResultReporter 用于将 TestRecord 转储到文件的 Proto 报告程序。  FilePullerDeviceMetricCollector 一个 BaseDeviceMetricCollector，用于监听来自设备的指标键并拉取 从设备中导入和导出应用  FilePullerLogCollector 设备端报告的文件的记录器。  FilteredResultForwarder ResultForwarder 的变体，仅允许将 TestDescription 的许可名单 被举报。  FormattedGeneratorReporter 允许生成特定格式的报告的报告程序。  GcovCodeCoverageCollector 用于拉取 gcov 的 BaseDeviceMetricCollector 测量结果，并将其记录为测试工件。  GcovKernelCodeCoverageCollector 用于拉取 gcov 内核的 BaseDeviceMetricCollector 在 debugfs 和在设备之外进行覆盖率测量，最后将其记录为测试 工件  GranularRetriableTestWrapper.StartEndCollector 用于捕获缺失的运行开始和结束的类辅助程序。  HostStatsdMetricCollector 一个使用 statsd 实用程序从主机端收集 statsd 指标的 IMetricCollector 命令。  ICommandScheduler.IScheduledInvocationListener 在调用完成时监听调用事件。  ILogSaverListener 允许 ITestInvocationListener 监听日志文件的保存时间。  IMetricCollector 在报告测试结果时，系统会将此接口添加为装饰器，以便收集 匹配指标。  IPostProcessor Post processors 是一种 Trade Federation 对象，旨在允许处理指标和日志 测试之后和结果报告之前。  IShardableListener 可分片的 ITestInvocationListener。  ISupportGranularResults 指定 ITestInvocationListener 是否支持接收精细 结果。  ITestInvocationListener 监听来自测试调用的测试结果。  ITestSummaryListener 可让 ITestInvocationListener 通过 摘要。  InvocationToJUnitResultForwarder 一个用于监听 ITestInvocationListener 事件并将其转发给 TestListener。  JarHostTest.HostTestListener 一个封装容器监听器，用于将除 testRunStarted() 和 testRunEnded() 之外的所有事件转发给 嵌入式监听器。  JavaCodeCoverageCollector 用于拉取 Java 的 BaseDeviceMetricCollector 测量结果，并将其记录为测试工件。  JsonHttpTestResultReporter 结果报告程序，可将测试结果和分支、设备信息编码为 JSON 和 POST HTTP 服务端点 LUCIResultReporter 一个结果报告程序，用于保存 ResultDB 和 LUCI 所需的测试结果 转换为 JSON 格式 (go/result-sink)，并在控制台中记录文件位置。  LastShardDetector 运行本地分片时，有时我们只想对最后一个分片执行某些操作， 达到 invocationEnded(long)。  LegacySubprocessResultsReporter 子进程结果报告程序的冻结实现，应与 早期版本的 TF/CTS（例如 8 及更高版本），尽管其父类发生了变化。  LogSaverResultForwarder ResultForwarder，用于通过全局文件保存程序保存日志。  LogcatCrashResultForwarder 特殊监听器：在失败（插桩进程崩溃）时，它会尝试从 logcat，并将其添加到与测试关联的失败消息中。  LogcatOnFailureCollector 当测试用例失败时，将捕获并记录 logcat 的收集器。  LogcatTimingMetricCollector 一个指标收集器，用于从 logcat 收集时间信息（例如，用户切换时间） 通过使用给定的正则表达式模式来解析 该事件对象。  MetricFilePostProcessor 用于上传在测试和运行级别收集的指标日志文件。  MetricsXMLResultReporter MetricsXMLResultReporter 将测试指标和运行指标写入指定文件夹内的 XML 文件中 。  ModuleListener 附加到每个模块的每个 IRemoteTest 的监听器，以便收集 结果。  ModuleLogcatCollector logcat 收集器的版本，但适用于模块。  NameMangleListener 一个代理监听器，用于在报告结果时转换测试方法、类和软件包名称。  PassingTestFileReporter 一个 ITestInvocationListener，用于将传递的测试用例的列表保存到测试文件 PerfettoGenericPostProcessor 后期处理器，通过 以递归方式扩展带字符串值的 proto 消息和字段，直到带有 遇到数值。  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector 的基本实现，允许 从设备中提取 Perfetto 文件并从中收集指标。  PrettyTestEventLogger 用于匹配事件的日志记录器，请记录这些事件，以便更轻松地进行调试。  ProtoResultReporter 结果报告程序会构建一个包含所有结果的 TestRecord protobuf。  PythonBinaryHostTest.PythonForwarder 结果转发器，用于将运行名称替换为二进制文件名称。  RebootReasonCollector 收集器，在测试运行期间收集设备重新启动数据，并按原因和计数进行报告。  RemoteTestTimeOutEnforcer 允许检查给定测试配置的执行时间并在测试成功时失败的监听器 指定超时值  ReportPassedTests 文件中的报告可能会用来排除已通过测试的过滤条件。  ResultAggregator 根据之前使用的重试策略，根据需要汇总结果的特殊转发器 。  ResultAndLogForwarder 用于结果和日志事件的转发器。  ResultForwarder 一个 ITestInvocationListener，用于将调用结果转发给一系列其他监听器。  RetryLogSaverResultForwarder 转发器，也负责传递我们所处的当前尝试。  tryResultForwarder ResultForwarder 的扩展，始终推送到给定尝试编号。  RuntimeRestartCollector 收集器，用于收集测试期间运行时重启（系统服务器崩溃）的时间戳 若有，则会发生该错误  ScreenshotOnFailureCollector 收集器，用于在测试用例失败时捕获并记录屏幕截图。  ShardListener（分片监听器） 一个 ITestInvocationListener，用于收集调用分片（也称为 调用拆分以并行运行多个资源），并将其转发到另一个资源 监听器。  ShardMainResultForwarder 一个 ResultForwarder，用于合并分片测试调用的结果。  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector 的基本实现，允许拉取节目地图 文件，并从设备中收集指标。  StatsdBeforeAfterGaugeMetricPostProcessor 后期处理程序，处理在“之前/之后”收集的测量指标方法，即 StatsdEventMetricPostProcessor 使用 处理器上指定的格式处理工具。  StatsdGenericPostProcessor 后处理器，通过扩展 采用树形结构的报告  StreamProtoResultReporter ProtoResultReporter 的实现 SubprocessResultsReporter 实现 ITestInvocationListener，以将其指定为 result_reporter 并从 子处理测试结果、测试运行情况、测试调用。  SuiteResultReporter 收集整个套件调用的测试结果，并输出最终结果。  TestTimeoutEnforcer 允许检查给定测试用例的执行时间并在成功时失败的监听器 指定超时值  TextResultReporter 用于将结果转发到 JUnit 文本结果打印机的测试结果报告程序。  TraceCmdCollector 一个 IMetricCollector，用于在测试期间使用 trace-cmd 收集跟踪记录并将其记录到 调用。  TradefedSandboxRunner.StubScheduledInvocationListener 不执行任何操作的桩 IScheduledInvocationListener。  XmlFormattedGeneratorReporter FormattedGeneratorReporter 的实现，用于为套件结果设置 xml 格式 格式。  XmlResultReporter 以与以下项一致的格式将 JUnit 结果写入 XML 文件 Ant 的 XMLJUnitResultFormatter。

---

可以对各种类型的数据流执行日志记录的实体。

摘要

公共方法
default void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) 提供来自测试调用的关联日志或调试数据。

公共方法

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

提供来自测试调用的关联日志或调试数据。

必须在 ERROR(/ITestInvocationListener#invocationFailed(Throwable)) 或之前调用 ERROR(/ITestInvocationListener#invocationEnded(long))

TradeFederation 框架将自动调用此方法，并提供主机日志 以及设备 logcat（如果适用）。

参数
dataName	String：数据的 String 描述性名称。例如“device_logcat”。注意事项 每次调用的 dataName 可能不唯一。例如，实施人员必须能够处理 具有相同 dataName 的多个调用
dataType	LogDataType：数据的 LogDataType
dataStream	InputStreamSource：数据的 InputStreamSource。实现人员应调用 createInputStream 以开始读取数据，并确保关闭生成的 InputStream。调用方应确保数据的来源保持不变 存在且可访问，直到 testLog 方法完成为止。