ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

已知的间接子类 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 的测试用例数量。  CountingTestResultListener 一个 TestResultListener，用于按 TestStatus 跟踪测试总数 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 收集整个套件调用的测试结果，并输出最终结果。  TestResultListener 中 ITestLifecycleListener 进行了简化，适合只关心单个测试的实现者 结果。  TestTimeoutEnforcer 允许检查给定测试用例的执行时间并在成功时失败的监听器 指定超时值  TextResultReporter 用于将结果转发到 JUnit 文本结果打印机的测试结果报告程序。  TraceCmdCollector 一个 IMetricCollector，用于在测试期间使用 trace-cmd 收集跟踪记录并将其记录到 调用。  TradefedSandboxRunner.StubScheduledInvocationListener 不执行任何操作的桩 IScheduledInvocationListener。  XmlFormattedGeneratorReporter FormattedGeneratorReporter 的实现，用于为套件结果设置 xml 格式 格式。  XmlResultReporter 以与以下项一致的格式将 JUnit 结果写入 XML 文件 Ant 的 XMLJUnitResultFormatter。

---

在插桩测试运行期间接收事件通知。

在 org.junit.runner.notification.RunListener 之后有图案

调用的顺序如下：

• testRunStarted
• testStarted
• [测试失败]
• [testAssumptionFailure]
• [testIgnored]
• 测试结束
• ...
• [testRunFailed]
• testRunEnded

摘要

公共方法
default void	testAssumptionFailure(TestDescription test, String trace) 在原子测试标记它假设条件为 false 时调用
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) 在原子测试标记它假设条件为 false 时调用
default void	testEnded(TestDescription test, long endTime, testMetrics) ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方法，可用于指定结束时间 。
default void	testEnded(TestDescription test, testMetrics) 报告单个测试用例的执行结束。
default void	testFailed(TestDescription test, FailureDescription failure) 报告单个测试用例的失败情况。
default void	testFailed(TestDescription test, String trace) 报告单个测试用例的失败情况。
default void	testIgnored(TestDescription test) 在不会运行测试时调用，通常是因为测试方法带有 org.junit.Ignore。
default void	testRunEnded(long elapsedTimeMillis, runMetrics) 报告测试运行结束。
default void	testRunFailed(FailureDescription failure) 由于“FailureDescription”所述的失败情况，未能完成报告测试运行。
default void	testRunFailed(String errorMessage) 由于出现严重错误，未能完成报告测试运行。
default void	testRunStarted(String runName, int testCount, int attemptNumber) 报告测试运行开始。
default void	testRunStarted(String runName, int testCount) 报告测试运行开始。
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) 报告测试运行开始。
default void	testRunStopped(long elapsedTime) 由于用户请求，报告测试运行在完成之前停止。
default void	testSkipped(TestDescription test, SkipReason reason) 在因通常不符合预期的原因跳过测试且未执行测试时调用。
default void	testStarted(TestDescription test, long startTime) testStarted(com.android.tradefed.result.TestDescription) 的替代方法，其中我们还指定了测试 开始，并结合 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 进行准确测量。
default void	testStarted(TestDescription test) 报告单个测试用例的开始。

公共方法

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

在原子测试标记它假设条件为 false 时调用

参数
test	TestDescription：标识测试
trace	String：失败的堆栈轨迹

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

在原子测试标记它假设条件为 false 时调用

参数
test	TestDescription：标识测试
failure	FailureDescription：描述失败情况及其上下文的 FailureDescription。

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方法，可用于指定结束时间 。与 testStarted(com.android.tradefed.result.TestDescription, long) 结合使用以实现准确的测量。

参数
test	TestDescription：标识测试
endTime	long：测试结束时间，通过 System.currentTimeMillis() 衡量
testMetrics	：发出的指标的 ERROR(/Map)

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

报告单个测试用例的执行结束。

如果未调用 testFailed(TestDescription, FailureDescription)，则表示此测试已通过。同时返回任意键/值 可能在测试用例执行期间发出的指标。

参数
test	TestDescription：标识测试
testMetrics	：发出的指标的 ERROR(/Map)

测试失败

public void testFailed (TestDescription test, 
                FailureDescription failure)

报告单个测试用例的失败情况。

将在 testStarted 和 testEnded 之间调用。

参数
test	TestDescription：标识测试
failure	FailureDescription：描述失败情况及其上下文的 FailureDescription。

测试失败

public void testFailed (TestDescription test, 
                String trace)

报告单个测试用例的失败情况。

将在 testStarted 和 testEnded 之间调用。

参数
test	TestDescription：标识测试
trace	String：失败的堆栈轨迹

testIgnored

public void testIgnored (TestDescription test)

在不会运行测试时调用，通常是因为测试方法带有 org.junit.Ignore。

参数
test	TestDescription：标识测试

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

报告测试运行结束。FIXME：不能有两个 Map<>具有不同类型的接口 我们在这里必须使用 HashMap。

参数
elapsedTimeMillis	long：设备报告的所用时间（以毫秒为单位）
runMetrics	：通过 Metric 运行测试运行结束时报告的键值对。

testRunFailed

public void testRunFailed (FailureDescription failure)

由于“FailureDescription”所述的失败情况，未能完成报告测试运行。

参数
failure	FailureDescription：描述失败情况及其上下文的 FailureDescription。

testRunFailed

public void testRunFailed (String errorMessage)

由于出现严重错误，未能完成报告测试运行。

参数
errorMessage	String：String，用于说明运行失败的原因。

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

报告测试运行开始。

参数
runName	String：测试运行名称
testCount	int：测试运行中的测试总数
attemptNumber	int：订单号，用于标识同一 runName 的不同尝试 运行多次的命令tryNumber 从 0 开始编号，并且应该每次递增。 都会发生新的运行例如测试会精细地重试 3 次，总共应该有 4 次 以相同的 runName 运行，而 tryNumber 范围为 0 到 3。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

报告测试运行开始。

参数
runName	String：测试运行名称
testCount	int：测试运行中的测试总数

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

报告测试运行开始。

参数
runName	String：测试运行名称
testCount	int：测试运行中的测试总数
attemptNumber	int：订单号，用于标识同一 runName 的不同尝试 运行多次的命令tryNumber 从 0 开始编号，并且应在每次 都会发生新的运行例如测试会精细地重试 3 次，总共应运行 4 次 在同一 runName 下运行，并且 tryNumber 范围是 0 到 3。
startTime	long：运行开始的时间，通过 System.currentTimeMillis() 测量

testRunStopped

public void testRunStopped (long elapsedTime)

由于用户请求，报告测试运行在完成之前停止。

TODO：目前未使用，请考虑移除

参数
elapsedTime	long：设备报告的所用时间（以毫秒为单位）

testSkipped（已跳过测试）

public void testSkipped (TestDescription test, 
                SkipReason reason)

在因通常不符合预期的原因跳过测试且未执行测试时调用。 系统将尝试重新尝试这些测试，以确保正确执行。

参数
test	TestDescription：标识测试
reason	SkipReason：SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription) 的替代方法，其中我们还指定了测试 开始，并结合 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 进行准确测量。

参数
test	TestDescription：标识测试
startTime	long：测试的开始时间，通过 System.currentTimeMillis() 测量

testStarted

public void testStarted (TestDescription test)

报告单个测试用例的开始。旧版接口，应尽可能使用 testStarted(com.android.tradefed.result.TestDescription)。

参数
test	TestDescription：标识测试