2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main ではなく android-latest-release を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。

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

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

既知の間接的なサブクラス

AtraceCollector、AtraceRunMetricCollector、BaseDeviceMetricCollector、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothHciSnoopLogCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector、CountTestCasesCollector、DebugHostLogOnFailureCollector、DeviceTraceCollector、FilePullerDeviceMetricCollector、FilePullerLogCollector、その他 13 個。

AtraceCollector	テスト中に 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`。
CodeCoverageCollector	デバイスから Java とネイティブのカバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CountTestCasesCollector	特定の `IRemoteTest` のテストケースの数をカウントして報告します。
DebugHostLogOnFailureCollector	テストケースの失敗時にホスト側のログを収集してログに記録するコレクタ。
DeviceTraceCollector	テスト実行の開始時に perfetto トレースを開始し、終了時にトレースファイルをログに記録するコレクタ。
FilePullerDeviceMetricCollector	デバイスから送信される指標キーをリッスンし、デバイスからファイルとして pull する `BaseDeviceMetricCollector`。
FilePullerLogCollector	デバイス側から報告されたファイルのロガー。
GcovCodeCoverageCollector	デバイスから gcov カバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
GcovKernelCodeCoverageCollector	debugfs から gcov カーネルカバレッジ測定値をデバイスから取得し、最終的にテストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
HostStatsdMetricCollector	statsd ユーティリティコマンドを使用してホスト側から statsd 指標を収集する `IMetricCollector`。
JavaCodeCoverageCollector	デバイスから Java カバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
LogcatOnFailureCollector	テストケースが失敗したときに Logcat をキャプチャしてログに記録するコレクタ。
LogcatTimingMetricCollector	指定された正規表現パターンを使用して、logcat の行からイベントの開始シグナルと終了シグナルを解析し、1 回または複数の繰り返しテスト中に logcat からタイミング情報（ユーザー切り替え時間など）を収集する指標コレクタ。
ModuleLogcatCollector	モジュール用の logcat コレクタのバージョン。
PerfettoPullerMetricCollector	デバイスから perfetto ファイルを取得して指標を収集できる `FilePullerDeviceMetricCollector` の基本実装。
RebootReasonCollector	テスト実行中にデバイスの再起動を収集し、理由と回数でレポートするコレクタ。
RuntimeRestartCollector	テスト実行中のランタイムの再起動（システムサーバーのクラッシュ）のタイムスタンプを収集するコレクタ（存在する場合）。
ScreenshotOnFailureCollector	テストケースが失敗したときにスクリーンショットをキャプチャして記録するコレクタ。
ShowmapPullerMetricCollector	デバイスから showmap ファイルを取得して指標を収集できる `FilePullerDeviceMetricCollector` の基本実装。
TraceCmdCollector	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)` テストケースが終了したときのコーリングバック。
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` テストケースが終了したときのコーリングバック。
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` テストケースが失敗したときに呼び出されるコールバック。
`default void`	`onTestModuleEnded()` モジュール終了イベントをキャプチャできます。
`default void`	`onTestModuleStarted()` モジュール開始イベントをキャプチャできます。
`abstract void`	`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`

init

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`

IMetricCollector

概要

パブリック メソッド

パブリック メソッド

captureModuleLevel

getBuildInfos

getDevices

getInvocationListener

init

onTestAssumptionFailure

onTestEnd

onTestEnd

onTestFail

onTestModuleEnded

onTestModuleStarted

onTestRunEnd

onTestRunStart

onTestRunStart

onTestStart

パブリックメソッド

パブリックメソッド