ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
מקבלת התראות על אירועים במהלך הרצת בדיקות של מכשירי מדידה.
מבוסס על org.junit.runner.notification.RunListener
רצף השיחות יהיה:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
סיכום
שיטות ציבוריות | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
הפונקציה נקראת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
הפונקציה נקראת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר |
default
void
|
testEnded(TestDescription test, long endTime,
חלופה ל- |
default
void
|
testEnded(TestDescription test,
דיווח על סיום הביצוע של מקרה בדיקה ספציפי. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
דיווח על כשל של מקרה בדיקה ספציפי. |
default
void
|
testFailed(TestDescription test, String trace)
דיווח על כשל של מקרה בדיקה ספציפי. |
default
void
|
testIgnored(TestDescription test)
הקריאה מתבצעת כשבדיקה לא מופעלת, בדרך כלל כי השיטה לבדיקה מסומנת ב-org.junit.Ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis,
דיווח על סיום הרצת הבדיקה. |
default
void
|
testRunFailed(FailureDescription failure)
הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב- |
default
void
|
testRunFailed(String errorMessage)
הרצת הבדיקה של הדוחות נכשלה בגלל שגיאה קטלנית. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
דיווח על התחלת הרצה של בדיקה. |
default
void
|
testRunStarted(String runName, int testCount)
דיווח על התחלת הרצה של בדיקה. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
דיווח על התחלת הרצה של בדיקה. |
default
void
|
testRunStopped(long elapsedTime)
הרצת הבדיקה של הדוחות הופסקה לפני שהסתיימה עקב בקשה של משתמש. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
הקריאה מתבצעת כשבדיקה מועברת ולא מתבצעת מסיבה שלא צפויה בדרך כלל. |
default
void
|
testStarted(TestDescription test, long startTime)
חלופה ל- |
default
void
|
testStarted(TestDescription test)
דיווח על התחלת מקרה בדיקה ספציפי. |
שיטות ציבוריות
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
הפונקציה נקראת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
trace |
String : סטאק טריי של הכשל |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
הפונקציה נקראת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
failure |
FailureDescription : FailureDescription שמתאר את התקלה ואת ההקשר שלה. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, שבה אפשר לציין את שעת הסיום ישירות. כדי לקבל מדידה מדויקת, אפשר לשלב את הפונקציה עם testStarted(com.android.tradefed.result.TestDescription, long)
.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
endTime |
long : השעה שבה הסתיים הבדיקה, נמדדת באמצעות System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) של המדדים שמונפקים |
testEnded
public void testEnded (TestDescription test,testMetrics)
דיווח על סיום הביצוע של מקרה בדיקה ספציפי.
אם לא הופעל testFailed(TestDescription, FailureDescription)
, הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים מסוג מפתח/ערך שעשויים להופיע במהלך ביצוע מקרה הבדיקה.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
testMetrics |
: ERROR(/Map) של המדדים שמונפקים |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
דיווח על כשל של מקרה בדיקה ספציפי.
הקריאה תתבצע בין testStarted ל-testEnded.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
failure |
FailureDescription : FailureDescription שמתאר את התקלה ואת ההקשר שלה. |
testFailed
public void testFailed (TestDescription test, String trace)
דיווח על כשל של מקרה בדיקה ספציפי.
הקריאה תתבצע בין testStarted ל-testEnded.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
trace |
String : סטאק טריי של הכשל |
testIgnored
public void testIgnored (TestDescription test)
הקריאה מתבצעת כשבדיקה לא מופעלת, בדרך כלל כי השיטה לבדיקה מסומנת ב-org.junit.Ignore.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
דיווח על סיום הרצת הבדיקה.
פרמטרים | |
---|---|
elapsedTimeMillis |
long : הזמן שחלף שדווח על ידי המכשיר, באלפיות שנייה |
runMetrics |
: צמדי מפתח/ערך שמדווחים בסוף הרצה של בדיקה |
testRunFailed
public void testRunFailed (FailureDescription failure)
הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-FailureDescription
.
פרמטרים | |
---|---|
failure |
FailureDescription : FailureDescription שמתאר את התקלה ואת ההקשר שלה. |
testRunFailed
public void testRunFailed (String errorMessage)
הרצת הבדיקה של הדוחות נכשלה בגלל שגיאה קטלנית.
פרמטרים | |
---|---|
errorMessage |
String : String שמתאר את הסיבה לכישלון ההרצה. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
דיווח על התחלת הרצה של בדיקה.
פרמטרים | |
---|---|
runName |
String : שם ההרצה לניסיון |
testCount |
int : המספר הכולל של הבדיקות בהרצה לניסיון |
attemptNumber |
int : מספר הזמנה, שמזהה את הניסיונות השונים של אותו runName שמוצגים כמה פעמים. הערך של attemptNumber מתחיל ב-0 וצריך לעלות בכל פעם שמתבצעה הפעלה חדשה. לדוגמה, אם מתבצעות 3 ניסיונות מפורטים של בדיקה, צריכות להיות לה 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה בין 0 ל-3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
דיווח על התחלת הרצה של בדיקה.
פרמטרים | |
---|---|
runName |
String : שם ההרצה לניסיון |
testCount |
int : המספר הכולל של הבדיקות בהרצה לניסיון |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
דיווח על התחלת הרצה של בדיקה.
פרמטרים | |
---|---|
runName |
String : שם ההרצה לניסיון |
testCount |
int : המספר הכולל של הבדיקות בהרצה לניסיון |
attemptNumber |
int : מספר הזמנה, שמזהה את הניסיונות השונים של אותו runName שמוצגים כמה פעמים. הערך של attemptNumber מתחיל ב-0 וצריך לעלות בכל פעם שמתבצעה הפעלה חדשה. לדוגמה, אם מתבצעות 3 ניסיונות מפורטים של בדיקה, צריכות להיות לה 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה בין 0 ל-3. |
startTime |
long : השעה שבה הרצת הקוד התחילה, שנמדדת באמצעות System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
הרצת הבדיקה של הדוחות הופסקה לפני שהסתיימה עקב בקשה של משתמש.
TODO: currently unused, consider removing
פרמטרים | |
---|---|
elapsedTime |
long : הזמן שחלף שדווח על ידי המכשיר, באלפיות שנייה |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
הקריאה מתבצעת כשבדיקה מועברת ולא מתבצעת מסיבה שלא צפויה בדרך כלל. יתבצעו ניסיונות חוזרים של הבדיקות האלה כדי לנסות לבצע אותן כראוי.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
חלופה ל-testStarted(com.android.tradefed.result.TestDescription)
שבה מציינים גם את מועד תחילת הבדיקה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
למדידה מדויקת.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |
startTime |
long : השעה שבה הבדיקה התחילה, נמדדת באמצעות System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
דיווח על התחלת מקרה בדיקה ספציפי. ממשק ישן יותר, עדיף להשתמש ב-testStarted(com.android.tradefed.result.TestDescription)
כשהדבר אפשרי.
פרמטרים | |
---|---|
test |
TestDescription : מזהה את הבדיקה |