تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`	: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار