تمت ترجمة هذه الصفحة بواسطة 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)` `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 جزءًا من السلسلة ، فسيؤدي ذلك إلى حلقة لا نهائية.

المنشئون العامة

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

المعلمات
`devices`
`bugReportOnFailure`	`boolean`
`rebootOnFailure`	`boolean`

الطرق العامة

applicationModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

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

المعلمات
`bugreportOnFailure`	`boolean` : صحيح لالتقاط تقرير خطأ عند فشل الاختبار. خطأ خلاف ذلك.

انضم

public void join ()

الانضمام إلى جميع خيوط الالتقاط logcat للتأكد من إنهائها.

setLogger

public void setLogger (ITestLogger logger)

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

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

فشل الاختبار

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 باستدعاء هذه الطريقة تلقائيًا ، مع توفير سجل المضيف وإذا أمكن ، تسجيل الجهاز.

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

testLogForward

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

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

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`