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,
終了時間を指定できる |
default
void
|
testEnded(TestDescription test,
個々のテストケースの実行終了を報告します。 |
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,
テスト実行の終了をレポートします。 |
default
void
|
testRunFailed(FailureDescription failure)
|
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)
|
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 : テストを識別します。 |