ITestRunListener
public interface ITestRunListener
| com.android.ddmlib.testunner.ITestRunListener |
در طول اجرای تستهای ابزار دقیق، اعلانهای رویداد را دریافت میکند.
الگوبرداری شده از org.junit.runner.notification.RunListener
توالی تماسها به این صورت خواهد بود:
- تست شروع شد
- تست شروع شد
- [آزمون ناموفق]
- [testAssumptionFailure]
- [آزمون نادیده گرفته شد]
- آزمون پایان یافت
- ....
- [testRunFailed]
- تست اجرا شده
خلاصه
روشهای عمومی | |
|---|---|
abstract void | testAssumptionFailure ( TestIdentifier test, String trace)زمانی فراخوانی میشود که یک آزمایش اتمی، شرطی را نادرست فرض کند. |
abstract void | testEnded ( TestIdentifier test,پایان اجرای یک مورد آزمایشی (test case) را گزارش میدهد. |
abstract void | testFailed ( TestIdentifier test, String trace)گزارش شکست یک مورد آزمایشی منفرد را میدهد. |
abstract void | testIgnored ( TestIdentifier test)زمانی فراخوانی میشود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیهنویسی شده است. |
abstract void | testRunEnded (long elapsedTime,پایان اجرای آزمایش را گزارش میدهد. |
abstract void | testRunFailed (String errorMessage)گزارشها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است. |
abstract void | testRunStarted (String runName, int testCount)شروع یک آزمایش را گزارش میدهد. |
abstract void | testRunStopped (long elapsedTime)این متد منسوخ شده است. این تابع فراخوانی هرگز فراخوانی نمیشود. باید حذف شود. |
abstract void | testStarted ( TestIdentifier test)شروع یک مورد آزمایشی (test case) منفرد را گزارش میدهد. |
روشهای عمومی
آزمون فرض شکست
public abstract void testAssumptionFailure (TestIdentifier test, String trace)
زمانی فراخوانی میشود که یک آزمایش اتمی، شرطی را نادرست فرض کند.
| پارامترها | |
|---|---|
test | TestIdentifier : تست را شناسایی میکند. |
trace | String : ردپای پشته از خرابی |
آزمون پایان یافت
public abstract void testEnded (TestIdentifier test,testMetrics)
پایان اجرای یک مورد آزمایشی (test case) را گزارش میدهد.
اگر testFailed(TestIdentifier, String) فراخوانی نشده باشد، این تست با موفقیت انجام شده است. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد تست منتشر شده باشد، برمیگرداند.
| پارامترها | |
|---|---|
test | TestIdentifier : تست را شناسایی میکند. |
testMetrics | ERROR(/Map) از معیارهای منتشر شده در طول اجرای مورد آزمایشی توسط android.app.Instrumentation#sendStatus . ترتیب درج حفظ میشود مگر اینکه یک کلید مشابه را چندین بار منتشر کنید. توجه داشته باشید که کلیدهای استاندارد تعریف شده در IInstrumentationResultParser.StatusKeys از این Map فیلتر میشوند. Ddmlib ممکن است معیارهای آزمایشی اضافی تعریف شده در IInstrumentationResultParser.StatusKeys را اضافه کند. |
تست ناموفق
public abstract void testFailed (TestIdentifier test, String trace)
گزارش شکست یک مورد آزمایشی منفرد را میدهد.
بین testStarted و testEnded فراخوانی خواهد شد.
| پارامترها | |
|---|---|
test | TestIdentifier : تست را شناسایی میکند. |
trace | String : ردپای پشته از خرابی |
آزمون نادیده گرفته شد
public abstract void testIgnored (TestIdentifier test)
زمانی فراخوانی میشود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیهنویسی شده است.
| پارامترها | |
|---|---|
test | TestIdentifier : تست را شناسایی میکند. |
تست اجرا شده
public abstract void testRunEnded (long elapsedTime,
runMetrics) پایان اجرای آزمایش را گزارش میدهد.
| پارامترها | |
|---|---|
elapsedTime | long : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه |
runMetrics | ERROR(/Map) از معیارهای منتشر شده در طول اجرای مورد آزمایشی توسط android.app.Instrumentation#addResults . ترتیب درج حفظ میشود مگر اینکه یک کلید مشابه را چندین بار منتشر کنید. توجه داشته باشید که کلیدهای استاندارد تعریف شده در IInstrumentationResultParser.StatusKeys از این Map فیلتر میشوند. Ddmlib ممکن است معیارهای آزمایشی اضافی تعریف شده در IInstrumentationResultParser.StatusKeys را اضافه کند. |
تست اجرا ناموفق
public abstract void testRunFailed (String errorMessage)
گزارشها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.
| پارامترها | |
|---|---|
errorMessage | String : String دلیل عدم موفقیت در اجرا را توصیف میکند. |
تست شروع شد
public abstract void testRunStarted (String runName,
int testCount)شروع یک آزمایش را گزارش میدهد.
| پارامترها | |
|---|---|
runName | String : نام اجرای آزمایشی |
testCount | int : تعداد کل تستها در اجرای تست |
testRunStopped
public abstract void testRunStopped (long elapsedTime)
این روش منسوخ شده است.
این تابع فراخوانی هرگز فراخوانی نمیشود. باید حذف شود.
گزارش میدهد که اجرای آزمایشی به دلیل درخواست کاربر قبل از تکمیل متوقف شده است.
| پارامترها | |
|---|---|
elapsedTime | long : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه |
تست شروع شد
public abstract void testStarted (TestIdentifier test)
شروع یک مورد آزمایشی (test case) منفرد را گزارش میدهد.
| پارامترها | |
|---|---|
test | TestIdentifier : تست را شناسایی میکند. |