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 جزءًا من السلسلة، سيؤدي ذلك إلى حلقة لا نهائية.

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

TestFailureListener

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

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

الطرق العامة

applyModuleConfiguration

public void applyModuleConfiguration (boolean bugreportOnFailure)

يسمح هذا الخيار بإلغاء إعدادات الاستدعاء لميزة "التسجيل عند حدوث خطأ" من خلال الإعدادات الخاصة بالوحدة.

المعلمات
bugreportOnFailure	‫boolean: true لإنشاء تقرير أخطاء عند تعذُّر الاختبار خطأ بخلاف ذلك.

انضمام

public void join ()

عليك الانضمام إلى جميع سلاسل المحادثات التي تلتقط logcat لضمان إنهائها.

setLogger

public void setLogger (ITestLogger logger)

لضبط المكان الذي يجب حفظ السجلات فيه

المعلمات
logger	ITestLogger

testFailed

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

المعلمات
dataName	String: اسم String وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدة طلبات باستخدام dataName نفسه.
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