ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

既知の間接的なサブクラス AggregatePostProcessor、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BasePostProcessor、BluetoothConnectionLatencyCollector、BluetoothConnectionStateCollector、BluetoothConnectionSuccessRatePostProcessor、BluetoothHciSnoopLogCollector、BugreportCollector、BugreportzOnFailureCollector、BugreportzOnTestCaseFailureCollector、ClangCodeCoverageCollector、CollectingTestListener、その他 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 実行中のテストケースが失敗した場合に、bugreportz を収集します。  ClangCodeCoverageCollector デバイスから Clang カバレッジ測定値を取得し、テスト アーティファクトとしてログに記録する BaseDeviceMetricCollector。  CollectingTestListener すべてのテスト結果を収集する ITestInvocationListener。  CommandStatusHandler 呼び出しのステータスのモニタリングと更新に役立つハンドラ。  ConditionFailureMonitor 呼び出しでエラーが発生していないかモニタリングします。  ConsoleResultReporter テスト結果をコンソールに出力する結果レポーター。  CountTestCasesCollector 特定の IRemoteTest のテストケースの数をカウントして報告します。  CountingTestResultListener TestStatus ごとのテスト数の合計を追跡する TestResultListener 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 が詳細な結果の受信をサポートするかどうかを指定するインターフェース。  ITestInvocationListener テスト呼び出しからのテスト結果のリスナー。  ITestSummaryListener ITestInvocationListener がサマリーを介して限定的な情報を交換できるようにするインターフェース。  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 結果とログイベントのフォワーダー。  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 スイート呼び出し全体のテスト結果を収集し、最終結果を出力します。  TestResultListener 個々のテスト結果のみを気にする実装者向けに ITestLifecycleListener を簡素化したもの。  TestRunResultListener 最終的なテスト実行ステータスを読み取ることができるリスナー。  TestTimeoutEnforcer 特定のテストケースの実行時間をチェックし、指定したタイムアウトを超えると失敗するリスナー。  TextResultReporter 結果を JUnit テキスト結果プリンタに転送するテスト結果レポーター。  TraceCmdCollector trace-cmd を使用してテスト中にトレースを収集し、呼び出しにログに記録する IMetricCollector。  TradefedSandboxRunner.StubScheduledInvocationListener 何もしないスタブ IScheduledInvocationListener。  XmlFormattedGeneratorReporter スイートの結果を XML 形式でフォーマットする FormattedGeneratorReporter の実装。  XmlResultReporter JUnit の結果を XML ファイルに書き込みます。形式は Ant の XMLJUnitResultFormatter と一致します。

---

インストルメンテーション テストの実行中にイベント通知を受信します。

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: オーダー番号。同じ runName を複数回実行する際の試行を識別します。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: オーダー番号。同じ runName を複数回実行する際の試行を識別します。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: テストを識別します。