此页面由 Cloud Translation API 翻译。

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

已知的间接子类

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , and 75 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`测试用例数。
计数测试结果监听器	通过`TestStatus`跟踪测试总数的`TestResultListener`
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`是否支持接收粒度结果的接口。
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 收集等操作。
测试结果监听器	为只关心单个测试结果的实施者简化 ITestLifecycleListener。
测试超时执行器	允许检查给定测试用例的执行时间并在超过给定超时时失败的侦听器。
文本结果报告器	将结果转发到 JUnit 文本结果打印机的测试结果报告程序。
跟踪命令收集器	一个`IMetricCollector` ，它在测试期间使用 trace-cmd 收集跟踪，并将它们记录到调用中。
TradefedSandboxRunner.StubScheduledInvocationListener	什么都不做的存根`IScheduledInvocationListener` 。
XmlFormattedGeneratorReporter	`FormattedGeneratorReporter`的实现将套件格式化为 xml 格式。
XmlResultReporter	以与 Ant 的 XMLJUnitResultFormatter 一致的格式将 JUnit 结果写入 XML 文件。

在仪器测试运行期间接收事件通知。

模仿 org.junit.runner.notification.RunListener

调用顺序将是：

测试运行开始
测试开始
[测试失败]
[测试假设失败]
[测试忽略]
测试结束
....
[测试运行失败]
测试运行结束

概括

公共方法
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` 当原子测试标记它假定条件为假时调用
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` 当原子测试标记它假定条件为假时调用
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`的替代方法，我们可以在其中直接指定结束时间。
`default void`	`testEnded ( TestDescription test, testMetrics)` `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)` `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`	`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)` 报告单个测试用例的开始。

公共方法

测试假设失败

public void testAssumptionFailure (TestDescription test, 
                String trace)

当原子测试标记它假定条件为假时调用

参数
`test`	`TestDescription` ：标识测试
`trace`	`String` ：失败的堆栈跟踪

测试假设失败

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

当原子测试标记它假定条件为假时调用

参数
`test`	`TestDescription` ：标识测试
`failure`	`FailureDescription` ：描述故障及其上下文的`FailureDescription` 。

测试结束

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` ：测试结束的时间，通过`ERROR(/System#currentTimeMillis())`测量
`testMetrics`	: 发出的指标的`ERROR(/Map)`

测试结束

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` ：失败的堆栈跟踪

测试忽略

public void testIgnored (TestDescription test)

当测试不会运行时调用，通常是因为测试方法用 org.junit.Ignore 注释。

参数
`test`	`TestDescription` ：标识测试

测试运行结束

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

参数
`elapsedTimeMillis`	`long` ：设备报告经过的时间，以毫秒为单位
`runMetrics`	：在测试运行结束时使用`Metric`报告的键值对。

测试运行失败

public void testRunFailed (FailureDescription failure)

由于FailureDescription描述的故障，报告测试运行未能完成。

参数
`failure`	`FailureDescription` ：描述故障及其上下文的`FailureDescription` 。

测试运行失败

public void testRunFailed (String errorMessage)

报告测试运行由于致命错误而未能完成。

参数
`errorMessage`	`String` : `ERROR(/String)`描述运行失败的原因。

测试运行开始

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

报告测试运行的开始。

参数
`runName`	`String` : 测试运行名称
`testCount`	`int` : 测试运行中的测试总数
`attemptNumber`	`int` : order number，标识同一 runName 多次运行的不同尝试。 attemptNumber 是从 0 开始索引的，每次发生新的运行时都应该递增。例如，一个测试被精细地重试了 3 次，它应该在同一个 runName 下总共运行 4 次，并且 attemptNumber 是从 0 到 3。

测试运行开始

public void testRunStarted (String runName, 
                int testCount)

报告测试运行的开始。

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

测试运行开始

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

报告测试运行的开始。

参数
`runName`	`String` : 测试运行名称
`testCount`	`int` : 测试运行中的测试总数
`attemptNumber`	`int` : order number，标识同一 runName 多次运行的不同尝试。 attemptNumber 是从 0 开始索引的，每次发生新的运行时都应该递增。例如，一个测试被精细地重试了 3 次，它应该在同一个 runName 下总共运行 4 次，并且 attemptNumber 是从 0 到 3。
`startTime`	`long` ：运行开始的时间，通过`ERROR(/System#currentTimeMillis())`测量

测试运行已停止

public void testRunStopped (long elapsedTime)

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

TODO：目前未使用，考虑删除

参数
`elapsedTime`	`long` ：设备报告经过的时间，以毫秒为单位

测试开始

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` ：测试开始的时间，通过`ERROR(/System#currentTimeMillis())`测量

测试开始

public void testStarted (TestDescription test)

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

参数
`test`	`TestDescription` ：标识测试