گیرنده ITestLifeCycle
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
اعلان های رویداد را در طول اجرای تست ابزار دقیق دریافت می کند.
الگوی org.junit.runner.notification.RunListener
ترتیب تماس ها به صورت زیر خواهد بود:
- testRunStarted
- تست شروع شد
- [تست ناموفق]
- [testAssumption Failure]
- [تست نادیده گرفته شد]
- تست پایان یافت
- ....
- [testRunFailed]
- testRunEnded
خلاصه
روش های عمومی | |
---|---|
default void | testAssumptionFailure ( TestDescription test, String trace) زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود |
default void | testAssumptionFailure ( TestDescription test, FailureDescription failure) زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود |
default void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) جایگزینی برای |
default void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) پایان اجرای یک مورد آزمایشی فردی را گزارش می کند. |
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, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) گزارش پایان اجرای آزمایشی |
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) شروع یک مورد آزمایشی فردی را گزارش می دهد. |
روش های عمومی
آزمون فرض شکست
public void testAssumptionFailure (TestDescription test, String trace)
زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
trace | String : ردپای شکست |
آزمون فرض شکست
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
failure | FailureDescription : FailureDescription که شکست و زمینه آن را توصیف می کند. |
تست پایان یافت
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) از معیارهای منتشر شده |
تست پایان یافت
public void testEnded (TestDescription test,testMetrics)
پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.
اگر testFailed(TestDescription, FailureDescription)
فراخوانی نمی شد، این آزمایش با موفقیت انجام شد. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد آزمایشی منتشر شده باشد، برمی گرداند.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
testMetrics | ERROR(/Map) از معیارهای منتشر شده |
تست شکست خورد
public void testFailed (TestDescription test, FailureDescription failure)
گزارش شکست یک مورد آزمایشی فردی.
بین testStarted و testEnded فراخوانی خواهد شد.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
failure | FailureDescription : FailureDescription که شکست و زمینه آن را توصیف می کند. |
تست شکست خورد
public void testFailed (TestDescription test, String trace)
گزارش شکست یک مورد آزمایشی فردی.
بین testStarted و testEnded فراخوانی خواهد شد.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
trace | String : ردپای شکست |
تست نادیده گرفته شد
public void testIgnored (TestDescription test)
زمانی که آزمایشی اجرا نمیشود نامیده میشود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیهنویسی میشود.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
گزارش پایان اجرای آزمایشی FIXME: ما نمی توانیم دو رابط Map<> با نوع متفاوت داشته باشیم، بنابراین باید از HashMap در اینجا استفاده کنیم.
پارامترها | |
---|---|
elapsedTimeMillis | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
runMetrics | Metric گزارش شده است. |
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 که چندین بار اجرا میشوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 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 که چندین بار اجرا میشوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد. |
startTime | long : زمان شروع اجرا، اندازهگیری شده از طریق System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
اجرای آزمایشی گزارشها قبل از تکمیل به دلیل درخواست کاربر متوقف شد.
TODO: در حال حاضر استفاده نشده است، حذف را در نظر بگیرید
پارامترها | |
---|---|
elapsedTime | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
تست رد شد
public void testSkipped (TestDescription test, SkipReason reason)
زمانی فراخوانی میشود که آزمایشی نادیده گرفته میشود و به دلیلی که معمولاً انتظار نمیرود اجرا نمیشود. سعی می شود این تست ها مجددا امتحان شوند تا اجرای مناسبی انجام شود.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
reason | SkipReason : SkipReason |
تست شروع شد
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() |
تست شروع شد
public void testStarted (TestDescription test)
شروع یک مورد آزمایشی فردی را گزارش می دهد. رابط قدیمیتر، باید در صورت امکان testStarted(com.android.tradefed.result.TestDescription)
استفاده کند.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |