BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.BugreportCollector

ITestInvocationListener للمرور بدون معالجة تجمع تقارير الأخطاء عند حدوث أحداث قابلة للضبط ، ثم تستدعي ITestInvocationListener#testLog في عناصرها الفرعية بعد جمع كل تقرير أخطاء.

السلوكيات: (FIXME: finish this)

  • تسجيل البيانات بعد كل اختبار في حال تعذّر إكمال أي اختبارات
  • الالتقاط بعد كل اختبار
  • الالتقاط بعد كل نموذج اختبار تعذّر إكماله
  • تصوير القصة

ملخّص

الفئات المُدمجة

enum BugreportCollector.Filter

 

enum BugreportCollector.Freq

 

enum BugreportCollector.Noun

 

class BugreportCollector.Predicate

عبارة تحديد كاملة تصف حالات إنشاء تقرير أخطاء. 

enum BugreportCollector.Relation

 

interface BugreportCollector.SubPredicate

 

الحقول

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

عبارة شرطية محدّدة مسبقًا يتمّ تشغيلها بعد كلّ حالة اختبار تنتهي بالفشل

public static final BugreportCollector.Predicate AT_START

عبارة شرطية محدّدة مسبقًا يتم تفعيلها عند بدء الطلب الأول

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

BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

الطرق العامة

void addPredicate(BugreportCollector.Predicate p)
void blockUntilIdle()

يمكنك حظر التطبيق إلى أن يتوقف عن جمع أي تقارير أخطاء.

TestSummary getSummary()

void invocationEnded(long elapsedTime)

void invocationFailed(Throwable cause)

void invocationStarted(IInvocationContext context)

void setAsynchronous(boolean asynchronous)

حدِّد ما إذا كان يجب أن تجمع ميزة جمع تقارير الأخطاء تقرير الخطأ في سلسلة محادثات مختلفة (asynchronous = true)، أو أن تحظر المتصل إلى أن يتم تسجيل تقرير الخطأ (asynchronous = false).

void setDescriptiveName(String name)

اضبط الاسم الوصفي لاستخدامه عند تسجيل تقارير الأخطاء.

void setDeviceWaitTime(int waitTime)

يمكنك ضبط الوقت (بالثواني) للانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت قبل محاولة تسجيل تقرير أخطاء.

void testAssumptionFailure(TestDescription test, String trace)

void testEnded(TestDescription test, testMetrics)
void testFailed(TestDescription test, String trace)

void testIgnored(TestDescription test)
void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

void testRunEnded(long elapsedTime, runMetrics)

void testRunFailed(String errorMessage)

void testRunStarted(String runName, int testCount)

void testRunStopped(long elapsedTime)

void testStarted(TestDescription test)

الحقول

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

عبارة شرطية محدّدة مسبقًا يتمّ تشغيلها بعد كلّ حالة اختبار تنتهي بالفشل

AT_START

public static final BugreportCollector.Predicate AT_START

عبارة شرطية محدّدة مسبقًا يتم تفعيلها عند بدء الطلب الأول

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

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

المعلمات
listener ITestInvocationListener

testDevice ITestDevice

الطرق العامة

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

المعلمات
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

يمكنك حظر التطبيق إلى أن يتوقف عن جمع أي تقارير أخطاء. إذا لم يكن جامع البيانات يجمع بشكل نشط تقرير أخطاء، يجب الرجوع فورًا.

getSummary

public TestSummary getSummary ()

المرتجعات
TestSummary

invocationEnded

public void invocationEnded (long elapsedTime)

المعلمات
elapsedTime long

invocationFailed

public void invocationFailed (Throwable cause)

المعلمات
cause Throwable

invocationStarted

public void invocationStarted (IInvocationContext context)

المعلمات
context IInvocationContext

setAsynchronous

public void setAsynchronous (boolean asynchronous)

حدِّد ما إذا كان يجب أن تجمع ميزة جمع تقارير الأخطاء تقرير الخطأ في سلسلة محادثات مختلفة (asynchronous = true)، أو أن تحظر المتصل إلى أن يتم تسجيل تقرير الخطأ (asynchronous = false).

المعلمات
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

اضبط الاسم الوصفي لاستخدامه عند تسجيل تقارير الأخطاء. في حال null، BugreportCollector سيعود إلى السلوك التلقائي لتسلسل اسم الحدث الذي أدّى إلى جمع تقرير الخطأ.

المعلمات
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

يمكنك ضبط الوقت (بالثواني) للانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت قبل محاولة تسجيل تقرير أخطاء. إذا كانت القيمة سالبة، لن يتم إجراء أي عملية تحقّق. سيتم تسجيل أي DeviceNotAvailableException يتم العثور عليه أثناء عملية التحقّق هذه وستتم تجاهله.

المعلمات
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

المعلمات
test TestDescription

trace String

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

المعلمات
test TestDescription

testMetrics

testFailed

public void testFailed (TestDescription test, 
                String trace)

المعلمات
test TestDescription

trace String

testIgnored

public void testIgnored (TestDescription test)

المعلمات
test TestDescription

testLog

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

المعلمات
dataName String

dataType LogDataType

dataStream InputStreamSource

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

المعلمات
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (String errorMessage)

المعلمات
errorMessage String

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

المعلمات
runName String

testCount int

testRunStopped

public void testRunStopped (long elapsedTime)

المعلمات
elapsedTime long

testStarted

public void testStarted (TestDescription test)

المعلمات
test TestDescription