ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

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

تم تصميمها على غرار org.junit.runner.notification.RunListener

سيكون تسلسل المكالمات على النحو التالي:

  • testRunStarted
  • testStarted
  • [testFailed]
  • [testAssumptionFailure]
  • [testIgnored]
  • testEnded
  • ....
  • [testRunFailed]
  • testRunEnded

ملخّص

الطُرق العامة

abstract void testAssumptionFailure(TestIdentifier test, String trace)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

abstract void testEnded(TestIdentifier test, testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

abstract void testFailed(TestIdentifier test, String trace)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

abstract void testIgnored(TestIdentifier test)

يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.

abstract void testRunEnded(long elapsedTime, runMetrics)

تقارير نهاية عملية الاختبار

abstract void testRunFailed(String errorMessage)

تعذّر إكمال تشغيل الاختبار للتقارير بسبب حدوث خطأ فادح.

abstract void testRunStarted(String runName, int testCount)

تسجيل بداية تشغيل الاختبار

abstract void testRunStopped(long elapsedTime)

تم إيقاف هذه الطريقة نهائيًا. لن يتم استدعاء هذا الإجراء مطلقًا. سيتم حذفها.

abstract void testStarted(TestIdentifier test)

تسجّل هذه السمة بداية حالة اختبار فردية.

الطُرق العامة

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

المعلمات
test ‫TestIdentifier: تحدّد الاختبار
trace ‫String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestIdentifier, String)، تكون هذه الحالة قد اجتازت الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة ربما تم إصدارها أثناء تنفيذ حالة الاختبار.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار
testMetrics ‫: ERROR(/Map) من المقاييس التي يتم إرسالها أثناء تنفيذ حالة الاختبار بواسطة android.app.Instrumentation#sendStatus يتم الاحتفاظ بترتيب الإدخال ما لم يتم إصدار المفتاح نفسه عدة مرات. يُرجى العِلم أنّه يتم استبعاد المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذه الخريطة. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

تسجّل هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

سيتم استدعاؤه بين testStarted وtestEnded.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار
trace ‫String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public abstract void testIgnored (TestIdentifier test)

يتم استدعاؤها عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار يتم شرحها باستخدام org.junit.Ignore.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

تقارير نهاية عملية الاختبار

المعلمات
elapsedTime ‫long: الجهاز أبلغ عن الوقت المنقضي بالمللي ثانية
runMetrics ‫: ERROR(/Map) من المقاييس التي يتم إرسالها أثناء تنفيذ حالة الاختبار بواسطة android.app.Instrumentation#addResults يتم الاحتفاظ بترتيب الإدخال ما لم يتم إصدار المفتاح نفسه عدة مرات. يُرجى العِلم أنّه يتم استبعاد المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذه الخريطة. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل الاختبار للتقارير بسبب حدوث خطأ فادح.

المعلمات
errorMessage String: String تصف سبب تعذُّر تنفيذ العملية.

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

تسجيل بداية تشغيل الاختبار

المعلمات
runName ‫String: اسم عملية التشغيل الاختبارية
testCount ‫int: إجمالي عدد الاختبارات في عملية الاختبار

testRunStopped

public abstract void testRunStopped (long elapsedTime)

تم إيقاف استخدام هذه الطريقة نهائيًا.
لن يتم استدعاء دالة الرجوع هذه أبدًا. سيتم حذفها.

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

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

testStarted

public abstract void testStarted (TestIdentifier test)

تسجّل هذه السمة بداية حالة اختبار فردية.

المعلمات
test ‫TestIdentifier: تحدّد الاختبار