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,
تنشئ هذه السمة فئة InstrumentationResultParser. |
|
الطُرق العامة | |
|---|---|
void
|
cancel()
يطلب إلغاء التشغيل التجريبي. |
void
|
done()
يتم استدعاؤها من قِبل الأصل عند اكتمال جلسة adb. |
void
|
handleTestRunFailed(String errorMsg)
يتم استدعاء هذه الطريقة عندما يتعطّل الأمر "am instrument" بسبب حدوث استثناء. |
boolean
|
isCancelled()
تعرِض هذه السمة القيمة "صحيح" إذا تم إلغاء تشغيل الاختبار. |
void
|
processNewLines(String[] lines)
تعالج هذه السمة ناتج اختبار قياس الأداء من shell. |
الإنشاءات العامة
InstrumentationResultParser
public InstrumentationResultParser (String runName,
listeners) تنشئ هذه السمة فئة InstrumentationResultParser.
| المعلمات | |
|---|---|
runName |
استبدِل String باسم التشغيل التجريبي الذي سيتم تقديمه إلى ITestRunListener.testRunStarted(String,
int) |
listeners |
|
الطُرق العامة
إلغاء
public void cancel ()
يطلب إلغاء التشغيل التجريبي.
done
public void done ()
يتم استدعاؤها من قِبل الأصل عند اكتمال جلسة adb.
handleTestRunFailed
public void handleTestRunFailed (String errorMsg)
يتم استدعاء هذه الطريقة عندما يتعطّل الأمر "am instrument" بسبب حدوث استثناء. يجب إرسال إشعار إلى جميع المستمعين المسجّلين ITestRunListener.testRunFailed متبوعًا بـ ITestRunListener.testRunEnded(long, في حال حدوث عطل أثناء تنفيذ الاختبار.
| المعلمات | |
|---|---|
errorMsg |
String |
isCancelled
public boolean isCancelled ()
تعرِض هذه السمة القيمة "صحيح" إذا تم إلغاء تشغيل الاختبار.
| المرتجعات | |
|---|---|
boolean |
يجب ضبط القيمة على "صحيح" لإلغاء تنفيذ الأمر. |
يُرجى الاطّلاع أيضًا على:
processNewLines
public void processNewLines (String[] lines)
تعالج هذه السمة ناتج اختبار قياس الأداء من shell.
| المعلمات | |
|---|---|
lines |
String: المصفوفة التي تحتوي على الأسطر الجديدة. |
يُرجى الاطّلاع أيضًا على: