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