IMetricCollector

public interface IMetricCollector
implements ITestInvocationListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

已知的间接子类

BaseDeviceMetricCollector	`IMetricCollector`基本实现，它允许在`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`和`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`上启动和停止收集。
BugreportzOnFailureCollector	测试用例失败时收集错误报告。
DebugHostLogOnFailureCollector	当发生测试用例失败时，收集器将收集并记录主机端日志。
FilePullerDeviceMetricCollector	一个`BaseDeviceMetricCollector` ，它侦听来自设备的指标密钥，并将其作为文件从设备中拉出。
FilePullerLogCollector	设备端报告的文件的记录器。
IncidentReportCollector	如果配置为这样做，则在测试运行结束时提取并处理在设备端报告的事件报告，并在主机端收集事件报告。
LogcatOnFailureCollector	当测试用例失败时，将捕获并记录logcat的收集器。
ScreenshotOnFailureCollector	当测试用例失败时，收集器将捕获并记录屏幕截图。

报告测试结果时，此接口将被添加为装饰器，以收集匹配的指标。

此接口不能用作即使它扩展了ITestInvocationListener 。配置检查将拒绝它。它必须用作“ metrics_collector”。

收集器不应保持内部状态，因为它们可能会在多个地方重复使用。如果确实必须使用内部状态，则应在init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener)上进行清理。

概要

公开方法
`abstract`	`getBuildInfos ()` 返回调用中可用的构建信息列表。
`abstract`	`getDevices ()` 返回调用中可用的设备列表。
`abstract ITestInvocationListener`	`getInvocationListener ()` 返回原始`ITestInvocationListener` ，我们在其中转发结果。
`abstract ITestInvocationListener`	`init (IInvocationContext context, ITestInvocationListener listener)` 使用当前上下文以及将结果转发到何处来初始化收集器。
`abstract void`	`onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)` 当测试用例失败且假设失败时进行回调。
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` 测试用例结束时的回调。
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 测试用例结束时的回调。
`abstract void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` 测试用例失败时回调。
`abstract void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` 测试运行结束时回调。
`abstract void`	`onTestRunStart ( DeviceMetricData runData)` 测试运行开始时的回调。
`abstract void`	`onTestStart ( DeviceMetricData testData)` 测试用例启动时的回调。

public abstract  getBuildInfos ()

返回调用中可用的构建信息列表。

退货

public abstract  getDevices ()

返回调用中可用的设备列表。

退货

public abstract ITestInvocationListener getInvocationListener ()

返回原始ITestInvocationListener ，我们在其中转发结果。

退货
`ITestInvocationListener`

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

使用当前上下文以及将结果转发到何处来初始化收集器。每个实例仅被调用一次，并且收集器应更新其内部上下文和侦听器。永远不会在测试运行之前调用Init。

除非您知道自己在做什么，否则不要覆盖。

参量
`context`	`IInvocationContext` ： `IInvocationContext`的调用的`IInvocationContext` 。
`listener`	`ITestInvocationListener` ：将结果`ITestInvocationListener`哪里的`ITestInvocationListener` 。

退货
`ITestInvocationListener`	新的监听器包装了原来的监听器。

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

当测试用例失败且假设失败时进行回调。

参量
`testData`	`DeviceMetricData` ：保存测试用例数据的`DeviceMetricData` 。
`test`	`TestDescription` ： `TestDescription`的测试用例的`TestDescription` 。

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

测试用例结束时的回调。这应该是清理的时间。

参量
`testData`	`DeviceMetricData` ：保存测试用例数据的`DeviceMetricData` 。与`onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`期间的对象相同。
`currentTestCaseMetrics`	：传递给`ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`的度量的当前映射。

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

测试用例结束时的回调。这应该是清理的时间。

参量
`testData`	`DeviceMetricData` ：保存测试用例数据的`DeviceMetricData` 。与`onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`期间的对象相同。
`currentTestCaseMetrics`	：传递给`ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`的指标的当前映射。
`test`	`TestDescription` ： `TestDescription`的测试用例的`TestDescription` 。

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

测试用例失败时回调。

参量
`testData`	`DeviceMetricData` ：保存测试用例数据的`DeviceMetricData` 。
`test`	`TestDescription` ： `TestDescription`的测试用例的`TestDescription` 。

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

测试运行结束时回调。这应该是清理的时间。

参量
`runData`	`DeviceMetricData` ：保存运行数据的`DeviceMetricData` 。与`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`期间的对象相同。
`currentRunMetrics`	：传递给`ITestLifeCycleReceiver.testRunEnded(long, Map)`的度量的当前映射。

public abstract void onTestRunStart (DeviceMetricData runData)

测试运行开始时的回调。

参量
`runData`	`DeviceMetricData` ：保存运行数据的`DeviceMetricData` 。

public abstract void onTestStart (DeviceMetricData testData)

测试用例启动时的回调。

参量
`testData`	`DeviceMetricData` ：保存测试用例数据的`DeviceMetricData` 。