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، لا يعرض هذا الصف وقت تنفيذ الاختبارات.

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

تم نقله من XmlReportPrinter في برنامج تشغيل Dalvik.

سيتم تخزين ملفات النتائج في المسار الذي تم إنشاؤه من خلال [--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)/ITestInvocationListener#invocationFailed(java.lang.Throwable) 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 الذي يحتوي على البيانات الوصفية للملف المحفوظ