ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
| com.android.tradefed.result.ITestLifeCycleReceiver |
מקבל התראות על אירועים במהלך הפעלות של בדיקות אינסטרומנטציה.
Patterned after org.junit.runner.notification.RunListener
סדר השיחות יהיה:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
סיכום
methods ציבוריים | |
|---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר |
default
void
|
testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי. |
default
void
|
testEnded(TestDescription test, long endTime, Map<String, String> testMetrics)
חלופה ל- |
default
void
|
testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
חלופה ל- |
default
void
|
testEnded(TestDescription test, Map<String, String> testMetrics)
הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי. |
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, HashMap<String, MetricMeasurement.Metric> runMetrics)
דוחות על סיום הרצת הבדיקה. |
default
void
|
testRunEnded(long elapsedTimeMillis, Map<String, String> runMetrics)
דוחות על סיום הרצת הבדיקה. |
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)
הפונקציה מדווחת על תחילת בדיקה של תרחיש בדיקה מסוים. |
methods ציבוריים
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, HashMap<String, MetricMeasurement.Metric> testMetrics)
הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.
אם לא בוצעה קריאה לפונקציה testFailed(TestDescription, FailureDescription), הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים של מפתח/ערך שאולי הופקו במהלך ההפעלה של תרחיש הבדיקה.
| פרמטרים | |
|---|---|
test |
TestDescription: מזהה את הבדיקה |
testMetrics |
HashMap: Map של המדדים שנפלטים |
testEnded
public void testEnded (TestDescription test, long endTime, Map<String, String> testMetrics)
חלופה ל-testEnded(TestDescription,Map) שבה אפשר לציין את שעת הסיום ישירות. אפשר לשלב עם testStarted(TestDescription,long) כדי לקבל מדידה מדויקת.
| פרמטרים | |
|---|---|
test |
TestDescription: מזהה את הבדיקה |
endTime |
long: השעה שבה הבדיקה הסתיימה, נמדדת באמצעות System.currentTimeMillis() |
testMetrics |
Map: Map של המדדים שנפלטים |
testEnded
public void testEnded (TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)
חלופה ל-testEnded(TestDescription,Map) שבה אפשר לציין את שעת הסיום ישירות. אפשר לשלב עם testStarted(TestDescription,long) כדי לקבל מדידה מדויקת.
| פרמטרים | |
|---|---|
test |
TestDescription: מזהה את הבדיקה |
endTime |
long: השעה שבה הבדיקה הסתיימה, נמדדת באמצעות System.currentTimeMillis() |
testMetrics |
HashMap: Map של המדדים שנפלטים |
testEnded
public void testEnded (TestDescription test, Map<String, String> testMetrics)
הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.
אם לא בוצעה קריאה לפונקציה testFailed(TestDescription, FailureDescription), הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים של מפתח/ערך שאולי הופקו במהלך ההפעלה של תרחיש הבדיקה.
| פרמטרים | |
|---|---|
test |
TestDescription: מזהה את הבדיקה |
testMetrics |
Map: 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,
HashMap<String, MetricMeasurement.Metric> runMetrics)דוחות על סיום הרצת הבדיקה. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.
| פרמטרים | |
|---|---|
elapsedTimeMillis |
long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה |
runMetrics |
HashMap: צמדי מפתח/ערך שמדווחים בסוף הרצת בדיקה עם Metric. |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
Map<String, String> runMetrics)דוחות על סיום הרצת הבדיקה.
| פרמטרים | |
|---|---|
elapsedTimeMillis |
long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה |
runMetrics |
Map: צמדי מפתח/ערך שדווחו בסוף הרצת בדיקה |
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(TestDescription) שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם testEnded(TestDescription,long,Map) למדידה מדויקת.
| פרמטרים | |
|---|---|
test |
TestDescription: מזהה את הבדיקה |
startTime |
long: השעה שבה הבדיקה התחילה, נמדדת באמצעות System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
הפונקציה מדווחת על תחילת בדיקה של תרחיש בדיקה מסוים. בממשק הישן, מומלץ להשתמש ב-testStarted(TestDescription) בכל הזדמנות.
| פרמטרים | |
|---|---|
test |
TestDescription: מזהה את הבדיקה |