BugreportCollector
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) قم بتعيين ما إذا كان يجب على مجموعة تقارير الأخطاء جمع تقرير الأخطاء في موضوع مختلف ( |
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.Ignore. |
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
مسند محدد مسبقًا يتم تشغيله عند بدء الاستدعاء الأول
المقاولين العامة
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 ()
يسمح لـ InvocationListener بإرجاع ملخص.
عائدات | |
---|---|
TestSummary | TestSummary يلخص التشغيل، أو فارغ |
انتهت الدعوة
public void invocationEnded (long elapsedTime)
تقارير تفيد بأن الاستدعاء قد تم إنهاؤه، سواء بنجاح أو بسبب خطأ ما.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.
حدود | |
---|---|
elapsedTime | long : الوقت المنقضي للاستدعاء في مللي ثانية |
فشل الاستدعاء
public void invocationFailed (Throwable cause)
يُبلغ عن استدعاء غير مكتمل بسبب بعض حالات الخطأ.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.
حدود | |
---|---|
cause | Throwable : السبب Throwable للفشل |
invocationStarted
public void invocationStarted (IInvocationContext context)
تقارير بداية استدعاء الاختبار.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم التقارير على أجهزة متعددة.
حدود | |
---|---|
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 : تتبع مكدس الفشل |
انتهى الاختبار
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 : تتبع مكدس الفشل |
testIgnored
public void testIgnored (TestDescription test)
يتم استدعاؤه عندما لا يتم تشغيل الاختبار، وذلك بشكل عام بسبب إضافة تعليقات توضيحية لطريقة الاختبار باستخدام org.junit.Ignore.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
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 قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات |
dataType | LogDataType : LogDataType للبيانات |
dataStream | InputStreamSource : InputStreamSource للبيانات. يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات، والتأكد من إغلاق InputStream الناتج عند اكتماله. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
تقارير نهاية التشغيل التجريبي. إصلاح: لا يمكن أن يكون لدينا واجهتان Map<> بنوع مختلف، لذا يتعين علينا استخدام 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)
توقف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم.
TODO: غير مستخدم حاليًا، فكر في الإزالة
حدود | |
---|---|
elapsedTime | long : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية |
testStarted
public void testStarted (TestDescription test)
تقارير بداية حالة اختبار فردية. الواجهة الأقدم، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن ذلك.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)