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。