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

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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

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

AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector など、81 個のクラスがあります。

AggregatePostProcessor	複数回のテスト実行中に収集された数値指標の最小値、最大値、平均値、分散、標準偏差、合計、カウント、およびオプションでパーセンタイルを double として扱う指標アグリゲータ。
AtraceCollector	テスト中にトレースを実行し、結果を収集して呼び出しに記録する `IMetricCollector`。
AtraceRunMetricCollector	テストデバイスから指定されたディレクトリの下にあるすべてのテストディレクトリからトレースを収集し、テストディレクトリをログに記録し、テストディレクトリの下にあるトレースファイルを後処理して、指標を集計します。
AveragePostProcessor	指標のリストの平均を計算するポストプロセッサの実装。
BaseDeviceMetricCollector	`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` と `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` で収集を開始および停止できる `IMetricCollector` の基本実装。
BasePostProcessor	すべての実装が拡張するベース `IPostProcessor`。
BluetoothConnectionLatencyCollector	コレクタは、事前定義された statsd 期間指標構成をデバイスにプッシュし、各プロファイルの Bluetooth 接続期間を収集します。
BluetoothConnectionStateCollector	このコレクタは、BluetoothConnectionStateChanged 指標を収集し、各プロファイルの接続状態番号を記録します。
BluetoothConnectionSuccessRatePostProcessor	Bluetooth プロファイルの成功率を計算するポストプロセッサの実装「metric-key-match」を使用して、数値配列 [0, 1, 2, 3, 0, 1, 2, 3] で Bluetooth 接続状態を含む指標を指定します。
BluetoothHciSnoopLogCollector	DUT で Bluetooth HCI スヌープログを有効にし、各テストのログを収集するコレクタ。
BugreportCollector	構成可能なイベントが発生したときにバグレポートを収集し、各バグレポートの収集後に子で `ITestInvocationListener.testLog` を呼び出すパススルー `ITestInvocationListener`。
BugreportzOnFailureCollector	テストケースが失敗したときに bugreportz を収集します。
BugreportzOnTestCaseFailureCollector	実行内のテストケースが失敗した場合に bugreportz を収集します。
ClangCodeCoverageCollector	デバイスから Clang カバレッジ測定値をプルして、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CodeCoverageCollector	デバイスから Java とネイティブのカバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CollectingTestListener	すべてのテスト結果を収集する `ITestInvocationListener`。
CommandStatusHandler	呼び出しのステータスをモニタリングして更新するハンドラ。
ConditionFailureMonitor	呼び出しからの障害をモニタリングします。
ConsoleResultReporter	テスト結果をコンソールに出力する結果レポーター。
CountTestCasesCollector	特定の `IRemoteTest` のテストケースの数をカウントして報告します。
DebugHostLogOnFailureCollector	テストケースの失敗時にホスト側のログを収集して記録するコレクタ。
DeviceReleaseReporter	リリースされるデバイスを親プロセスと通信して処理するデバイスリリースレポーター。
DeviceTraceCollector	テスト実行の開始時に perfetto トレースを開始し、終了時にトレースファイルをログに記録するコレクタ。
DeviceUnavailableMonitor	このリスナーは、テストケースレベルの DNAE のみをキャプチャしようとします。
EventsLoggerListener	受信したすべてのイベントをファイルに記録するリスナー
FileProtoResultReporter	`TestRecord` をファイルにダンプする Proto レポーター。
FilePullerDeviceMetricCollector	デバイスから送信される指標キーをリッスンし、デバイスからファイルとして取得する `BaseDeviceMetricCollector`。
FilePullerLogCollector	デバイス側から報告されたファイルのロガー。
FilteredResultForwarder	`TestDescription` の許可リストのみをレポートできる `ResultForwarder` のバリアント。
FormattedGeneratorReporter	特定の形式でレポートを生成できるレポートツール。
GcovCodeCoverageCollector	デバイスから gcov カバレッジ測定値をプルして、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
GcovKernelCodeCoverageCollector	debugfs から gcov カーネルカバレッジ測定値をデバイスから取得し、最終的にテストアーティファクトとして記録する `BaseDeviceMetricCollector`。
GranularRetriableTestWrapper.StartEndCollector	実行の開始と終了の欠落を検出するクラスヘルパー。
HostStatsdMetricCollector	statsd ユーティリティコマンドを使用してホスト側から statsd 指標を収集する `IMetricCollector`。
ICommandScheduler.IScheduledInvocationListener	呼び出しが完了したときの呼び出しイベントのリスナー。
ILogSaverListener	`ITestInvocationListener` がログファイルが保存されたタイミングをリッスンできるようにします。
IMetricCollector	このインターフェースは、一致する指標を収集するためにテスト結果を報告する際にデコレータとして追加されます。
IPostProcessor	ポストプロセッサは、テスト後、結果レポート前に指標とログの処理を可能にするための Trade Federation オブジェクトです。
IShardableListener	シャーディング可能な `ITestInvocationListener`。
ISupportGranularResults	`ITestInvocationListener` が詳細な結果の受信をサポートするかどうかを指定するインターフェース。
ITestSummaryListener	`ITestInvocationListener` が概要を通じて一部の限定的な情報を交換できるようにするインターフェース。
InvocationProtoResultReporter	呼び出しレベルのキャッシュ保存情報とそのモジュールリストを保存するレポーター
InvocationToJUnitResultForwarder	`ITestInvocationListener` イベントをリッスンし、`TestListener` に転送するクラス。
JarHostTest.HostTestListener	testRunStarted() と testRunEnded() を除くすべてのイベントを埋め込みリスナーに転送するラッパーリスナー。
JavaCodeCoverageCollector	デバイスから Java カバレッジ測定値を取得し、テストアーティファクトとして記録する `BaseDeviceMetricCollector`。
JsonHttpTestResultReporter	テスト指標の結果とブランチ、デバイス情報を JSON にエンコードして HTTP サービスエンドポイントに POST する結果レポート。
LUCIResultReporter	ResultDB と LUCI で必要なテスト結果を JSON 形式で保存し（go/result-sink）、コンソールにファイルロケーションを記録する結果レポート。
LastShardDetector	ローカルシャーディングを実行する場合、最後のシャードが `invocationEnded(long)` に達したときにのみアクションを実行したいことがあります。
LegacySubprocessResultsReporter	サブプロセス結果レポーターのフリーズされた実装。スーパークラスの変更にもかかわらず、以前のバージョンの TF/CTS（8+ など）との互換性を維持する必要があります。
LogSaverResultForwarder	グローバルファイルセーバーでログを保存するための `ResultForwarder`。
LogcatCrashResultForwarder	特別なリスナー: 失敗（計測プロセスがクラッシュした場合）に、logcat からクラッシュを抽出して、テストに関連付けられた失敗メッセージに追加しようとします。
LogcatOnFailureCollector	テストケースが失敗したときに logcat をキャプチャしてログに記録するコレクタ。
LogcatTimingMetricCollector	指定された正規表現パターンを使用して、1 回または複数回の繰り返しテスト中に logcat からタイミング情報（ユーザー切り替え時間など）を収集する指標コレクタ。logcat 行からイベントの開始信号と終了信号を解析します。
MetricFilePostProcessor	テストと実行レベルで収集された指標ログファイルのアップロードに使用されます。
MetricsXMLResultReporter	MetricsXMLResultReporter は、テストの invocationEnded フェーズで、テスト指標と実行指標を metrics-folder パラメータで指定されたフォルダの XML ファイルに書き込みます。
ModuleListener	結果のリストを収集するために、各モジュールの各 `IRemoteTest` にアタッチされたリスナー。
ModuleLogcatCollector	logcat コレクタのバージョン（モジュール用）。
ModuleProtoResultReporter	モジュールレベルの結果のみを報告するための結果レポーター。
ModuleResultsAndMetricsForwarder	テスト結果にモジュール関連の追加指標を追加する `ResultAndLogForwarder` の拡張機能。
NameMangleListener	結果が報告されるときにテストメソッド、クラス、パッケージ名を変換するプロキシリスナー。
PassingTestFileReporter	合格したテストケースのリストをテストファイルに保存する `ITestInvocationListener`
PerfettoFilePullerCollector	デバイスから perfetto トレースファイルを pull し、必要に応じて圧縮して、テストログに追加するコレクタ。
PerfettoGenericPostProcessor	テキスト/バイナリ指標の perfetto proto ファイルを、数値を持つフィールドが見つかるまで文字列値を持つ proto メッセージとフィールドを再帰的に展開して、Key-Value ペアに処理するポストプロセッサ。
PerfettoPullerMetricCollector	このクラスは非推奨になりました。代わりに `PerfettoFilePullerCollector` と `ERROR(/PerfettoTracePostProcessor)` を使用してください。
PerfettoTracePostProcessor	テストログから perfetto トレースファイルを取得し、それに対してトレースプロセッサを実行して perfetto 指標 proto を生成するポストプロセッサ。
PrettyTestEventLogger	イベントを照合してログに記録し、デバッグを容易にするロガー。
ProtoResultReporter	結果レポーターは、すべての結果を含む `TestRecord` protobuf をビルドします。
PythonBinaryHostTest.PythonForwarder	実行名をバイナリ名に置き換える結果転送。
RebootReasonCollector	テスト実行中にデバイスの再起動を収集し、理由と回数でレポートするコレクタ。
RemoteTestTimeOutEnforcer	特定のテスト構成の実行時間をチェックし、指定されたタイムアウトを超えた場合に失敗させるリスナー。
ReportPassedTests	合格したテストを除外するフィルタをファイルでレポートします。
ResultAggregator	実行された再試行戦略に基づいて、必要に応じて結果を集計する特別な転送。
ResultAndLogForwarder	結果とログイベントのフォワーダー。
ResultDBReporter	テスト結果を ResultDB にアップロードする結果レポーター。
ResultForwarder	呼び出し結果を他のリスナーのリストに転送する `ITestInvocationListener`。
ResultReporter
RetryLogSaverResultForwarder	現在の試行回数を渡す処理も行う転送。
RetryResultForwarder	常に指定された試行番号にプッシュする `ResultForwarder` の拡張機能。
RuntimeRestartCollector	テスト実行中にランタイム再起動（システムサーバーのクラッシュ）のタイムスタンプを収集するコレクタ（ある場合）。
ScreenshotOnFailureCollector	テストケースが失敗したときにスクリーンショットをキャプチャしてログに記録するコレクタ。
ShardListener	呼び出しシャード（複数のリソースで並列実行される呼び出し分割）から結果を収集し、別のリスナーに転送する `ITestInvocationListener`。
ShardMainResultForwarder	シャードテスト呼び出しの結果を結合する `ResultForwarder`。
ShowmapPullerMetricCollector	デバイスから showmap ファイルを取得し、そこから指標を収集できるようにする `FilePullerDeviceMetricCollector` の基本実装。
StatsdBeforeAfterGaugeMetricPostProcessor	「前/後」のアプローチで収集されたゲージ指標を処理するポストプロセッサ。
StatsdEventMetricPostProcessor	プロセッサで指定されたフォーマッタを使用して、statsd レポートのイベント指標を Key-Value ペアに処理するポストプロセッサ。
StatsdGenericPostProcessor	バイナリ proto statsd レポートをツリー構造として展開し、Key-Value ペアに処理するポストプロセッサ。
StreamProtoResultReporter	`ProtoResultReporter` の実装
SubprocessResultsReporter	result_reporter として指定される `ITestInvocationListener` を実装し、サブプロセスからテスト、テスト実行、テスト呼び出しの結果を転送します。
SuiteResultReporter	スイート全体の呼び出しのテスト結果を収集し、最終結果を出力します。
TestRunResultListener	最終的なテスト実行ステータスを読み取ることができるリスナー。
TestTimeoutEnforcer	特定のテストケースの実行時間をチェックし、指定されたタイムアウトを超えた場合に失敗させるリスナー。
TextResultReporter	結果を JUnit テキスト結果プリンタに転送するテスト結果レポーター。
TraceCmdCollector	trace-cmd を使用してテスト中にトレースを収集し、呼び出しに記録する `IMetricCollector`。
TradefedSandboxRunner.StubScheduledInvocationListener	何も行わないスタブ `IScheduledInvocationListener`。
XmlFormattedGeneratorReporter	スイートの結果を XML 形式でフォーマットする `FormattedGeneratorReporter` の実装。
XmlResultReporter	JUnit の結果を、Ant の XMLJUnitResultFormatter と一貫性のある形式で XML ファイルに書き込みます。

テスト呼び出しからのテスト結果のリスナー。

テスト呼び出し自体に複数のテスト実行を含めることができるため、呼び出しのシーケンスは次のようになります。

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

概要

パブリックメソッド
`default TestSummary`	`getSummary()` InvocationListener が概要を返すことを許可します。
`default void`	`invocationEnded(long elapsedTime)` 呼び出しが終了したことを報告します（成功した場合も、エラー条件が原因で終了した場合も同様です）。
`default void`	`invocationFailed(FailureDescription failure)` エラー条件により呼び出しが不完全になったことを報告します。
`default void`	`invocationFailed(Throwable cause)` エラー条件により呼び出しが不完全になったことを報告します。
`default void`	`invocationInterrupted()` スケジューラシャットダウン時に呼び出され、呼び出しに終了前に何かを行う機会を与えます。
`default void`	`invocationSkipped(SkipReason reason)` 呼び出しをスキップとして報告します。
`default void`	`invocationStarted(IInvocationContext context)` テスト呼び出しの開始を報告します。
`default void`	`testModuleEnded()` モジュール実行の終了を報告します。
`default void`	`testModuleStarted(IInvocationContext moduleContext)` モジュールの実行の開始を報告します。

パブリックメソッド

getSummary

public TestSummary getSummary ()

InvocationListener が概要を返すことを許可します。

戻り値
`TestSummary`	実行を要約する `TestSummary`。null の場合もあります。

invocationEnded

public void invocationEnded (long elapsedTime)

呼び出しが終了したことを報告します（成功した場合も、エラー条件が原因で終了した場合も同様です）。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
`elapsedTime`	`long`: 呼び出しの経過時間（ミリ秒単位）

invocationFailed

public void invocationFailed (FailureDescription failure)

エラー条件により呼び出しが不完全になったことを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
`failure`	`FailureDescription`: 障害の原因を説明する `FailureDescription`

invocationFailed

public void invocationFailed (Throwable cause)

エラー条件により呼び出しが不完全になったことを報告します。

TradeFederation フレームワークによって自動的に呼び出されます。

パラメータ
`cause`	`Throwable`: 失敗の `Throwable` 原因

invocationInterrupted

public void invocationInterrupted ()

スケジューラがシャットダウンされるときに呼び出され、呼び出しに終了前に何かを行う機会を与えます。

invocationSkipped

public void invocationSkipped (SkipReason reason)

呼び出しをスキップとして報告します

パラメータ
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

テスト呼び出しの開始を報告します。

TradeFederation フレームワークによって自動的に呼び出されます。複数のデバイスのレポートをサポートするには、レポート作成者がこのメソッドをオーバーライドする必要があります。

パラメータ
`context`	`IInvocationContext`: 呼び出しに関する情報

testModuleEnded

public void testModuleEnded ()

モジュール実行の終了を報告します。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

モジュールの実行開始を報告します。このコールバックは testModuleEnded() に関連付けられており、シーケンスでは省略可能です。モジュールを使用する実行（スイートベースのランナー）でのみ使用されます。

パラメータ
`moduleContext`	`IInvocationContext`: モジュールの `IInvocationContext`。

ITestInvocationListener

概要

パブリック メソッド

パブリック メソッド

getSummary

invocationEnded

invocationFailed

invocationFailed

invocationInterrupted

invocationSkipped

invocationStarted

testModuleEnded

testModuleStarted

パブリックメソッド

パブリックメソッド