XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.XmlTestRunListener

يكتب نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

ينشئ ملف XML منفصلاً لكل عملية اختبار.

ملخّص

الإنشاءات العامة

XmlTestRunListener()

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

void addSystemError(String systemError)

إضافة رسالة خطأ في النظام

TestRunResult getRunResult()

تعرض هذه الدالة TestRunResult

String getSystemError()

تعرض هذه السمة رسالة خطأ النظام التي سيتمّ إدراجها في ملف XML في العنصر "system-err".

void setHostName(String hostName)
void setReportDir(File file)

تضبط هذه السمة ملف التقرير الذي سيتم استخدامه.

void testAssumptionFailure(TestIdentifier test, String trace)

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

void testEnded(TestIdentifier test, testMetrics)

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

void testFailed(TestIdentifier test, String trace)

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

void testIgnored(TestIdentifier test)

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

void testRunEnded(long elapsedTime, runMetrics)

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

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int numTests)

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

void testRunStopped(long elapsedTime)

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

void testStarted(TestIdentifier test)

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

الطُرق المحمية

getPropertiesAttributes()

احصل على سمات الخصائص كأزواج مفتاح/قيمة ليتم تضمينها في تقرير الاختبار.

File getResultFile(File reportDir)

تُنشئ ERROR(/File) حيث سيتم إنشاء التقرير.

String getTestName(TestIdentifier testId)
String getTestSuiteName()

الإنشاءات العامة

XmlTestRunListener

public XmlTestRunListener ()

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

addSystemError

public void addSystemError (String systemError)

إضافة رسالة خطأ في النظام

المعلمات
systemError String

getRunResult

public TestRunResult getRunResult ()

تعرض هذه الدالة TestRunResult

المرتجعات
TestRunResult نتائج تشغيل الاختبار

getSystemError

public String getSystemError ()

تعرض هذه السمة رسالة خطأ النظام التي سيتم إدراجها في ملف XML في العنصر "system-err". لا يتم إنشاء العنصر إذا عرض هذا العنصر سلسلة فارغة.

المرتجعات
String

setHostName

public void setHostName (String hostName)

المعلمات
hostName String

setReportDir

public void setReportDir (File file)

تضبط هذه السمة ملف التقرير الذي سيتم استخدامه.

المعلمات
file File

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

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

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

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

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

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

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

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

testIgnored

public void testIgnored (TestIdentifier test)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

testStarted

public void testStarted (TestIdentifier test)

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

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

الطُرق المحمية

getPropertiesAttributes

protected  getPropertiesAttributes ()

احصل على سمات الخصائص كأزواج مفتاح/قيمة ليتم تضمينها في تقرير الاختبار.

المرتجعات

getResultFile

protected File getResultFile (File reportDir)

تُنشئ ERROR(/File) حيث سيتم إنشاء التقرير.

المعلمات
reportDir File: الدليل الجذر للتقرير.
المرتجعات
File ملف
الرميات
IOException

getTestName

protected String getTestName (TestIdentifier testId)

المعلمات
testId TestIdentifier

المرتجعات
String

getTestSuiteName

protected String getTestSuiteName ()

المرتجعات
String