ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


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

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)

テスト実行の終了をレポートします。修正: 2 つの Map<> は使用できないインターフェースが異なるため、 ここでは HashMap を使用する必要があります。

パラメータ
elapsedTimeMillis long: デバイスで報告された経過時間(ミリ秒単位)

runMetrics : Metric を使用してテスト実行終了時にレポートされる 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 の異なる試行を識別する注文番号 実行されるリソースのことですtryNumber の値は、0 から始まる番号で、毎回増分する必要があります。 発生します。例:テストは詳細に 3 回再試行され、合計 4 回試行される必要がある 同じ runName で実行され、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 の異なる試行を識別する注文番号 実行されるリソースのことですtryNumber の値はインデックスが 0 で、 発生します。例:テストを細かく 3 回再試行します。合計 4 回の実行が必要です。 同じ runName の下にあり、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: テストを識別します。