ITestLifeCycleR Receiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


يتلقى إخطارات الحدث أثناء تشغيل اختبار الأجهزة.

منقوشة بعد org.junit.runner.notification.RunListener

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

  • testRunStarted
  • اختبار
  • [فشل الاختبار]
  • [testAssumptionFailure]
  • [تم تجاهل الاختبار]
  • انتهى الاختبار
  • ....
  • [testRunFailed]
  • انتهى الاختبار

ملخص

الطرق العامة

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)

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

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

default void testRunEnded (long elapsedTimeMillis, runMetrics) 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 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)

يُبلغ عن بداية حالة اختبار فردية.

الطرق العامة

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 : كومة تتبع الفشل

test تم تجاهله

public void testIgnored (TestDescription test)

يتم استدعاؤها عندما لا يتم تشغيل الاختبار ، وذلك عمومًا بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.

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

انتهى الاختبار

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

startTime long : الوقت الذي بدأ فيه التشغيل ، ويتم قياسه عبر System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

تم إيقاف تشغيل الاختبار التجريبي قبل الإكمال بناءً على طلب المستخدم.

TODO: غير مستخدم حاليًا ، جرب الإزالة

المعلمات
elapsedTime long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية

اختبار

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