ITestLifeCycleReceiver
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
يتلقى إخطارات الحدث أثناء تشغيل اختبار الأجهزة.
منقوشة بعد org.junit.runner.notification.RunListener
سيكون تسلسل المكالمات كما يلي:
- testRunStarted
- testStarted
- [فشل الاختبار]
- [اختبار افتراض الفشل]
- [تم تجاهل الاختبار]
- انتهى الاختبار
- ....
- [فشل اختبار التشغيل]
- 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 | testStarted ( TestDescription test, long startTime) بديل لـ |
default void | testStarted ( TestDescription test) تقارير بداية حالة اختبار فردية. |
الأساليب العامة
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
يتم استدعاؤها عندما يشير الاختبار الذري إلى أنها تفترض حالة خاطئة
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
trace | String : تتبع مكدس الفشل |
testAssumptionFailure
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 : تتبع مكدس الفشل |
testIgnored
public void testIgnored (TestDescription test)
يتم استدعاؤه عندما لا يتم تشغيل الاختبار، وذلك بشكل عام بسبب إضافة تعليقات توضيحية لطريقة الاختبار باستخدام org.junit.Ignore.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
تقارير نهاية التشغيل التجريبي. إصلاح: لا يمكن أن يكون لدينا واجهتان Map<> بنوع مختلف، لذا يتعين علينا استخدام HashMap هنا.
حدود | |
---|---|
elapsedTimeMillis | long : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية |
runMetrics | Metric . |
فشل تشغيل الاختبار
public void testRunFailed (FailureDescription failure)
فشل تشغيل اختبار التقارير في الاكتمال بسبب الفشل الموصوف بواسطة FailureDescription
.
حدود | |
---|---|
failure | FailureDescription : FailureDescription الذي يصف الفشل وسياقه. |
فشل تشغيل الاختبار
public void testRunFailed (String errorMessage)
فشل تشغيل اختبار التقارير بسبب حدوث خطأ فادح.
حدود | |
---|---|
errorMessage | String : String تصف سبب فشل التشغيل. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
يُعلن عن بداية التشغيل التجريبي.
حدود | |
---|---|
runName | String : اسم التشغيل التجريبي |
testCount | int : العدد الإجمالي للاختبارات في التشغيل التجريبي |
attemptNumber | int : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 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 : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3. |
startTime | long : الوقت الذي بدأ فيه التشغيل، ويتم قياسه عبر System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
توقف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم.
TODO: غير مستخدم حاليًا، فكر في الإزالة
حدود | |
---|---|
elapsedTime | long : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية |
testStarted
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() |
testStarted
public void testStarted (TestDescription test)
تقارير بداية حالة اختبار فردية. الواجهة الأقدم، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن ذلك.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |