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、その他 77 個。

AggregatePostProcessor	複数の反復テスト実行中に収集された数値指標の最小値、最大値、平均値、分散、標準偏差、合計、カウント、および必要に応じてパーセンタイルをダブルとして扱う指標アグリゲータ。
AtraceCollector	テスト中に atrace を実行し、結果を収集して呼び出しにログに記録する `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	テストケースが失敗したときにバグレポートを収集します。
BugreportzOnTestCaseFailureCollector	実行中のテストケースが失敗したときに、バグレポートを収集します。
ClangCodeCoverageCollector	デバイスから Clang カバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CodeCoverageCollector	デバイスから Java とネイティブのカバレッジ測定値を取得し、テストアーティファクトとしてログに記録する `BaseDeviceMetricCollector`。
CollectingTestListener	すべてのテスト結果を収集する `ITestInvocationListener`。
CommandStatusHandler	呼び出しのステータスのモニタリングと更新に役立つハンドラ。
ConditionFailureMonitor	呼び出しでエラーが発生していないかモニタリングします。
ConsoleResultReporter	テスト結果をコンソールに出力する結果レポーター。
CountTestCasesCollector	特定の `IRemoteTest` のテストケースの数をカウントして報告します。
DebugHostLogOnFailureCollector	テストケースの失敗時にホスト側のログを収集してログに記録するコレクタ。
DeviceReleaseReporter	デバイスのリリースレポーター。リリースされるデバイスの親プロセスとの通信を処理します。
DeviceTraceCollector	テスト実行の開始時に perfetto トレースを開始し、終了時にトレースファイルをログに記録するコレクタ。
DeviceUnavailableMonitor	このリスナーは、テストケースレベルの DNAE のみをキャプチャしようとします。
EventsLoggerListener	受信したすべてのイベントをファイルにログに記録するリスナー
FileProtoResultReporter	`TestRecord` をファイルにダンプする Proto レポーター。
FilePullerDeviceMetricCollector	デバイスから送信される指標キーをリッスンし、デバイスからファイルとして pull する `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	指定された正規表現パターンを使用して、logcat の行からイベントの開始シグナルと終了シグナルを解析し、1 回または複数の繰り返しテスト中に logcat からタイミング情報（ユーザー切り替え時間など）を収集する指標コレクタ。
MetricFilePostProcessor	テストレベルと実行レベルで収集された指標ログファイルをアップロードするために使用されます。
MetricsXMLResultReporter	MetricsXMLResultReporter は、テストの invocationEnded フェーズで、metrics-folder パラメータで指定されたフォルダの XML ファイルにテスト指標と実行指標を書き込みます。
ModuleListener	各モジュールの各 `IRemoteTest` に接続されたリスナー。結果のリストを収集します。
ModuleLogcatCollector	モジュール用の logcat コレクタのバージョン。
ModuleProtoResultReporter	モジュールレベルの結果のみを報告する結果レポーター。
NameMangleListener	結果が報告されたときに、テストメソッド、クラス、パッケージ名を変換するプロキシリスナー。
PassingTestFileReporter	合格したテストケースのリストをテストファイルに保存する `ITestInvocationListener`
PerfettoGenericPostProcessor	数値フィールドが検出されるまで、文字列値を持つ proto メッセージとフィールドを再帰的に展開して、テキスト/バイナリ指標の perfetto proto ファイルを Key-Value ペアに処理するポストプロセッサ。
PerfettoPullerMetricCollector	デバイスから perfetto ファイルを取得して指標を収集できる `FilePullerDeviceMetricCollector` の基本実装。
PrettyTestEventLogger	ロガーがイベントを照合してロギングし、デバッグが容易になるようにします。
ProtoResultReporter	結果レポーターは、すべての結果を含む `TestRecord` protobuf をビルドします。
PythonBinaryHostTest.PythonForwarder	実行名をバイナリ名に置き換える結果転送元。
RebootReasonCollector	テスト実行中にデバイスの再起動を収集し、理由と回数でレポートするコレクタ。
RemoteTestTimeOutEnforcer	特定のテスト構成の実行時間をチェックし、指定されたタイムアウトを超えると失敗するリスナー。
ReportPassedTests	合格したテストを除外する可能性のあるフィルタをファイルに報告します。
ResultAggregator	実行された再試行戦略に基づいて、必要に応じて結果を集約する特別なフォワーダ。
ResultAndLogForwarder	結果とログイベントのフォワーダー。
ResultDBReporter	テスト結果を ResultDB にアップロードする結果レポーター。
ResultForwarder	呼び出し結果を他のリスナーのリストに転送する `ITestInvocationListener`。
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 の結果を XML ファイルに書き込みます。形式は Ant の XMLJUnitResultFormatter と一致します。

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

テスト呼び出し自体に複数のテスト実行が含まれる場合、呼び出しの順序は次のようになります。

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

パブリックメソッド

パブリックメソッド