أداة تجميع تقرير الأخطاء

public class BugreportCollector
extends Object implements ITestInvocationListener

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

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

السلوكيات: (FIXME: إنهاء هذا)

  • الالتقاط بعد كل حالة في حال فشل أي حالات اختبار
  • التقاط بعد كل حالة اختبار
  • التقاط بعد كل حالة اختبار فاشلة
  • تصوير القصة

ملخّص

الصفوف المتداخلة

class BugreportCollector.Predicate

فلتر كامل يصف وقت الحصول على تقرير خطأ. 

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()

يسمح هذا الإذن لـ InvocationListener بعرض ملخص.

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)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

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)

تعمل على الإبلاغ عن بداية حالة اختبار فردية.

الحقول

بعد_تعذّر_اختبار_حالات_الخطأ

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

يشير هذا المصطلح إلى فلتر محدَّد مسبقًا يتم إطلاقه بعد كل حالة اختبار فاشلة.

AT_START

public static final BugreportCollector.Predicate AT_START

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

شركة إنشاءات عامة

أداة تجميع تقرير الأخطاء

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

المعلمات
listener ITestInvocationListener

testDevice ITestDevice

الطرق العامة

إضافة فلتر

public void addPredicate (BugreportCollector.Predicate p)

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

blockUntilIdle

public void blockUntilIdle ()

عليك حظرها حتى لا يجمع المجمِّع أي تقارير أخطاء. فإذا لم يكن القائم بالتحميل جمع تقرير بالأخطاء، العودة فورًا

الحصول على الملخص

public TestSummary getSummary ()

يسمح هذا الإذن لـ InvocationListener بعرض ملخص.

المرتجعات
TestSummary علامة TestSummary تلخّص تمرين الجري أو قيمة خالية

تم إنهاء الاستدعاء

public void invocationEnded (long elapsedTime)

البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
elapsedTime long: الوقت المنقضي للاستدعاء بالملي ثانية

تعذّر الاستدعاء

public void invocationFailed (Throwable cause)

تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
cause Throwable: السبب Throwable للتعذُّر

تم بدء الاستدعاء

public void invocationStarted (IInvocationContext context)

يبلِّغ عن بدء الاستدعاء للاختبار.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري. على المبلّغين إلغاء المشاركة هذه الطريقة لإتاحة إعداد تقارير عن أجهزة متعددة.

المعلمات
context IInvocationContext: معلومات عن الاستدعاء

ضبط غير متزامن

public void setAsynchronous (boolean asynchronous)

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

المعلمات
asynchronous boolean

الاسم setDescriptiveName

public void setDescriptiveName (String name)

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

المعلمات
name String

وقت الانتظار لجهاز setDevice

public void setDeviceWaitTime (int waitTime)

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

المعلمات
waitTime int

تعذُّر اختبار الافتراض

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

المعلمات
test TestDescription: يحدد الاختبار
trace String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

انتهى الاختبار

public void testEnded (TestDescription test, 
                 testMetrics)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء الدالة testFailed(TestDescription, FailureDescription)، يعني ذلك أنّه تم اجتياز هذا الاختبار. يتم أيضًا عرض أي مفتاح/قيمة المقاييس التي ربما تكون قد ظهرت أثناء تنفيذ حالة الاختبار.

المعلمات
test TestDescription: يحدد الاختبار
testMetrics : ERROR(/Map) من المقاييس المنبعثة

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر حالة اختبار فردية

سيتم استدعاؤها بين testStarted وtestEnded.

المعلمات
test TestDescription: يحدد الاختبار
trace String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تم تجاهل الاختبار

public void testIgnored (TestDescription test)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

المعلمات
test TestDescription: يحدد الاختبار

testLog

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

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

يجب الاتصال قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سوف يستدعي إطار التجارة الفيدرالية هذه الطريقة تلقائيًا، مما يوفر سجل المضيف وأيضًا، Logcat.

المعلمات
dataName String: اسم String وصفي للبيانات. مثلاً: "device_logcat". ملاحظة قد لا يكون dataName فريدًا في كل استدعاء. أي أنّ القائمين على التنفيذ يجب أن يكونوا قادرين على التعامل مكالمات متعددة باستخدام dataName نفسها
dataType LogDataType: LogDataType للبيانات
dataStream InputStreamSource: InputStreamSource للبيانات. يجب على الجهات التنفيذية استدعاء createInputStream لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال. على المتصلين التأكّد من بقاء مصدر البيانات. موجودة ويمكن الوصول إليها حتى تكتمل طريقة testLog.

اختبار RunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام HashMap هنا.

المعلمات
elapsedTime long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية
runMetrics : يتم الإبلاغ عن أزواج المفتاح/القيمة في نهاية عملية اختبار باستخدام Metric.

اختبار التشغيل فاشل

public void testRunFailed (String errorMessage)

تعذّر إكمال عملية اختبار التقارير بسبب خطأ فادح.

المعلمات
errorMessage String: String يصف سبب تعذُّر التشغيل.

أمر testRunStarted

public void testRunStarted (String runName, 
                int testCount)

تبلّغ عن بدء إجراء اختبار.

المعلمات
runName String: اسم إجراء الاختبار
testCount int: إجمالي عدد الاختبارات أثناء إجراء الاختبار

testRunStopped

public void testRunStopped (long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.

قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها

المعلمات
elapsedTime long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية

تم بدء الاختبار

public void testStarted (TestDescription test)

تعمل على الإبلاغ عن بداية حالة اختبار فردية. واجهة قديمة، ويجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

المعلمات
test TestDescription: يحدد الاختبار