ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

既知の間接的なサブクラス AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CodeCoverageCollector など、84 個のクラスがあります。 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 のテストケースの数をカウントして報告します。  CountingTestResultListener TestStatus ごとのテストの合計数をトラッキングする TestResultListener 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 が詳細な結果の受信をサポートするかどうかを指定するインターフェース。  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 スイート全体の呼び出しのテスト結果を収集し、最終結果を出力します。  TestResultListener 個々のテスト結果のみを気にする実装者向けの ITestLifecycleListener の簡略化。  TestRunResultListener 最終的なテスト実行ステータスを読み取ることができるリスナー。  TestTimeoutEnforcer 特定のテストケースの実行時間をチェックし、指定されたタイムアウトを超えた場合に失敗させるリスナー。  TextResultReporter 結果を JUnit テキスト結果プリンタに転送するテスト結果レポーター。  TraceCmdCollector trace-cmd を使用してテスト中にトレースを収集し、呼び出しに記録する IMetricCollector。  TradefedSandboxRunner.StubScheduledInvocationListener 何も行わないスタブ IScheduledInvocationListener。  XmlFormattedGeneratorReporter スイートの結果を XML 形式でフォーマットする FormattedGeneratorReporter の実装。  XmlResultReporter JUnit の結果を、Ant の XMLJUnitResultFormatter と一貫性のある形式で XML ファイルに書き込みます。

---

計測テストの実行中にイベント通知を受け取ります。

org.junit.runner.notification.RunListener に基づく

呼び出しの順序は次のようになります。

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

概要

パブリック メソッド
default void	testAssumptionFailure(TestDescription test, String trace) アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます。
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます。
default void	testEnded(TestDescription test, long endTime, testMetrics) 終了時間を直接指定できる ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) の代替。
default void	testEnded(TestDescription test, testMetrics) 個々のテストケースの実行終了を報告します。
default void	testFailed(TestDescription test, FailureDescription failure) 個々のテストケースの失敗を報告します。
default void	testFailed(TestDescription test, String trace) 個々のテストケースの失敗を報告します。
default void	testIgnored(TestDescription test) テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付いていることが原因です。
default void	testRunEnded(long elapsedTimeMillis, runMetrics) テスト実行の終了を報告します。
default void	testRunFailed(FailureDescription failure) FailureDescription で説明されているエラーのため、テスト実行を完了できなかったことを報告します。
default void	testRunFailed(String errorMessage) 致命的なエラーのため、レポートのテスト実行を完了できませんでした。
default void	testRunStarted(String runName, int testCount, int attemptNumber) テスト実行の開始を報告します。
default void	testRunStarted(String runName, int testCount) テスト実行の開始を報告します。
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) テスト実行の開始を報告します。
default void	testRunStopped(long elapsedTime) ユーザーのリクエストにより、レポートのテスト実行が完了前に停止しました。
default void	testSkipped(TestDescription test, SkipReason reason) テストがスキップされ、通常は想定されない理由で実行されなかった場合に呼び出されます。
default void	testStarted(TestDescription test, long startTime) testStarted(com.android.tradefed.result.TestDescription) の代替。テストの開始時刻も指定し、ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) と組み合わせて正確な測定を行います。
default void	testStarted(TestDescription test) 個々のテストケースの開始を報告します。

パブリック メソッド

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます

パラメータ
test	TestDescription: テストを識別します
trace	String: 失敗のスタック トレース

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

アトミック テストが、false の条件を想定していることを示すフラグを設定したときに呼び出されます

パラメータ
test	TestDescription: テストを識別します
failure	FailureDescription: 失敗とそのコンテキストを説明する FailureDescription。

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

終了時間を直接指定できる ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) の代替。testStarted(com.android.tradefed.result.TestDescription, long) と組み合わせて正確な測定を行います。

パラメータ
test	TestDescription: テストを識別します
endTime	long: テストが終了した時刻（System.currentTimeMillis() で測定）
testMetrics	: 出力された指標の ERROR(/Map)

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

個々のテストケースの実行終了を報告します。

testFailed(TestDescription, FailureDescription) が呼び出されなかった場合、このテストは合格です。テストケースの実行中に生成された Key-Value 指標も返します。

パラメータ
test	TestDescription: テストを識別します
testMetrics	: 出力された指標の ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

個々のテストケースの失敗を報告します。

testStarted と testEnded の間に呼び出されます。

パラメータ
test	TestDescription: テストを識別します
failure	FailureDescription: 失敗とそのコンテキストを説明する FailureDescription。

testFailed

public void testFailed (TestDescription test, 
                String trace)

個々のテストケースの失敗を報告します。

testStarted と testEnded の間に呼び出されます。

パラメータ
test	TestDescription: テストを識別します
trace	String: 失敗のスタック トレース

testIgnored

public void testIgnored (TestDescription test)

テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付けられていることが原因です。

パラメータ
test	TestDescription: テストを識別します

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

テスト実行の終了を報告します。

パラメータ
elapsedTimeMillis	long: デバイスが報告した経過時間（ミリ秒単位）
runMetrics	: テスト実行の最後にレポートされる Key-Value ペア

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescription で説明されているエラーのため、テスト実行が完了しなかったことを報告します。

パラメータ
failure	FailureDescription: 失敗とそのコンテキストを説明する FailureDescription。

testRunFailed

public void testRunFailed (String errorMessage)

致命的なエラーのため、レポートのテスト実行を完了できませんでした。

パラメータ
errorMessage	String: 実行の失敗理由を説明する String。

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

テスト実行の開始を報告します。

パラメータ
runName	String: テスト実行名
testCount	int: テスト実行のテストの合計数
attemptNumber	int: 実行名が同じで複数回実行される異なる試行を識別する注文番号。attemptNumber は 0 から始まり、新しい実行が発生するたびに増分されます。たとえば、テストが 3 回きめ細かく再試行された場合、同じ runName で合計 4 回の実行が行われ、attemptNumber は 0 ～ 3 になります。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

テスト実行の開始を報告します。

パラメータ
runName	String: テスト実行名
testCount	int: テスト実行のテストの合計数

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

テスト実行の開始を報告します。

パラメータ
runName	String: テスト実行名
testCount	int: テスト実行のテストの合計数
attemptNumber	int: 実行名が同じで複数回実行される異なる試行を識別する注文番号。attemptNumber は 0 から始まるインデックスで、新しい実行が発生するたびに増分されます。たとえば、テストが 3 回きめ細かく再試行される場合、同じ runName で合計 4 回の実行が行われ、attemptNumber は 0 から 3 になります。
startTime	long: 実行が開始された時刻（System.currentTimeMillis() で測定）

testRunStopped

public void testRunStopped (long elapsedTime)

ユーザーのリクエストにより、レポートのテスト実行が完了前に停止しました。

TODO: 現在使用されていません。削除することを検討してください

パラメータ
elapsedTime	long: デバイスが報告した経過時間（ミリ秒単位）

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

テストがスキップされ、通常は想定されない理由で実行されなかった場合に呼び出されます。これらのテストは、適切な実行を試みるために再試行されます。

パラメータ
test	TestDescription: テストを識別します
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

テストの開始時刻も指定する testStarted(com.android.tradefed.result.TestDescription) の代替。ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) と組み合わせて正確な測定を行います。

パラメータ
test	TestDescription: テストを識別します
startTime	long: テストが開始された時刻（System.currentTimeMillis() で測定）

testStarted

public void testStarted (TestDescription test)

個々のテストケースの開始を報告します。古いインターフェース。可能な限り testStarted(com.android.tradefed.result.TestDescription) を使用する必要があります。

パラメータ
test	TestDescription: テストを識別します