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,
回報個別測試案例的執行結束時間。 |
abstract
void
|
testFailed(TestIdentifier test, String trace)
回報個別測試案例的失敗情形。 |
abstract
void
|
testIgnored(TestIdentifier test)
Called when a test will not be run, generally because a test method is annotated with org.junit.Ignore. |
abstract
void
|
testRunEnded(long elapsedTime,
Reports end of test run. |
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)，這項測試就會通過。也會傳回在測試案例執行期間可能發出的任何鍵/值指標。
| 參數 | |
|---|---|
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：識別測試 |