TestFailureListener
public
class
TestFailureListener
extends Object
implements
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.testtype.suite.TestFailureListener |
كان المستمع يُستخدَم لاتّخاذ إجراء، مثل لقطة شاشة أو تقرير أخطاء أو جمع logcat عند تعذُّر الاختبار عند الطلب.
ملخّص
وظائف الإنشاء العامة | |
---|---|
TestFailureListener(
|
الطرق العامة | |
---|---|
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 |