تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

جامع الأخطاء

public class BugreportCollector
extends Object implements ITestInvocationListener

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


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

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

  • التقط بعد كل منها إذا فشلت أي حالات اختبار
  • التقاط بعد كل testcase
  • التقط بعد كل testcase فاشلة
  • يأسر

ملخص

فئات متداخلة

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

يسمح لـ 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) 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 : 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 : String اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم البيانات فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

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 : 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 : يحدد الاختبار