IMetricCollector

public interface IMetricCollector
implements ITestInvocationListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

既知の間接サブクラス

BaseDeviceMetricCollector 、 BugreportzOnFailureCollector 、 DebugHostLogOnFailureCollector 、 FilePullerDeviceMetricCollector 、 FilePullerLogCollector 、 IncidentReportCollector 、 LogcatOnFailureCollector 、 ScreenshotOnFailureCollector

BaseDeviceMetricCollector	`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`および`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`収集を開始および停止できる`IMetricCollector`基本実装。
BugreportzOnFailureCollector	テストケースが失敗したときに、bugreportzを収集します。
DebugHostLogOnFailureCollector	テストケースの失敗が発生したときにホスト側のログを収集してログに記録するコレクター。
FilePullerDeviceMetricCollector	デバイスからのメトリックキーをリッスンし、それらをデバイスからファイルとしてプルする`BaseDeviceMetricCollector` 。
FilePullerLogCollector	デバイス側から報告されたファイルのロガー。
IncidentReportCollector	デバイス側で報告されたインシデントレポートをプルして処理し、構成されている場合は、テスト実行の最後にホスト側でインシデントレポートを収集します。
LogcatOnFailureCollector	テストケースが失敗したときにlogcatをキャプチャしてログに記録するコレクター。
ScreenshotOnFailureCollector	テストケースが失敗したときにスクリーンショットをキャプチャしてログに記録するコレクター。

このインターフェースは、一致するメトリックを収集するためにテスト結果を報告するときにデコレーターとして追加されます。

このインターフェースは、それもITestInvocationListener拡張し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)` テストケースの開始時のコールバック。

パブリックメソッド

getBuildInfos

public abstract  getBuildInfos ()

呼び出しで使用可能なビルド情報のリストを返します。

戻り値

getDevices

public abstract  getDevices ()

呼び出しで使用可能なデバイスのリストを返します。

戻り値

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

結果を転送する元のITestInvocationListener返します。

戻り値
`ITestInvocationListener`

初期化

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

現在のコンテキストと結果の転送先を使用したコレクターの初期化。インスタンスごとに1回だけ呼び出され、コレクターはその内部コンテキストとリスナーを更新することが期待されます。 Initは、常に以前のテスト実行中に呼び出されることはありません。

何をしているのかわからない場合は、オーバーライドしないでください。

パラメーター
`context`	`IInvocationContext` ：進行中の呼び出しの`IInvocationContext` 。
`listener`	`ITestInvocationListener` ：結果を配置する`ITestInvocationListener` 。

戻り値
`ITestInvocationListener`	元のリスナーをラップする新しいリスナー。

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

テストケースが仮定の失敗で失敗した場合のコールバック。

パラメーター
`testData`	`DeviceMetricData` ：テストケースのデータを保持する`DeviceMetricData` 。
`test`	`TestDescription` ：進行中のテストケースの`TestDescription` 。

onTestEnd

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)`渡されるメトリックの現在のマップ。

onTestEnd

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

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

テストケースが失敗したときのコールバック。

パラメーター
`testData`	`DeviceMetricData` ：テストケースのデータを保持する`DeviceMetricData` 。
`test`	`TestDescription` ：進行中のテストケースの`TestDescription` 。

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

テスト実行が終了したときのコールバック。これはクリーンアップの時間です。

パラメーター
`runData`	`DeviceMetricData` ：実行のデータを保持する`DeviceMetricData` 。 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`と同じオブジェクトになります。
`currentRunMetrics`	： `ITestLifeCycleReceiver.testRunEnded(long, Map)`渡されるメトリックの現在のマップ。

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

テスト実行が開始されたときのコールバック。

パラメーター
`runData`	`DeviceMetricData` ：実行のデータを保持する`DeviceMetricData` 。

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

テストケースの開始時のコールバック。

パラメーター
`testData`	`DeviceMetricData` ：テストケースのデータを保持する`DeviceMetricData` 。