InstrumentationResultParser

public class InstrumentationResultParser
extends MultiLineReceiver implements IInstrumentationResultParser

java.lang.Object
   ↳ com.android.ddmlib.MultiLineReceiver
     ↳ com.android.tradefed.result.ddmlib.InstrumentationResultParser


מנתח את התוצאות של הרצת בדיקת אינסטרומנטציה ב 'מצב פלט גולמי' ממעטפת הפקודות, ומעדכן את 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
 

הערה: יכול להיות שהחלק 'ערך' בצמד מפתח/ערך יתפרס על פני כמה שורות טקסט

במקומה, צריך להשתמש ב-method‏ InstrumentationProtoResultParser. למנתח מבוסס-פרוטו יש מידע נוסף, כמו הודעת logcat.

סיכום

‫constructors ציבוריים

InstrumentationResultParser(String runName, ITestRunListener listener)

יוצרת את InstrumentationResultParser למאזין יחיד.

InstrumentationResultParser(String runName, Collection<ITestRunListener> listeners)

יוצר את InstrumentationResultParser.

‫methods ציבוריים

void cancel()

בקשות לביטול של הרצת בדיקה.

void done()

הפונקציה נקראת על ידי ההורה כשהסשן של adb מסתיים.

void handleTestRunFailed(String errorMsg)

המערכת קוראת לשיטה הזו כשהפקודה am instrument קורסת עם חריג.

boolean isCancelled()

הפונקציה מחזירה את הערך true אם ביטלתם את הרצת הבדיקה.

void processNewLines(String[] lines)

מעבד את פלט בדיקת האינסטרומנטציה מהמעטפת.

‫constructors ציבוריים

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: מקבלים עדכונים על תוצאות הבדיקות בזמן שהן מתבצעות

‫methods ציבוריים

ביטול

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

הפונקציה מחזירה את הערך true אם ביטלתם את הרצת הבדיקה.

החזרות
boolean ‫true כדי לבטל את ההרצה של הפקודה.

processNewLines

public void processNewLines (String[] lines)

מעבד את פלט בדיקת האינסטרומנטציה מהמעטפת.

פרמטרים
lines String: המערך שמכיל את השורות החדשות.