2026 年より、トランク安定版開発モデルに沿ってエコシステムのプラットフォームの安定性を確保するため、第 2 四半期と第 4 四半期に AOSP にソースコードを公開します。AOSP のビルドとコントリビューションには、aosp-main ではなく android-latest-release を使用することをおすすめします。android-latest-release マニフェストブランチは、常に AOSP にプッシュされた最新のリリースを参照します。詳細については、AOSP の変更点をご覧ください。

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 など、14 個のコレクタ。

AtraceCollector	テスト中にトレースを実行し、結果を収集して呼び出しに記録する `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	テストケースが失敗したときに bugreportz を収集します。
BugreportzOnTestCaseFailureCollector	実行内のテストケースが失敗した場合に bugreportz を収集します。
ClangCodeCoverageCollector	デバイスから Clang カバレッジ測定値をプルして、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CodeCoverageCollector	デバイスから Java とネイティブのカバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CountTestCasesCollector	特定の `IRemoteTest` のテストケースの数をカウントして報告します。
DebugHostLogOnFailureCollector	テストケースの失敗時にホスト側のログを収集して記録するコレクタ。
DeviceTraceCollector	テスト実行の開始時に perfetto トレースを開始し、終了時にトレースファイルをログに記録するコレクタ。
FilePullerDeviceMetricCollector	デバイスから送信される指標キーをリッスンし、デバイスからファイルとして取得する `BaseDeviceMetricCollector`。
FilePullerLogCollector	デバイス側から報告されたファイルのロガー。
GcovCodeCoverageCollector	デバイスから gcov カバレッジ測定値をプルして、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
GcovKernelCodeCoverageCollector	debugfs から gcov カーネルカバレッジ測定値をデバイスから取得し、最終的にテストアーティファクトとして記録する `BaseDeviceMetricCollector`。
HostStatsdMetricCollector	statsd ユーティリティコマンドを使用してホスト側から statsd 指標を収集する `IMetricCollector`。
JavaCodeCoverageCollector	デバイスから Java カバレッジ測定値を取得し、テストアーティファクトとして記録する `BaseDeviceMetricCollector`。
LogcatOnFailureCollector	テストケースが失敗したときに logcat をキャプチャしてログに記録するコレクタ。
LogcatTimingMetricCollector	指定された正規表現パターンを使用して、1 回または複数回の繰り返しテスト中に logcat からタイミング情報（ユーザー切り替え時間など）を収集する指標コレクタ。logcat 行からイベントの開始信号と終了信号を解析します。
ModuleLogcatCollector	logcat コレクタのバージョン（モジュール用）。
PerfettoFilePullerCollector	デバイスから perfetto トレースファイルを pull し、必要に応じて圧縮して、テストログに追加するコレクタ。
PerfettoPullerMetricCollector	このクラスは非推奨になりました。代わりに `PerfettoFilePullerCollector` と `ERROR(/PerfettoTracePostProcessor)` を使用してください。
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

パブリックメソッド

パブリックメソッド