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: מזהה את הבדיקה |