此页面由 Cloud Translation API 翻译。

ITest调用监听器

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInitationListener

已知的间接子类

AggregatePostProcessor 、 AtraceCollector 、 AtraceRunMetricCollector 、 AveragePostProcessor 、 BaseDeviceMetricCollector 、 BasePostProcessor 、 BluetoothConnectionLatencyCollector 、 BluetoothConnectionStateCollector 、 BluetoothConnectionSuccessRatePostProcessor 、 BluetoothHciSnoopLogCollector 、 BugreportCollector 、 BugreportzOnFailureCollector 、 BugreportzOnTestCaseFailureCo llector 、 ClangCodeCoverageCollector 、 CollectingTestListener和其他 72 个。

聚合后处理器	度量聚合器，提供多次迭代测试运行期间收集的数字度量的最小值、最大值、平均值、方差、标准差、总计、计数和可选的百分位数，并将它们视为双精度。
Atrace收集器	`IMetricCollector`在测试期间运行 atrace 并收集结果并将其记录到调用中。
AtraceRunMetricCollector	从测试设备的给定目录下的所有测试目录收集跟踪，记录测试目录并对测试目录下的跟踪文件进行后处理并聚合指标。
平均后处理器	计算指标列表平均值的后处理器的实现。
基础设备指标收集器	`IMetricCollector`的基本实现，允许在`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`和`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`上启动和停止收集。
基础后处理器	每个实现都应该扩展的基本`IPostProcessor` 。
蓝牙连接延迟收集器	收集器会将预定义的 statsd 持续时间指标配置推送到设备，并收集每个配置文件的蓝牙连接持续时间。
蓝牙连接状态收集器	该收集器将收集BluetoothConnectionStateChanged 指标并记录每个配置文件的连接状态编号。
蓝牙连接成功率后处理器	计算蓝牙配置文件成功率的后处理器的实现使用“metric-key-match”指定包含数字数组示例中的蓝牙连接状态的指标 [0, 1, 2, 3, 0, 1, 2, 3]。
蓝牙HciSnoopLogCollector	收集器，用于在 DUT 上启用蓝牙 HCI 监听日志记录并收集每个测试的日志。
错误报告收集器	一个传递`ITestInvocationListener` ，它在可配置事件发生时收集错误报告，然后在收集每个错误报告后在其子级上调用`ITestInvocationListener#testLog` 。
BugreportzOnFailureCollector	当测试用例失败时收集错误报告。
BugreportzOnTestCaseFailureCollector	当运行中的测试用例失败时收集错误报告。
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`将从设备中提取 Clang 覆盖率测量结果并将其记录为测试工件。
收集测试监听器	将收集所有测试结果的`ITestInvocationListener` 。
命令状态处理程序	处理程序帮助监视和更新调用的状态。
状态故障监视器	监视调用中是否有任何失败。
控制台结果报告器	结果报告器将测试结果打印到控制台。
计数测试用例收集器	计算并报告给定`IRemoteTest`测试用例数量。
调试主机登录失败收集器	当测试用例发生故障时，收集器将收集并记录主机端日志。
设备发布报告器	设备释放报告器，用于处理与要释放的设备的父进程的通信。
设备跟踪收集器	收集器将在测试运行开始时启动 perfetto 跟踪并在结束时记录跟踪文件。
设备不可用监视器	此侦听器仅尝试捕获测试用例级别的 DNAE。
事件记录监听器	将接收到的所有事件记录到文件中的侦听器
文件原型结果报告器	将`TestRecord`转储到文件中的原型报告器。
FilePullerDeviceMetricCollector	一个`BaseDeviceMetricCollector` ，用于侦听来自设备的指标键并将它们作为文件从设备中提取。
文件拉取日志收集器	设备端上报的文件记录器。
过滤结果转发器	`ResultForwarder`的变体，仅允许报告`TestDescription`的白名单。
格式化生成器报告器	允许生成特定格式报告的报告器。
GcovCodeCoverageCollector	一个`BaseDeviceMetricCollector` ，将从设备中提取 gcov 覆盖率测量结果并将其记录为测试工件。
GcovKernelCodeCoverageCollector	一个`BaseDeviceMetricCollector` ，它将从 debugfs 和设备中提取 gcov 内核覆盖率测量结果，然后最终将它们记录为测试工件。
GranularRetriableTestWrapper.StartEndCollector	用于捕获丢失的运行开始和结束的类助手。
HostStatsdMetricCollector	`IMetricCollector` ，使用 statsd 实用程序命令从主机端收集 statsd 指标。
ICommandScheduler.IScheduledInitationListener	调用完成时调用事件的侦听器。
ILogSaver监听器	允许`ITestInvocationListener`监听日志文件的保存时间。
度量收集器	在报告测试结果时，该接口将作为装饰器添加，以收集匹配的指标。
后置处理器	后处理器是一个 Trade Federation 对象，旨在允许在测试之后和结果报告之前处理指标和日志。
IShardableListener	可以分片的`ITestInvocationListener` 。
ISupport粒度结果	指定`ITestInvocationListener`是否支持接收粒度结果的接口。
ITestSummaryListener	允许`ITestInvocationListener`通过摘要交换一些有限信息的接口。
调用到JUnitResultForwarder	侦听`ITestInvocationListener`事件并将其转发到`TestListener`类。
JarHostTest.HostTestListener	包装侦听器，将除 testRunStarted() 和 testRunEnded() 之外的所有事件转发到嵌入式侦听器。
Java代码覆盖率收集器	`BaseDeviceMetricCollector`将从设备中提取 Java 覆盖率测量结果并将其记录为测试工件。
JsonHttpTestResultReporter	结果报告器，将测试指标结果和分支、设备信息编码为 JSON 并 POST 到 HTTP 服务端点
最后碎片检测器	当运行本地分片时，有时我们只想在最后一个分片到达`invocationEnded(long)`时执行一些操作。
旧版子流程结果报告器	子流程结果报告器的冻结实现，尽管其超类发生了变化，但仍应与早期版本的 TF/CTS（例如 8+）保持兼容。
LogSaver结果转发器	用于使用全局文件保护程序保存日志的`ResultForwarder` 。
LogcatCrashResultForwarder	特殊侦听器：发生故障（检测进程崩溃）时，它将尝试从 logcat 中提取崩溃并将其添加到与测试关联的失败消息中。
LogcatOnFailureCollector 日志收集器	当测试用例失败时，收集器将捕获并记录 logcat。
LogcatTimingMetricCollector	一种度量收集器，通过使用给定的正则表达式模式从 logcat 行解析事件的开始和结束信号，在一个或多个重复测试期间从 logcat 收集计时信息（例如用户切换时间）。
度量文件后处理器	用于上传测试和运行级别期间收集的指标日志文件。
MetricsXML结果报告器	MetricsXMLResultReporter 将测试指标和运行指标写入到由测试的 incallEnded 阶段的metrics-folder参数指定的文件夹中的XML文件中。
模块监听器	侦听器附加到每个模块的每个`IRemoteTest`以收集结果列表。
模块LogcatCollector	logcat 收集器的版本，但用于模块。
名称MangleListener	代理侦听器，用于在报告结果时翻译测试方法、类和包名称。
通过测试文件报告器	将传递的测试用例列表保存到测试文件的`ITestInvocationListener`
完美通用后处理器	后处理器，通过递归扩展原始消息和具有字符串值的字段，直到遇到具有数值的字段，将文本/二进制度量 perfetto 原始文件处理为键值对。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector`的基本实现，允许从设备中提取 perfetto 文件并从中收集指标。
PrettyTestEventLogger	记录器匹配事件并记录它们以便更容易调试。
原型结果报告器	结果报告器构建一个`TestRecord` protobuf，其中包含所有结果。
PythonBinaryHostTest.PythonForwarder	结果转发器用二进制名称替换运行名称。
重启原因收集器	收集器在测试运行期间收集设备重新启动并按原因和计数进行报告。
远程测试超时执行器	允许检查给定测试配置的执行时间的侦听器，如果超过给定的超时则使测试失败。
报告通过测试	在文件中报告可能的过滤器以排除通过的测试。
结果聚合器	特殊转发器，根据所采取的重试策略，在需要时聚合结果。
结果和日志转发器	结果和日志事件的转发器。
结果转发器	将调用结果转发到其他侦听器列表的`ITestInvocationListener` 。
RetryLogSaverResultForwarder	转发器还处理传递我们当前的尝试。
重试结果转发器	`ResultForwarder`的扩展，始终推送到给定的尝试次数。
运行时重启收集器	收集测试运行期间运行时重新启动（系统服务器崩溃）时间戳的收集器（如果有）。
故障收集器屏幕截图	当测试用例失败时，收集器将捕获并记录屏幕截图。
分片监听器	一个`ITestInvocationListener` ，用于从调用分片（也称为在多个资源上并行运行的调用拆分）收集结果，并将它们转发到另一个侦听器。
ShardMainResultForwarder	合并分片测试调用结果的`ResultForwarder` 。
显示地图PullerMetricCollector	`FilePullerDeviceMetricCollector`的基本实现，允许从设备中提取显示地图文件并从中收集指标。
StatsdBeforeAfterGaugeMetricPostProcessor	后处理器，处理以“之前/之后”方法收集的仪表指标，即
统计事件度量后处理器	后处理器，使用处理器上指定的格式化程序将 statsd 报告中的事件指标处理为键值对。
统计通用后处理器	后处理器，通过将报告扩展为树结构，将二进制原始 statsd 报告处理为键值对。
StreamProtoResultReporter	`ProtoResultReporter`的实现
子流程结果报告器	实现`ITestInvocationListener`以指定为 result_reporter 并从子流程转发测试、测试运行、测试调用的结果。
套件结果报告器	收集整个套件调用的测试结果并输出最终结果。
测试失败监听器	侦听器用于在测试失败时根据请求采取操作，例如屏幕截图、错误报告、logcat 收集。
测试超时执行器	允许检查给定测试用例的执行时间的侦听器，如果超过给定的超时则失败。
文本结果报告器	将结果转发到 JUnit 文本结果打印机的测试结果报告器。
跟踪命令收集器	`IMetricCollector`在测试期间使用trace-cmd 收集跟踪，并将其记录到调用中。
TradefedSandboxRunner.StubScheduledInitationListener	一个不执行任何操作的存根`IScheduledInvocationListener` 。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter`的实现将套件格式化为 xml 格式。
Xml结果报告器	以与 Ant 的 XMLJUnitResultFormatter 一致的格式将 JUnit 结果写入 XML 文件。

测试调用的测试结果的侦听器。

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

调用开始（构建信息）
测试运行开始
测试开始
[测试失败]
测试结束
...
测试运行结束
...
测试运行开始
...
测试运行结束
[调用失败]
[测试日志+]
调用结束
获取摘要

概括

公共方法
`default TestSummary`	`getSummary ()` 允许 IncationListener 返回摘要。
`default void`	`invocationEnded (long elapsedTime)` 报告调用已终止，无论是成功还是由于某些错误情况。
`default void`	`invocationFailed ( FailureDescription failure)` 由于某些错误情况而报告不完整的调用。
`default void`	`invocationFailed (Throwable cause)` 由于某些错误情况而报告不完整的调用。
`default void`	`invocationInterrupted ()` 在调度程序关闭时调用，使调用有机会在终止之前执行某些操作。
`default void`	`invocationStarted ( IInvocationContext context)` 报告测试调用的开始。
`default void`	`testModuleEnded ()` 报告模块运行结束。
`default void`	`testModuleStarted ( IInvocationContext moduleContext)` 报告模块运行的开始。

公共方法

获取摘要

public TestSummary getSummary ()

允许 IncationListener 返回摘要。

退货
`TestSummary`	总结运行的`TestSummary` ，或 null

调用结束

public void invocationEnded (long elapsedTime)

报告调用已终止，无论是成功还是由于某些错误情况。

将由 TradeFederation 框架自动调用。

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

调用失败

public void invocationFailed (FailureDescription failure)

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

将由 TradeFederation 框架自动调用。

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

调用失败

public void invocationFailed (Throwable cause)

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

将由 TradeFederation 框架自动调用。

参数
`cause`	`Throwable` ：失败的`Throwable`原因

调用中断

public void invocationInterrupted ()

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

调用开始

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。记者需要重写此方法以支持多设备报告。

参数
`context`	`IInvocationContext` ：有关调用的信息

测试模块结束

public void testModuleEnded ()

报告模块运行结束。

测试模块启动

public void testModuleStarted (IInvocationContext moduleContext)

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

参数
`moduleContext`	`IInvocationContext` ：模块的`IInvocationContext` 。