このページは Cloud Translation API によって翻訳されました。

IMetricCollector

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

既知の間接サブクラス

AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , and 12 others.

Atraceコレクター	テスト中に atrace を実行し、結果を収集して呼び出しに記録する`IMetricCollector` 。
AtraceRunMetricCollector	テストデバイスから指定されたディレクトリの下にあるすべてのテストディレクトリからトレースを収集し、テストディレクトリをログに記録し、テストディレクトリの下にあるトレースファイルを後処理して、メトリックを集計します。
BaseDeviceMetricCollector	`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`および`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`で収集を開始および停止できる`IMetricCollector`の基本実装。
BluetoothConnectionLatencyCollector	コレクターは、事前定義された statsd 期間メトリック構成をデバイスにプッシュし、各プロファイルの Bluetooth 接続期間を収集します。
BluetoothConnectionStateCollector	このコレクターは BluetoothConnectionStateChanged メトリックを収集し、各プロファイルの接続状態番号を記録します。
BluetoothHciSnoopLogCollector	DUT で Bluetooth HCI スヌープロギングを有効にし、各テストのログを収集するコレクタ。
BugreportzOnFailureCollector	テストケースが失敗したときにバグレポートを収集します。
BugreportzOnTestCaseFailureCollector	実行中のテストケースが失敗したときにバグレポートを収集します。
ClangCodeCoverageCollector	デバイスから Clang カバレッジ測定値を取得し、それらをテストアーティファクトとしてログに記録する`BaseDeviceMetricCollector` 。
CountTestCasesCollector	指定された`IRemoteTest`のテストケースの数を数えて報告します。
DebugHostLogOnFailureCollector	テストケースの失敗が発生したときに、ホスト側のログを収集してログに記録するコレクター。
DeviceTraceCollector	テスト実行の開始時に perfetto トレースを開始し、最後にトレースファイルをログに記録するコレクター。
FilePullerDeviceMetricCollector	デバイスからのメトリクスキーをリッスンし、それらをデバイスからファイルとしてプルする`BaseDeviceMetricCollector` 。
FilePullerLogCollector	デバイス側から報告されたファイルのロガー。
GcovCodeCoverageCollector	デバイスから gcov カバレッジ測定値を取得し、それらをテストアーティファクトとしてログに記録する`BaseDeviceMetricCollector` 。
GcovKernelCodeCoverageCollector	gcov カーネルカバレッジ測定値を debugfs およびデバイスから取得し、最終的にそれらをテストアーティファクトとしてログに記録する`BaseDeviceMetricCollector` 。
HostStatsdMetricCollector	statsd ユーティリティコマンドを使用してホスト側から statsd メトリックを収集する`IMetricCollector` 。
JavaCodeCoverageCollector	デバイスから Java カバレッジ測定値を取得し、それらをテストアーティファクトとしてログに記録する`BaseDeviceMetricCollector` 。
LogcatOnFailureCollector	テストケースが失敗したときに logcat をキャプチャしてログに記録するコレクター。
LogcatTimingMetricCollector	指定された正規表現パターンを使用して logcat 行からのイベントの開始および終了シグナルを解析することにより、1 回または複数回の繰り返しテスト中に logcat からタイミング情報 (ユーザー切り替え時間など) を収集するメトリックコレクター。
ModuleLogcatCollector	モジュール用の logcat コレクターのバージョン。
PerfettoPullerMetricCollector	デバイスから perfetto ファイルをプルしてメトリックを収集できるようにする`FilePullerDeviceMetricCollector`の基本実装。
RebootReasonCollector	テストの実行中にデバイスの再起動を収集し、理由とカウント別に報告するコレクター。
ランタイム再起動コレクター	テスト実行中のランタイム再起動 (システムサーバーのクラッシュ) のタイムスタンプを収集するコレクター (存在する場合)。
ScreenshotOnFailureCollector	テストケースが失敗したときにスクリーンショットをキャプチャしてログに記録するコレクター。
ShowmapPullerMetricCollector	デバイスから showmap ファイルをプルしてメトリックを収集できる`FilePullerDeviceMetricCollector`の基本実装。
TraceCmdコレクター	trace-cmd を使用してテスト中にトレースを収集し、それらを呼び出しに記録する`IMetricCollector` 。

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

このインターフェイスは、それでもITestInvocationListenerを拡張します。構成チェックはそれを拒否します。「metrics_collector」として使用する必要があります。

コレクターは、いくつかの場所で再利用される可能性があるため、内部状態を保持することは想定されていません。内部状態を実際に使用する必要がある場合は、 init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener)で消去する必要があります。

まとめ

公開メソッド
`default boolean`	`captureModuleLevel ()` コレクタがモジュールレベルのキャプチャに適用可能であり、初期化する必要があるかどうか。
`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, TestDescription test)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` テストケース終了時のコールバック。
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` テストケース終了時のコールバック。
`abstract void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` テストケースが失敗したときのコールバック。
`default void`	`onTestModuleEnded ()` モジュール終了イベントのキャプチャを許可します。
`default void`	`onTestModuleStarted ()` モジュール開始イベントのキャプチャーを許可します。
`abstract void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` テスト実行が終了したときのコールバック。
`abstract void`	`onTestRunStart ( DeviceMetricData runData)` テスト実行開始時のコールバック。
`default void`	`onTestRunStart ( DeviceMetricData runData, int testCount)` テスト実行開始時のコールバック。
`abstract void`	`onTestStart ( DeviceMetricData testData)` テストケース開始時のコールバック。

公開メソッド

CaptureModuleLevel

public boolean captureModuleLevel ()

コレクタがモジュールレベルのキャプチャに適用可能であり、初期化する必要があるかどうか。

戻り値
`boolean`

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`	元のリスナーをラップする新しいリスナー。

スロー
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

スロー
`DeviceNotAvailableException`

onTestEnd

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

テストケース終了時のコールバック。これは、クリーンアップの時間である必要があります。

パラメーター
`testData`	`DeviceMetricData` : テストケースのデータを保持する`DeviceMetricData` 。 `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`中と同じオブジェクトになります。
`currentTestCaseMetrics`	: `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`に渡されるメトリックの現在のマップ。
`test`	`TestDescription` : 進行中のテストケースの`TestDescription` 。

スロー
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

テストケース終了時のコールバック。これは、クリーンアップの時間である必要があります。

パラメーター
`testData`	`DeviceMetricData` : テストケースのデータを保持する`DeviceMetricData` 。 `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`中と同じオブジェクトになります。
`currentTestCaseMetrics`	: `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`に渡されるメトリックの現在のマップ。

スロー
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

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

スロー
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

モジュール終了イベントのキャプチャを許可します。

スロー
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

モジュール開始イベントのキャプチャーを許可します。

スロー
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

スロー
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

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

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

スロー
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

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

パラメーター
`runData`	`DeviceMetricData` : 実行のデータを保持する`DeviceMetricData` 。
`testCount`	`int` : このテスト実行でのテストケースの数。

スロー
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

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

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

スロー
`DeviceNotAvailableException`