ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

已知的间接子类

AggregatePostProcessor ， AtraceCollector ， AtraceRunMetricCollector ， AveragePostProcessor ， BaseDeviceMetricCollector ， BasePostProcessor ， BuddyInfoMetricCollector ， BugreportCollector ， BugreportzMetricCollector ， BugreportzOnFailureCollector ， CollectingTestListener ， ConsoleResultReporter ， DebugHostLogOnFumpureCollector Heap ， DeviceUnavaly

AggregatePostProcessor	度量聚合器，它为多次迭代测试运行期间收集的数字度量提供最小值，最大值，均值，方差和标准偏差，并将其视为两倍。
AtraceCollector	一个`IMetricCollector` ，在测试期间运行atrace并收集结果并将其记录到调用中。
AtraceRunMetricCollector	从测试设备的给定目录下的所有测试目录中收集跟踪，记录测试目录，并对测试目录下的跟踪文件进行后处理，并汇总指标。
AveragePostProcessor	实现后处理器，以计算度量标准列表的平均值。
BaseDeviceMetricCollector	`IMetricCollector`基本实现，它允许在`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`和`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`上启动和停止收集。
BasePostProcessor	每个实现都应扩展的基础`IPostProcessor` 。
BuddyInfoMetricCollector	`ScheduledDeviceMetricCollector`用于定期收集碎片。
BugreportCollector	一个传递式`ITestInvocationListener` ，它在发生可配置事件时收集`ITestInvocationListener` ，然后在收集每个`ITestInvocationListener#testLog`报告后在其子`ITestInvocationListener#testLog`上调用`ITestInvocationListener#testLog` 。
BugreportzMetricCollector	`ScheduledDeviceMetricCollector`定期收集压缩的错误报告。
BugreportzOnFailureCollector	测试用例失败时收集错误报告。
收集测试监听器	一个`ITestInvocationListener` ，它将收集所有测试结果。
ConsoleResultReporter	结果报告器将测试结果打印到控制台。
DebugHostLogOnFailureCollector	当发生测试用例失败时，收集器将收集并记录主机端日志。
DeviceUnavailEmailResultReporter	当由于设备不可用异常而导致调用失败时将发送电子邮件的`EmailResultReporter` 。
DumpHeapCollector	`ScheduledDeviceMetricCollector`用于定期收集进程的内存转储。
EmailResultReporter	一个简单的结果报告程序基类，用于发送测试结果的电子邮件。
FailureEmailResultReporter	如果发生测试失败或调用失败，则发送`EmailResultReporter`通知的`EmailResultReporter` 。
FileProtoResultReporter	原始记者，将`TestRecord`转储到文件中。
FilePullerDeviceMetricCollector	一个`BaseDeviceMetricCollector` ，它侦听来自设备的指标密钥，并将其作为文件从设备中拉出。
FilePullerLogCollector	设备端报告的文件的记录器。
FilteredResultForwarder	`ResultForwarder`变体，仅允许报告`TestDescription`的白名单。
FormattedGeneratorReporter	记者，可以生成特定格式的报告。
GraphicsStatsMetricCollector	`ScheduledDeviceMetricCollector`用于定期收集图形统计信息。
HostStatsdMetricCollector	一个`IMetricCollector` ，它使用statsd实用程序命令从主机侧收集statsd度量。
ICommandScheduler.IScheduledInvocationListener	调用完成时的调用事件侦听器。
ILogSaverListener	保存日志文件时，允许`ITestInvocationListener`侦听。
IMetricCollector	报告测试结果时，此接口将被添加为装饰器，以收集匹配的指标。
IPostProcessor	后处理器是一个贸易联盟对象，旨在允许在测试之后和结果报告之前处理指标和日志。
IShardableListener	可以分片的`ITestInvocationListener` 。
ITestSummaryListener	允许`ITestInvocationListener`通过摘要交换一些有限信息的接口。
IncidentReportCollector	拉并处理在设备端报告的事件报告。
InvocationFailureEmailResultReporter	一个`EmailResultReporter` ，它还可以将通知限制为仅调用失败。
InvocationToJUnitResultForwarder	侦听`ITestInvocationListener`事件并将其转发到`TestListener` 。
IonHeapInfoMetricCollector	`ScheduledDeviceMetricCollector`用于定期收集音频和系统内存堆。
JsonHttpTestResultReporter	结果报告器，对测试指标结果进行编码，并将设备信息分支为JSON，然后将POST分支为HTTP服务终结点
LegacySubprocessResultsReporter	与CTS的M＆N版本兼容的冻结子过程结果报告程序的类。
LogSaverResultForwarder	一个`ResultForwarder`用于使用全局文件保护程序保存日志。
LogcatCrashResultForwarder	特殊的侦听器：在失败（仪器进程崩溃）时，它将尝试从logcat中提取崩溃，并将其添加到与测试关联的失败消息中。
LogcatOnFailureCollector	当测试用例失败时，将捕获并记录logcat的收集器。
MemInfoMetricCollector	`ScheduledDeviceMetricCollector`用于定期收集内存转储。
指标XMLResultReporter	MetricsXMLResultReporter在测试的invocationEnded阶段，将测试指标和运行指标写入XML文件夹中由metrics-folder参数指定的文件夹中。
模块监听器	侦听器附加到每个模块的每个`IRemoteTest`以便收集结果列表。
NameMangleListener	报告结果时，将转换测试方法，类和包名称的代理侦听器。
NativeCodeCoverageListener	一个`ResultForwarder` ，它将把本机覆盖率测量值从设备中拉出并将其记录为测试工件。
PagetypeInfoMetricCollector	`ScheduledDeviceMetricCollector`收集可用的页数。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector`基本实现，该实现允许从设备中提取perfetto文件并从中收集指标。
PrettyTestEventLogger	记录器匹配事件并记录它们，以使其更易于调试。
ProcessMaxMemoryCollector	`ScheduledDeviceMetricCollector`用于测量指定进程的峰值内存使用情况。
ProtoResultReporter	结果报告程序构建一个`TestRecord` protobuf，其中包含所有结果。
PythonBinaryHostTest.PythonForwarder	结果转发器用二进制名称替换运行名称。
重新启动原因收集器	在测试运行期间收集设备重新启动的收集器，并按原因和计数报告它们。
ResultAndLogForwarder	结果和日志事件的转发器。
结果转发器	一个`ITestInvocationListener` ，它将调用结果转发到其他侦听器列表。
RetryResultForwarder	`ResultForwarder`的扩展，始终推送到给定的尝试编号。
RuntimeRestartCollector	收集运行时重新启动（系统服务器崩溃）的时间戳的收集器（如果有）。
ScheduleMultipleDeviceMetricCollector	一个`IMetricCollector` ，使之定期运行多个度量收集器。
ScheduledDeviceMetricCollector	一个`IMetricCollector` ，它允许以设置的时间间隔定期运行收集任务。
ScreenshotOnFailureCollector	当测试用例失败时，收集器将捕获并记录屏幕截图。
碎片监听器	一个`ITestInvocationListener` ，它从一个调用碎片（也称为一个拆分为并行运行在多个资源上）中收集结果，并将其转发给另一个侦听器。
碎片大师结果转发器	一个`ResultForwarder` ，它结合了分片测试调用的结果。
StreamProtoResultReporter	`ProtoResultReporter`的实现
SubprocessResultsReporter	实现`ITestInvocationListener` ，将其指定为result_reporter，并从子流程转发测试，测试运行，测试调用的结果。
SuiteResultReporter	收集整个套件调用的测试结果并输出最终结果。
温度收集器	`ScheduledDeviceMetricCollector`用于测量最小和最大设备温度。
TestFailureEmailResultReporter	一个`EmailResultReporter` ，它还可以将通知限制为仅测试失败。
TestFailureListener	当请求失败时，侦听器通常会在测试失败时采取措施，如屏幕截图，错误报告，logcat收集。
TextResultReporter	测试结果报告程序，将结果转发到JUnit文本结果打印机。
TraceCmdCollector	一个`IMetricCollector` ，它在测试过程中使用trace-cmd收集跟踪，并将其记录到调用中。
TraceMetricCollector	一个`ScheduledDeviceMetricCollector`用于定期收集内核调试跟踪。
TradefedSandboxRunner.StubScheduledInvocationListener	一个不执行任何操作的存根`IScheduledInvocationListener` 。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter`套件的`FormattedGeneratorReporter`实现以xml格式进行结果。
XmlResultReporter	将JUnit结果以与Ant的XMLJUnitResultFormatter一致的格式写入XML文件。

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

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

invocationStarted（BuildInfo）
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog +]
调用结束
getSummary

概要

公开方法
`default TestSummary`	`getSummary ()` 允许InvocationListener返回摘要。
`default void`	`invocationEnded (long elapsedTime)` 报告调用已成功终止或由于某些错误情况而终止。
`default void`	`invocationFailed (Throwable cause)` 报告由于某些错误情况而导致的不完整调用。
`default void`	`invocationInterrupted ()` 调用`ICommandScheduler#shutdown()` ，使调用有机会在终止之前做一些事情。
`default void`	`invocationStarted (IInvocationContext context)` 报告测试调用的开始。
`default void`	`testModuleEnded ()` 报告模块运行结束。
`default void`	`testModuleStarted (IInvocationContext moduleContext)` 报告模块运行的开始。

公开方法

getSummary

public TestSummary getSummary ()

允许InvocationListener返回摘要。

退货
`TestSummary`	汇总运行的`TestSummary` ，或者为null

调用结束

public void invocationEnded (long elapsedTime)

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

将由TradeFederation框架自动调用。

参量
`elapsedTime`	`long` ：调用经过的时间（以毫秒为单位）

调用失败

public void invocationFailed (Throwable cause)

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

将由TradeFederation框架自动调用。

参量
`cause`	`Throwable` ：失败的可`Throwable`原因

调用中断

public void invocationInterrupted ()

调用ICommandScheduler#shutdown() ，使调用有机会在终止之前做一些事情。

调用开始

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

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

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

testModuleEnded

public void testModuleEnded ()

报告模块运行结束。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

报告模块运行的开始。该回调与testModuleEnded()相关联，并且在序列中是可选的。它仅在使用以下模块的运行中使用：基于ITestSuite的运行器。

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