此页面由 Cloud Translation API 翻译。

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

已知的间接子类

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`。