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, testMetrics)

個々のテストケースの実行終了を報告します。
abstract void testFailed(TestIdentifier test, String trace)

個々のテストケースの失敗を報告します。
abstract void testIgnored(TestIdentifier test)

テストが実行されない場合に呼び出されます。通常、テストメソッドに org.junit.Ignore のアノテーションが付いていることが原因です。
abstract void testRunEnded(long elapsedTime, 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, 
                 testMetrics)

個々のテストケースの実行終了を報告します。

testFailed(TestIdentifier, String) が呼び出されなかった場合、このテストは合格です。テストケースの実行中に生成された Key-Value 指標も返します。

パラメータ
test TestIdentifier: テストを識別します
testMetrics : android.app.Instrumentation#sendStatus によるテストケースの実行中に生成された指標の ERROR(/Map)。同じキーを複数回出力しない限り、挿入順序は保持されます。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, 
                 runMetrics)

テスト実行の終了を報告します。

パラメータ
elapsedTime long: デバイスが報告した経過時間（ミリ秒単位）
runMetrics : android.app.Instrumentation#addResults によるテストケースの実行中に生成された指標の ERROR(/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: テストを識別します