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, Map<String, String> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية. |
abstract
void
|
testFailed(TestIdentifier test, String trace)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية. |
abstract
void
|
testIgnored(TestIdentifier test)
يتم استدعاؤه عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار تمّت إضافة التعليق التوضيحي org.junit.Ignore إليها. |
abstract
void
|
testRunEnded(long elapsedTime, Map<String, String> 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, Map<String, String> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء testFailed(TestIdentifier, String)، اجتازت هذه الحالة الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة
ربما تم إصدارها أثناء تنفيذ حالة الاختبار.
| المعلَمات | |
|---|---|
test |
TestIdentifier: تحدّد الاختبار |
testMetrics |
Map: 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,
Map<String, String> runMetrics)تقارير نهاية عملية الاختبار
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
runMetrics |
Map: 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: تحدّد الاختبار |