InstrumentationResultParser
public
class
InstrumentationResultParser
extends MultiLineReceiver
implements
IInstrumentationResultParser
| java.lang.Object | ||
| ↳ | com.android.ddmlib.MultiLineReceiver | |
| ↳ | com.android.tradefed.result.ddmlib.InstrumentationResultParser | |
تحلّل هذه السمة نتائج "وضع الإخراج الأولي" لتنفيذ اختبار لقياس حالة التطبيق من shell، وتُعلم واجهة ITestRunListener بالنتائج.
من المتوقّع أن يكون الناتج على النحو التالي:
في حال حدوث خطأ فادح عند محاولة إجراء الاختبارات:
INSTRUMENTATION_STATUS: Error=error Message INSTRUMENTATION_FAILED:
أو
INSTRUMENTATION_RESULT: shortMsg=error Message
بخلاف ذلك، توقَّع سلسلة من نتائج الاختبار، تحتوي كل منها على مجموعة من أزواج مفتاح/قيمة الحالة، مفصولة بنتيجة رمز حالة البدء(1)/النجاح(0)/الفشل(-2)/الخطأ(-1). في نهاية تشغيل الاختبار، من المتوقّع أن يتم عرض وقت الاختبار المنقضي بالثواني
على سبيل المثال:
INSTRUMENTATION_STATUS_CODE: 1
INSTRUMENTATION_STATUS: class=com.foo.FooTest
INSTRUMENTATION_STATUS: test=testFoo
INSTRUMENTATION_STATUS: numtests=2
INSTRUMENTATION_STATUS: stack=com.foo.FooTest#testFoo:312
com.foo.X
INSTRUMENTATION_STATUS_CODE: -2
...
Time: X
يُرجى العِلم أنّ جزء "القيمة" من زوج المفتاح/القيمة قد يمتد على عدة أسطر نصية
يمكن استخدام InstrumentationProtoResultParser كبديل. يحتوي المحلّل المستند إلى بروتوكول البيانات على معلومات إضافية، مثل رسالة logcat.
ملخّص
طُرق وضع التصميم العامة | |
|---|---|
InstrumentationResultParser(String runName, ITestRunListener listener)
تنشئ هذه السمة InstrumentationResultParser لمستمع واحد. |
|
InstrumentationResultParser(String runName, Collection<ITestRunListener> listeners)
تُنشئ هذه الدالة الفئة InstrumentationResultParser. |
|
الإجراءات العامة | |
|---|---|
void
|
cancel()
يطلب إلغاء التشغيل التجريبي. |
void
|
done()
يتم استدعاؤها من قِبل الأصل عند اكتمال جلسة adb. |
void
|
handleTestRunFailed(String errorMsg)
يتم استدعاء هذه الطريقة عندما يتعطّل الأمر "am instrument" بسبب حدوث خطأ. |
boolean
|
isCancelled()
تعرِض هذه السمة القيمة "صحيح" إذا تم إلغاء تشغيل الاختبار. |
void
|
processNewLines(String[] lines)
تعالج هذه السمة نتائج اختبار لقياس حالة التطبيق من shell. |
طُرق وضع التصميم العامة
InstrumentationResultParser
public InstrumentationResultParser (String runName,
ITestRunListener listener)تنشئ هذه السمة InstrumentationResultParser لمستمع واحد.
| المعلَمات | |
|---|---|
runName |
String: اسم التشغيل التجريبي الذي سيتم تقديمه إلى ITestRunListener.testRunStarted(String,int) |
listener |
ITestRunListener: إعلامك بنتائج الاختبارات أثناء تنفيذها |
InstrumentationResultParser
public InstrumentationResultParser (String runName,
Collection<ITestRunListener> listeners)تُنشئ هذه الدالة الفئة InstrumentationResultParser.
| المعلَمات | |
|---|---|
runName |
String: اسم التشغيل التجريبي الذي سيتم تقديمه إلى ITestRunListener.testRunStarted(String,int) |
listeners |
Collection: إعلامك بنتائج الاختبارات أثناء تنفيذها |
الإجراءات العامة
إلغاء
public void cancel ()
يطلب إلغاء التشغيل التجريبي.
تم
public void done ()
يتم استدعاؤها من قِبل الأصل عند اكتمال جلسة adb.
handleTestRunFailed
public void handleTestRunFailed (String errorMsg)
يتم استدعاء هذه الطريقة عندما يتعطّل الأمر "am instrument" بسبب حدوث خطأ. يجب إرسال إشعار إلى جميع المستمعين المسجّلين ITestRunListener.testRunFailed متبوعًا بـ ITestRunListener.testRunEnded في حال حدوث عطل أثناء تنفيذ الاختبار.
| المعلَمات | |
|---|---|
errorMsg |
String |
isCancelled
public boolean isCancelled ()
تعرِض هذه السمة القيمة "صحيح" إذا تم إلغاء تشغيل الاختبار.
| المرتجعات | |
|---|---|
boolean |
يجب ضبط القيمة على "صحيح" لإلغاء تنفيذ الأمر. |
يُرجى الاطّلاع أيضًا على:
processNewLines
public void processNewLines (String[] lines)
تعالج هذه السمة نتائج اختبار لقياس حالة التطبيق من shell.
| المعلَمات | |
|---|---|
lines |
String: المصفوفة التي تحتوي على الأسطر الجديدة. |
يُرجى الاطّلاع أيضًا على: