ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

已知的间接子类 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 是否支持接收精细 结果。  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。

---

监听来自测试调用的测试结果。

一个测试调用本身可以包含多个测试运行，因此调用的顺序将是

• invocationStarted(BuildInfo)
• testRunStarted
• testStarted
• [测试失败]
• 测试结束
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [调用失败]
• [testLog+]
• 调用已结束
• getSummary

摘要

公共方法
default TestSummary	getSummary() 允许 InvocationListener 返回摘要。
default void	invocationEnded(long elapsedTime) 报告调用已终止（无论是成功终止还是由于某些错误） 条件。
default void	invocationFailed(FailureDescription failure) 由于某些错误情况，报告不完整的调用。
default void	invocationFailed(Throwable cause) 由于某些错误情况，报告不完整的调用。
default void	invocationInterrupted() 在调度器关闭时调用，让调用有机会在调度器关闭之前执行某些操作 终止。
default void	invocationSkipped(SkipReason reason) 将调用报告为跳过
default void	invocationStarted(IInvocationContext context) 报告测试调用的开始。
default void	testModuleEnded() 报告模块运行结束。
default void	testModuleStarted(IInvocationContext moduleContext) 报告正在运行的模块的开始。

公共方法

getSummary

public TestSummary getSummary ()

允许 InvocationListener 返回摘要。

返回
TestSummary	汇总运行作业的 TestSummary，或 null

invocationEnded

public void invocationEnded (long elapsedTime)

报告调用已终止（无论是成功终止还是由于某些错误） 条件。

将由 TradeFederation 框架自动调用。

参数
elapsedTime	long：调用所用的时间（以毫秒为单位）

invocationFailed

public void invocationFailed (FailureDescription failure)

由于某些错误情况，报告不完整的调用。

将由 TradeFederation 框架自动调用。

参数
failure	FailureDescription：描述失败原因的 FailureDescription

invocationFailed

public void invocationFailed (Throwable cause)

由于某些错误情况，报告不完整的调用。

将由 TradeFederation 框架自动调用。

参数
cause	Throwable：失败的 Throwable 原因

调用已中断

public void invocationInterrupted ()

在调度器关闭时调用，让调用有机会在调度器关闭之前执行某些操作 终止。

已跳过调用

public void invocationSkipped (SkipReason reason)

将调用报告为跳过

参数
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。报告者需要覆盖 此方法支持多设备报告。

参数
context	IInvocationContext：调用的相关信息

testModuleEnded

public void testModuleEnded ()

报告模块运行结束。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

报告正在运行的模块的开始。此回调与 testModuleEnded() 相关联，在序列中是可选的。它仅在使用 module：基于套件的运行程序。

参数
moduleContext	IInvocationContext：模块的 IInvocationContext。