ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

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

---

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

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

• invocationStarted(BuildInfo)
• testRunStarted
• テスト開始
• [テスト失敗]
• テスト終了
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [呼び出し失敗]
• [テストログ+]
• 呼び出し終了
• 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	invocationStarted ( IInvocationContext context) テスト呼び出しの開始を報告します。
default void	testModuleEnded () モジュール実行の終了を報告します。
default void	testModuleStarted ( IInvocationContext moduleContext) 実行中のモジュールの開始を報告します。

公開メソッド

getSummary

public TestSummary getSummary ()

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

戻り値
TestSummary	実行を要約するTestSummary 、または null

呼び出し終了

public void invocationEnded (long elapsedTime)

呼び出しが正常に終了したか、何らかのエラー状態により終了したことを報告します。

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

パラメーター
elapsedTime	long : 呼び出しの経過時間 (ミリ秒)

呼び出し失敗

public void invocationFailed (FailureDescription failure)

何らかのエラー状態による不完全な呼び出しを報告します。

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

パラメーター
failure	FailureDescription : 失敗の原因を説明するFailureDescription

呼び出し失敗

public void invocationFailed (Throwable cause)

何らかのエラー状態による不完全な呼び出しを報告します。

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

パラメーター
cause	Throwable : ERROR(/Throwable)失敗の原因

呼び出しが中断されました

public void invocationInterrupted ()

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

呼び出し開始

public void invocationStarted (IInvocationContext context)

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

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

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

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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