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, testMetrics)

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

abstract void testFailed(TestIdentifier test, String trace)

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

abstract void testIgnored(TestIdentifier test)

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

abstract void testRunEnded(long elapsedTime, 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, 
                 testMetrics)

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

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

פרמטרים
test ‫TestIdentifier: מזהה את הבדיקה
testMetrics ‫: ERROR(/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, 
                 runMetrics)

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

פרמטרים
elapsedTime ‫long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה
runMetrics ‫: ERROR(/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: מזהה את הבדיקה