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

أداة TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.testtype.suite.TestFailureListener

أداة معالجة البيانات التي استخدَمت اتخاذ إجراء مثل لقطة الشاشة أو تقرير الأخطاء أو جمع Logcat عند تعذُّر الاختبار عند الطلب.

ملخّص

شركة إنشاءات عامة
`TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)`

الطرق العامة
`void`	`applyModuleConfiguration(boolean bugreportOnFailure)` تسمح بتجاوز إعدادات الاستدعاء للالتقاط عند الفشل من خلال الوحدة الخاصة الإعدادات.
`void`	`join()` انضم إلى جميع سلاسل المحادثات التي تسجِّل في سجلّ Logcat لضمان إنهائها.
`void`	`setLogger(ITestLogger logger)` تعيين أماكن حفظ السجلات.
`void`	`testFailed(TestDescription test, String trace)` الإبلاغ عن تعذُّر حالة اختبار فردية
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` يتم توفير السجلّ المرتبط أو بيانات تصحيح الأخطاء من استدعاء الاختبار.
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` إعادة توجيه السجل إلى المسجّل، ولا تفعل ذلك بدءًا من معاودة الاتصال #testLog كما لو TestFailureListener هو جزء من السلسلة، وسينتج عنه تكرار لا نهائي.

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

public void applyModuleConfiguration (boolean bugreportOnFailure)

تسمح بتجاوز إعدادات الاستدعاء للالتقاط عند الفشل من خلال الوحدة الخاصة الإعدادات.

المعلمات
`bugreportOnFailure`	`boolean`: القيمة "صحيح" لتسجيل تقرير خطأ عند تعذُّر الاختبار. خطأ في الحالات الأخرى.

public void join ()

انضم إلى جميع سلاسل المحادثات التي تسجِّل في سجلّ Logcat لضمان إنهائها.

public void setLogger (ITestLogger logger)

تعيين أماكن حفظ السجلات.

المعلمات
`logger`	`ITestLogger`

public void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر حالة اختبار فردية

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

المعلمات
`test`	`TestDescription`: يحدد الاختبار
`trace`	`String`: تتبع تسلسل استدعاء الدوال البرمجية للفشل

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

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

سيستدعي إطار التجارة الفيدرالية هذه الطريقة تلقائيًا، مما يوفر سجل المضيف وأيضًا، Logcat.

المعلمات
`dataName`	`String`: اسم `String` وصفي للبيانات. مثلاً: "device_logcat". ملاحظة قد لا يكون dataName فريدًا في كل استدعاء. أي أنّ القائمين على التنفيذ يجب أن يكونوا قادرين على التعامل مكالمات متعددة باستخدام dataName نفسها
`dataType`	`LogDataType`: `LogDataType` للبيانات
`dataStream`	`InputStreamSource`: `InputStreamSource` للبيانات. يجب على الجهات التنفيذية استدعاء createInputStream لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال. على المتصلين التأكّد من بقاء مصدر البيانات. موجودة ويمكن الوصول إليها حتى تكتمل طريقة testLog.

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

إعادة توجيه السجل إلى المسجّل، ولا تفعل ذلك بدءًا من معاودة الاتصال #testLog كما لو TestFailureListener هو جزء من السلسلة، وسينتج عنه تكرار لا نهائي.