TextResultReporter

public class TextResultReporter
extends InvocationToJUnitResultForwarder implements ILogSaverListener, ITestInvocationListener

java.lang.Object
↳ com.android.tradefed.result.InvocationToJUnitResultForwarder
  ↳ com.android.tradefed.result.TextResultReporter

أداة إعداد تقارير نتائج الاختبار التي تعيد توجيه النتائج إلى أداة طباعة نتائج الاختبار النصية في JUnit

ملخّص

طُرق وضع التصميم العامة

TextResultReporter()

تنشئ TextResultReporter.

الإجراءات العامة

void testAssumptionFailure(TestDescription testId, String trace)

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

void testEnded(TestDescription testId, HashMap<String, MetricMeasurement.Metric> metrics)

تتجاوز هذه الطريقة الطريقة الأصلية لطباعة مقاييس الاختبار بشكلٍ صريح.

void testFailed(TestDescription testId, String trace)

تتجاوز هذه الطريقة الطريقة الأصلية لطباعة حالات الفشل بشكلٍ صريح.

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

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

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

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

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> metrics)

تتجاوز هذه الطريقة الطريقة الأصلية لطباعة المقاييس بشكلٍ صريح.

طُرق وضع التصميم العامة

TextResultReporter

public TextResultReporter ()

تنشئ TextResultReporter.

الإجراءات العامة

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

المعلَمات
testId TestDescription: تحدّد الاختبار
trace String: تتبُّع تسلسل استدعاء الدوال البرمجية لحالة الفشل

testEnded

public void testEnded (TestDescription testId, 
                HashMap<String, MetricMeasurement.Metric> metrics)

تتجاوز هذه الطريقة الطريقة الأصلية لطباعة مقاييس الاختبار بشكلٍ صريح.

المعلَمات
testId TestDescription: تحدّد الاختبار
metrics HashMap: ‏Map للمقاييس التي تم إصدارها

testFailed

public void testFailed (TestDescription testId, 
                String trace)

تتجاوز هذه الطريقة الطريقة الأصلية لطباعة حالات الفشل بشكلٍ صريح. تعتمد أداة ResultPrinter على أداة التشغيل التي تستدعي "طباعة" في نهاية تشغيل الاختبار لتنفيذ ذلك. تُبلغ هذه الطريقة عن فشل حالة اختبار فردية.

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

المعلَمات
testId 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 فريدًا لكل استدعاء، ما يعني أنّه يجب أن يكون بإمكان المنفّذين التعامل مع استدعاءات متعددة بالاسم نفسه
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 فريدًا لكل استدعاء، ما يعني أنّه يجب أن يكون بإمكان المنفّذين التعامل مع استدعاءات متعددة بالاسم نفسه
dataType LogDataType: ‏LogDataType للبيانات
dataStream InputStreamSource: ‏InputStreamSource للبيانات على المنفّذين استدعاء createInputStream لبدء قراءة البيانات، والحرص على إغلاق InputStream الناتج عند اكتمال العملية.
logFile LogFile: ‏LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> metrics)

تتجاوز هذه الطريقة الطريقة الأصلية لطباعة المقاييس بشكلٍ صريح.

المعلَمات
elapsedTime long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالملّي ثانية
metrics HashMap: أزواج المفتاح والقيمة التي يتم الإبلاغ عنها في نهاية تشغيل الاختبار باستخدام Metric