أداة 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، لا تسجِّل هذه الفئة وقت تنفيذ اختبارات .

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

تم نقلها من عدّاء دالفيك 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 ()

الطرق العامة

تم إنهاء الاستدعاء

public void invocationEnded (long elapsedTime)

البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.

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

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

ملف setLogSaver

public void setLogSaver (ILogSaver logSaver)

يمكنك ضبط ILogSaver للسماح لأداة التنفيذ بحفظ الملفات.

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

فشل الاختبار

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.

تم حفظ سجلّ الاختبار

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 الذي يحتوي على البيانات الوصفية للملف المحفوظ.