ITestRunListener
public
interface
ITestRunListener
| com.android.ddmlib.testrunner.ITestRunListener |
インストルメンテーション テストの実行中にイベント通知を受け取ります。
org.junit.runner.notification.RunListener に基づいています。
呼び出しの順序は次のようになります。
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
概要
パブリック メソッド | |
|---|---|
abstract
void
|
testAssumptionFailure(TestIdentifier test, String trace)
アトミック テストで、false の条件を想定していることが示されたときに呼び出されます。 |
abstract
void
|
testEnded(TestIdentifier test, Map<String, String> testMetrics)
個々のテストケースの実行終了を報告します。 |
abstract
void
|
testFailed(TestIdentifier test, String trace)
個々のテストケースの失敗を報告します。 |
abstract
void
|
testIgnored(TestIdentifier test)
テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore. のアノテーションが付けられていることが原因です。 |
abstract
void
|
testRunEnded(long elapsedTime, Map<String, String> runMetrics)
テスト実行の終了を報告します。 |
abstract
void
|
testRunFailed(String errorMessage)
致命的なエラーによりテスト実行を完了できなかったことを報告します。 |
abstract
void
|
testRunStarted(String runName, int testCount)
テスト実行の開始を報告します。 |
abstract
void
|
testRunStopped(long elapsedTime)
このメソッドは非推奨です。 このコールバックが呼び出されることはありません。削除予定です。 |
abstract
void
|
testStarted(TestIdentifier test)
個々のテストケースの開始を報告します。 |
パブリック メソッド
testAssumptionFailure
public abstract void testAssumptionFailure (TestIdentifier test, String trace)
アトミック テストで、false の条件を想定していることが示されたときに呼び出されます。
| パラメータ | |
|---|---|
test |
TestIdentifier: テストを識別します。 |
trace |
String: 失敗のスタック トレース。 |
testEnded
public abstract void testEnded (TestIdentifier test, Map<String, String> testMetrics)
個々のテストケースの実行終了を報告します。
testFailed(TestIdentifier, String) が呼び出されなかった場合、このテストは合格しています。また、テストケースの実行中に生成された Key-Value
指標も返します。
| パラメータ | |
|---|---|
test |
TestIdentifier: テストを識別します。 |
testMetrics |
Map: テストケースの実行中に生成された指標の Map。
android.app.Instrumentation#sendStatus によって。同じキーを複数回生成しない限り、挿入順序は保持されます
。IInstrumentationResultParser.StatusKeys で定義されている標準キーは、この Map から除外されます。Ddmlib は、
IInstrumentationResultParser.StatusKeys で定義されている追加のテスト指標を追加する場合があります。 |
testFailed
public abstract void testFailed (TestIdentifier test, String trace)
個々のテストケースの失敗を報告します。
testStarted と testEnded の間に呼び出されます。
| パラメータ | |
|---|---|
test |
TestIdentifier: テストを識別します。 |
trace |
String: 失敗のスタック トレース。 |
testIgnored
public abstract void testIgnored (TestIdentifier test)
テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付けられていることが原因です。
| パラメータ | |
|---|---|
test |
TestIdentifier: テストを識別します。 |
testRunEnded
public abstract void testRunEnded (long elapsedTime,
Map<String, String> runMetrics)テスト実行の終了を報告します。
| パラメータ | |
|---|---|
elapsedTime |
long: デバイスから報告された経過時間（ミリ秒単位）。 |
runMetrics |
Map: android.app.Instrumentation#addResults によってテストケースの実行中に生成された指標の Map。同じキーを複数回生成しない限り、挿入順序は保持されます
。IInstrumentationResultParser.StatusKeys で定義されている標準キーは、この Map から除外されます。Ddmlib は、
IInstrumentationResultParser.StatusKeys で定義されている追加のテスト指標を追加する場合があります。 |
testRunFailed
public abstract void testRunFailed (String errorMessage)
致命的なエラーによりテスト実行を完了できなかったことを報告します。
| パラメータ | |
|---|---|
errorMessage |
String: 実行の失敗理由を説明する String。 |
testRunStarted
public abstract void testRunStarted (String runName,
int testCount)テスト実行の開始を報告します。
| パラメータ | |
|---|---|
runName |
String: テスト実行名。 |
testCount |
int: テスト実行のテストの合計数。 |
testRunStopped
public abstract void testRunStopped (long elapsedTime)
このメソッドは非推奨です。
このコールバックが呼び出されることはありません。削除予定です。
ユーザー リクエストにより、完了前にテスト実行が停止したことを報告します。
| パラメータ | |
|---|---|
elapsedTime |
long: デバイスから報告された経過時間（ミリ秒単位）。 |
testStarted
public abstract void testStarted (TestIdentifier test)
個々のテストケースの開始を報告します。
| パラメータ | |
|---|---|
test |
TestIdentifier: テストを識別します。 |