ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener


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

Patterned after org.junit.runner.notification.RunListener

סדר השיחות יהיה:

  • testRunStarted
  • testStarted
  • [testFailed]
  • [testAssumptionFailure]
  • [testIgnored]
  • testEnded
  • ....
  • [testRunFailed]
  • testRunEnded

סיכום

‫methods ציבוריים

abstract void testAssumptionFailure(TestIdentifier test, String trace)

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

abstract void testEnded(TestIdentifier test, Map<String, String> testMetrics)

הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.

abstract void testFailed(TestIdentifier test, String trace)

הודעה על כשל במקרה בדיקה ספציפי.

abstract void testIgnored(TestIdentifier test)

הפונקציה מופעלת כשבדיקה לא תופעל, בדרך כלל כי שיטת בדיקה מסומנת ב-org.junit.Ignore.

abstract void testRunEnded(long elapsedTime, Map<String, String> runMetrics)

דוחות על סיום הרצת הבדיקה.

abstract void testRunFailed(String errorMessage)

הפעלת הבדיקה של הדוחות נכשלה בגלל שגיאה חמורה.

abstract void testRunStarted(String runName, int testCount)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

abstract void testRunStopped(long elapsedTime)

השיטה הזו הוצאה משימוש. הקריאה החוזרת הזו אף פעם לא מופעלת. מיועדת למחיקה.

abstract void testStarted(TestIdentifier test)

הפונקציה מדווחת על תחילת בדיקה של תרחיש בדיקה מסוים.

‫methods ציבוריים

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

פרמטרים
test TestIdentifier: מזהה את הבדיקה

trace String: דוח קריסות של הכשל

testEnded

public abstract void testEnded (TestIdentifier test, 
                Map<String, String> testMetrics)

הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.

אם לא בוצעה קריאה לפונקציה testFailed(TestIdentifier, String), הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים של מפתח/ערך שאולי הופקו במהלך ההפעלה של תרחיש הבדיקה.

פרמטרים
test TestIdentifier: מזהה את הבדיקה

testMetrics Map: Map של המדדים שמופקים במהלך ההרצה של תרחיש הבדיקה על ידי android.app.Instrumentation#sendStatus. סדר ההוספה נשמר, אלא אם משדרים את אותו מפתח כמה פעמים. שימו לב שמפתחות רגילים שהוגדרו ב-IInstrumentationResultParser.StatusKeys מסוננים מהמפה הזו. יכול להיות שספריית Ddmlib תוסיף מדדי בדיקה נוספים שמוגדרים ב-IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

הודעה על כשל במקרה בדיקה ספציפי.

הפונקציה הזו תופעל בין testStarted לבין testEnded.

פרמטרים
test TestIdentifier: מזהה את הבדיקה

trace String: דוח קריסות של הכשל

testIgnored

public abstract void testIgnored (TestIdentifier test)

הפונקציה מופעלת כשבדיקה לא תופעל, בדרך כלל כי שיטת בדיקה מסומנת ב-org.junit.Ignore.

פרמטרים
test TestIdentifier: מזהה את הבדיקה

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

דוחות על סיום הרצת הבדיקה.

פרמטרים
elapsedTime long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה

runMetrics Map: Map של המדדים שמופקים במהלך ההרצה של תרחיש הבדיקה על ידי android.app.Instrumentation#addResults. סדר ההוספה נשמר, אלא אם משדרים את אותו מפתח כמה פעמים. שימו לב שמפתחות רגילים שהוגדרו ב-IInstrumentationResultParser.StatusKeys מסוננים מהמפה הזו. יכול להיות שספריית Ddmlib תוסיף מדדי בדיקה נוספים שמוגדרים ב-IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

הפעלת הבדיקה של הדוחות נכשלה בגלל שגיאה חמורה.

פרמטרים
errorMessage String: String תיאור הסיבה לכישלון ההרצה.

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

פרמטרים
runName String: השם של הרצת הבדיקה

testCount int: המספר הכולל של הבדיקות בהרצת הבדיקה

testRunStopped

public abstract void testRunStopped (long elapsedTime)

השיטה הזו הוצאה משימוש.
הקריאה החוזרת הזו אף פעם לא מופעלת. מיועד למחיקה.

הפעלת הבדיקה של הדוחות הופסקה לפני שהסתיימה בגלל בקשה של משתמש.

פרמטרים
elapsedTime long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה

testStarted

public abstract void testStarted (TestIdentifier test)

הפונקציה מדווחת על תחילת בדיקה של תרחיש בדיקה מסוים.

פרמטרים
test TestIdentifier: מזהה את הבדיקה