此页面由 Cloud Translation API 翻译。

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

已知的间接子类

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , and 72 others.

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

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

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

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

概括

公共方法
`default TestSummary`	`getSummary ()` 允许 InvocationListener 返回摘要。
`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 ()

允许 InvocationListener 返回摘要。

退货
`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` : 失败的`ERROR(/Throwable)`原因

调用中断

public void invocationInterrupted ()

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

调用开始

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

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

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

测试模块结束

public void testModuleEnded ()

报告模块运行结束。

测试模块启动

public void testModuleStarted (IInvocationContext moduleContext)

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

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