جهاز استقبال ITestLifeCycleRecipient

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


يتلقى إشعارات الأحداث أثناء عمليات تشغيل اختبار قياس حالة التطبيق

نمط بعد org.junit.runner.notification.RunListener

سيكون تسلسل المكالمات كما يلي:

  • أمر testRunStarted
  • تم بدء الاختبار
  • [تعذّر الاختبار]
  • [testAssumptionFailure]
  • [تم تجاهله]
  • انتهى الاختبار
  • ....
  • [فشل اختبار التشغيل]
  • اختبار RunEnded

ملخّص

الطرق العامة

default void testAssumptionFailure(TestDescription test, String trace)

يتم استدعاؤه عندما يُبلغ الاختبار الذري عن أنه يفترض شرطًا خاطئًا

default void testAssumptionFailure(TestDescription test, FailureDescription failure)

يتم استدعاؤه عندما يُبلغ الاختبار الذري عن أنه يفترض شرطًا خاطئًا

default void testEnded(TestDescription test, long endTime, testMetrics)

بديل عن ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.

default void 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.تجاهل.

default void testRunEnded(long elapsedTimeMillis, runMetrics)

نهاية تشغيل اختبار التقارير

default void testRunFailed(FailureDescription failure)

تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل FailureDescription.

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)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت إجراء الاختبار تم البدء، إلى جانب ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))، للحصول على قياس دقيق.

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.تجاهل.

المعلمات
test TestDescription: يحدد الاختبار

اختبار RunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام 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: رقم الطلب، مع تحديد المحاولات المختلفة لعملية runName نفسها يتم تشغيلها عدة مرات. تكون المحاولة رقم 0 مفهرسة ويجب أن تزيد في كل مرة. عملية تشغيل جديدة. مثلاً: تمّت إعادة المحاولة 3 مرّات بدقة أكبر، ويجب أن يتضمّن إجمالي 4 اختبارات. تحت نفس runName ، ويكون الناتج من 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 نفسها يتم تشغيلها عدة مرات. تكون محاولة الحساب مفهرسة بمقدار 0 ويجب أن تزيد في كل مرة تشغيل جديد. مثلاً: تتم إعادة محاولة الاختبار بدقة 3 مرات، ومن المفترض أن يتضمن إجمالي 4 نقاط. تحت نفس runName ، ويتراوح عدد المحاولة بين 0 و3.

startTime long: وقت بدء الجري، ويتم قياسه من خلال System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.

قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها

المعلمات
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: يحدد الاختبار