XmlResultReporter

public class XmlResultReporter
extends CollectingTestListener implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.result.XmlResultReporter

---

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

وعلى عكس أداة تنسيق Ant، لا تسجِّل هذه الفئة وقت تنفيذ اختبارات.

تجمع هذه الدالة جميع معلومات الاختبار في الذاكرة، ثم تُفرغها في ملف عند اكتمال الاستدعاء.

تم نقله من dalvik runner XmlReportPrinter.

سيتم تخزين ملفات النتائج في المسار الذي تم إنشاؤه من خلال [--output-file-path]/[build_id]

ملخّص

وظائف الإنشاء العامة
XmlResultReporter()

الطرق العامة
void	invocationEnded(long elapsedTime) تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.
void	setLogSaver(ILogSaver logSaver) اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.
void	testFailed(TestDescription test, String trace) الإبلاغ عن تعذُّر حالة اختبار فردية
void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) يوفّر بيانات السجلّ أو تصحيح الأخطاء المرتبطة من طلب الاختبار.
void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) يتمّ استدعاء هذه الدالة عند حفظ سجلّ الاختبار.

وظائف الإنشاء العامة

XmlResultReporter

public XmlResultReporter ()

الطرق العامة

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
elapsedTime	‫long: الوقت المنقضي منذ بدء الطلب بالملي ثانية

setLogSaver

public void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

المعلمات
logSaver	ILogSaver: ILogSaver

testFailed

public void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر حالة اختبار فردية

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

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

يوفّر بيانات السجلّ أو تصحيح الأخطاء المرتبطة من طلب الاختبار.

يجب الاتصال به قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيستدعي إطار عمل TradeFederation هذه الطريقة تلقائيًا، ما يؤدي إلى توفير سجلّ المضيف وlogcat للجهاز، إن أمكن.

المعلمات
dataName	String: اسم String وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدة طلبات باستخدام dataName نفسه.
dataType	LogDataType: LogDataType البيانات
dataStream	InputStreamSource: InputStreamSource البيانات على مُنفِّذي الإجراء استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية. على المُتصلين التأكّد من بقاء مصدر البيانات حاضرًا ويمكن الوصول إليه إلى أن تكتمل طريقة testLog.

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

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

يجب استخدامه بدلاً من ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

المعلمات
dataName	String: اسم String وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدّة طلبات باستخدام dataName نفسه.
dataType	LogDataType: LogDataType البيانات
dataStream	InputStreamSource: InputStreamSource البيانات على مُنفِّذي الإجراء استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية.
logFile	‫LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ