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)
テスト実行の終了を報告します。
パラメータ | |
---|---|
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 の異なる試行を識別する注文番号。tryNumber の値は 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 : テストを識別します。 |