تمت ترجمة هذه الصفحة بواسطة 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`