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, 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, metrics) تلغي العنصر الرئيسي لطباعة المقاييس صراحةً.

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

TextResultReporter

public TextResultReporter ()

لإنشاء TextResultReporter.

الطرق العامة

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

تلغي هذه السياسة الإعدادات الأساسية لطباعة مقاييس الاختبار صراحةً.

المعلمات
testId	TestDescription: لتحديد الاختبار
metrics	: ERROR(/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)) أو 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 الذي يحتوي على البيانات الوصفية للملف المحفوظ

testRunEnded

public void testRunEnded (long elapsedTime, 
                 metrics)

تلغي العنصر الرئيسي لطباعة المقاييس صراحةً.

المعلمات
elapsedTime	‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية
metrics	: أزواج المفتاح/القيمة التي يتم تسجيلها في نهاية عملية تنفيذ الاختبار