جامع الأخطاء
public class BugreportCollector
extends Object
implements ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.BugreportCollector |
برنامج ITestInvocationListener
المار الذي يجمع تقارير الأخطاء عند حدوث أحداث قابلة للتكوين ثم يستدعي ITestInvocationListener#testLog
على عناصره الفرعية بعد جمع كل تقرير خطأ.
السلوكيات: (FIXME: finish this)
- التقط بعد كل منها إذا فشلت أي حالات اختبار
- التقاط بعد كل testcase
- التقط بعد كل testcase فاشلة
- يأسر
ملخص
فئات متداخلة | |
---|---|
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) عيّن ما إذا كان يجب أن تجمع مجموعة تقرير الأخطاء تقرير الخطأ في سلسلة رسائل مختلفة ( |
void | setDescriptiveName (String name) عيّن الاسم الوصفي المراد استخدامه عند تسجيل تقارير الأخطاء. |
void | setDeviceWaitTime (int waitTime) اضبط الوقت (بالثواني) لانتظار اتصال الجهاز بالإنترنت قبل أن نحاول التقاط تقرير خطأ. |
void | testAssumptionFailure ( TestDescription test, String trace) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ |
void | testEnded ( TestDescription test, testMetrics) 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) 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
مسند محدد مسبقًا يتم إطلاقه بعد كل حالة اختبار فاشلة
في البداية
public static final BugreportCollector.Predicate AT_START
المسند المحدد مسبقًا الذي يتم إطلاقه عند بدء الاحتجاج الأول
المنشأت العامة
جامع الأخطاء
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 ()
يسمح لـ InvocationListener بإرجاع ملخص.
عائدات | |
---|---|
TestSummary | A TestSummary يلخص المدى ، أو لا شيء |
انتهى الدعاء
public void invocationEnded (long elapsedTime)
التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.
حدود | |
---|---|
elapsedTime | long : الوقت المنقضي للاستدعاء بالمللي ثانية |
الدعاء فشل
public void invocationFailed (Throwable cause)
يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.
حدود | |
---|---|
cause | Throwable : سبب ERROR(/Throwable) للفشل |
بدأ الاحتجاج
public void invocationStarted (IInvocationContext context)
يُبلغ عن بدء استدعاء الاختبار.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم تقارير الأجهزة المتعددة.
حدود | |
---|---|
context | IInvocationContext : معلومات حول الاستدعاء |
تعيين غير متزامن
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 : كومة تتبع الفشل |
انتهى الاختبار
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 : كومة تتبع الفشل |
test تم تجاهله
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))
سيقوم إطار عمل TradeFederation باستدعاء هذه الطريقة تلقائيًا ، مع توفير سجل المضيف وإذا أمكن ، تسجيل الجهاز.
حدود | |
---|---|
dataName | String : ERROR(/String) اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم dataName فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات |
dataType | LogDataType : LogDataType للبيانات |
dataStream | InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog. |
انتهى الاختبار
public void testRunEnded (long elapsedTime,runMetrics)
يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.
حدود | |
---|---|
elapsedTime | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
تقارير فشل التشغيل الاختباري بسبب خطأ فادح.
حدود | |
---|---|
errorMessage | String : ERROR(/String) تصف سبب فشل التشغيل. |
testRunStarted
public void testRunStarted (String runName, int testCount)
يعلن عن بدء تشغيل اختباري.
حدود | |
---|---|
runName | String : اسم التشغيل التجريبي |
testCount | int : إجمالي عدد الاختبارات في التشغيل التجريبي |
testRunStopped
public void testRunStopped (long elapsedTime)
تم إيقاف تشغيل اختبار التقارير قبل الإكمال بناءً على طلب المستخدم.
TODO: غير مستخدم حاليًا ، جرب الإزالة
حدود | |
---|---|
elapsedTime | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
اختبار
public void testStarted (TestDescription test)
يُبلغ عن بداية حالة اختبار فردية. الواجهة الأقدم ، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن ذلك.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-03-30 (حسب التوقيت العالمي المتفَّق عليه)