デバイス側の指標コレクタ

デバイス側のテスト（インストルメンテーション テスト、UI Automator テストなど）を実行する場合、ホスト側のコレクタはデバイス上で実行されるテストに指標収集を同期させることが難しいため、使用に適さないことがあります。たとえば、非同期でスクリーンショットを撮影すると、目的の画面を撮り損なって無駄になる可能性が高くなります。

このようなユースケースに対応するためにデバイス側のコレクタが存在し、AndroidJUnitRunner インストルメンテーションで使用できます。BaseMetricListener を実装すると、Tradefed レポート パイプラインと完全な互換性がある方法で収集された指標を自動的に報告できます。

このライブラリは Tradefed 自体からは分離されており、Tradefed なしで使用できます。

Tradefed の AndroidJUnitTest ランナーを使用している場合は、次のコマンドライン オプションを指定すると、コレクタをテストとともに実行できます。

  --device-listeners android.device.collectors.ScreenshotListener

  LOCAL_STATIC_JAVA_LIBRARIES += collector-device-lib

実装

基本クラス BaseMetricListener の上に実装する場合、インストルメンテーションのライフサイクル中に指標を収集するタイミングを選択できます。

• テスト実行の開始時: onTestRunStart
• テストケースの開始時: onTestStart
• テストケースの終了時: onTestEnd
• テストケースの不合格時: onTestFail
• テスト実行の終了時: onTestRunEnd

インタラクション

デバイス側の指標の集計は、インストルメンテーションの実行自体と同期して行われます。指標はインストルメンテーション結果に渡され、Tradefed によって解析されて呼び出しの一環として報告されます。