CollectingTestListener
public
class
CollectingTestListener
extends Object
implements
IDisableable,
ILogSaverListener,
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.CollectingTestListener |
ITestInvocationListener שיאסוף את כל תוצאות הבדיקה.
מבני הנתונים שמשמשים באובייקט הזה הם thread-safe, אבל צריך להפעיל את ITestInvocationListener פונקציות ה-callback בסדר הנכון.
סיכום
constructors ציבוריים | |
|---|---|
CollectingTestListener()
|
|
methods ציבוריים | |
|---|---|
IBuildInfo
|
getBuildInfo()
השיטה הזו הוצאה משימוש.
להסתמך על |
TestRunResult
|
getCurrentRunResults()
מקבל את התוצאות של הרצת הבדיקה הנוכחית. |
int
|
getExpectedTests()
הפונקציה מחזירה את מספר הבדיקות הצפוי. |
IInvocationContext
|
getInvocationContext()
החזרת הקשר של הקריאה לפונקציה שדווחה באמצעות |
|
getMergedTestRunResults()
החזרת אוסף התוצאות הממוזג של כל ההרצות בניסיונות שונים. |
IInvocationContext
|
getModuleContextForRunResult(String testRunName)
מחזירה את |
MultiMap<String, LogFile>
|
getModuleLogFiles()
מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ביומן שמשויך למודול |
MultiMap<String, LogFile>
|
getNonAssociatedLogFiles()
הפונקציה מחזירה עותק של המפה שמכילה את כל הקבצים שנרשמו ולא משויכים להרצת בדיקה או למודול. |
int
|
getNumAllFailedTestRuns()
הפונקציה מחזירה את המספר הכולל של הרצות בדיקה במצב כשל. |
int
|
getNumAllFailedTests()
הפונקציה מחזירה את המספר הכולל של הבדיקות במצב של כשל (רק כשלים, כשלים בהנחות לא נספרים). |
int
|
getNumTestsInState(TestStatus status)
הפונקציה מחזירה את מספר הבדיקות במצב נתון בהרצה הזו. |
int
|
getNumTestsInState(TestResult.TestStatus ddmlibStatus)
כדי לשמור על תאימות לסוג סטטוס ישן יותר |
int
|
getNumTotalTests()
הפונקציה מחזירה את המספר הכולל של בדיקות שהושלמו בכל ההרצות. |
IBuildInfo
|
getPrimaryBuildInfo()
מחזירה את פרטי הגרסה הראשוניים שדווחו באמצעות |
|
getRunResults()
השיטה הזו הוצאה משימוש.
שימוש ב- |
TestRunResult
|
getTestRunAtAttempt(String testRunName, int attempt)
מחזירים את |
int
|
getTestRunAttemptCount(String testRunName)
הפונקציה מחזירה את מספר הניסיונות של הרצת בדיקה עם שם נתון. |
|
getTestRunAttempts(String testRunName)
מקבל את כל הניסיונות של |
|
getTestRunForAttempts(int attempt)
מקבל את כל התוצאות של ניסיון נתון. |
|
getTestRunNames()
מחזירה את כל השמות של כל הרצות הבדיקה. |
boolean
|
hasFailedTests()
הפונקציה מחזירה אם היו הפעלות של בדיקות שנכשלו או הנחות שנכשלו. |
boolean
|
hasTestRunResultsForName(String testRunName)
הפונקציה מחזירה תשובה אם יש תוצאות לשם של ריצת בדיקה נתונה. |
void
|
invocationEnded(long elapsedTime)
דיווח על סיום ההפעלה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי. |
void
|
invocationFailed(Throwable cause)
הפונקציה מחזירה דיווח על הפעלה לא מלאה בגלל תנאי שגיאה כלשהו. |
void
|
invocationSkipped(SkipReason reason)
דיווח על הפעלה שנדלגה |
void
|
invocationStarted(IInvocationContext context)
הפונקציה מחזירה את תחילת ההפעלה של הבדיקה. |
boolean
|
isDisabled()
הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (דילוג על ההגדרה ועל הניקוי). |
void
|
logAssociation(String dataName, LogFile logFile)
במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה |
void
|
setBuildInfo(IBuildInfo buildInfo)
השיטה הזו הוצאה משימוש. אין יותר צורך בטיוטות כדי לבצע בדיקות. |
void
|
setDisable(boolean isDisabled)
הגדרת האם האובייקט צריך להיות מושבת. |
void
|
setMergeStrategy(MergeStrategy strategy)
הגדרת |
void
|
testAssumptionFailure(TestDescription test, String trace)
הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקרי |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקרי |
void
|
testEnded(TestDescription test, long endTime,
חלופה ל- |
void
|
testEnded(TestDescription test,
הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי. |
void
|
testFailed(TestDescription test, FailureDescription failure)
הודעה על כשל במקרה בדיקה ספציפי. |
void
|
testFailed(TestDescription test, String trace)
הודעה על כשל במקרה בדיקה ספציפי. |
void
|
testIgnored(TestDescription test)
הפונקציה נקראת כשהבדיקה לא תופעל, בדרך כלל כי שיטת הבדיקה מסומנת ב-org.junit.Ignore. |
void
|
testModuleEnded()
הפונקציה מדווחת על סיום הרצה של מודול. |
void
|
testModuleStarted(IInvocationContext moduleContext)
הפונקציה מחזירה את תחילת ההרצה של מודול. |
void
|
testRunEnded(long elapsedTime,
דוחות על סיום הרצת הבדיקה. |
void
|
testRunFailed(FailureDescription failure)
הפעלת הבדיקה של הדוחות לא הושלמה בגלל כשל שמתואר ב- |
void
|
testRunFailed(String errorMessage)
הפעלת הבדיקה של הדוחות נכשלה בגלל שגיאה חמורה. |
void
|
testRunStarted(String name, int numTests, int attemptNumber)
הפונקציה מחזירה את תחילת ההרצה של הבדיקה. |
void
|
testRunStarted(String name, int numTests)
הפונקציה מחזירה את תחילת ההרצה של הבדיקה. |
void
|
testRunStarted(String name, int numTests, int attemptNumber, long startTime)
הפונקציה מחזירה את תחילת ההרצה של הבדיקה. |
void
|
testRunStopped(long elapsedTime)
הפעלת הבדיקה של הדוחות הופסקה לפני שהסתיימה בגלל בקשה של משתמש. |
void
|
testSkipped(TestDescription test, SkipReason reason)
הפונקציה מופעלת כשמדלגים על בדיקה והיא לא מבוצעת מסיבה שבדרך כלל לא צפויה. |
void
|
testStarted(TestDescription test, long startTime)
חלופה ל- |
void
|
testStarted(TestDescription test)
האירוע הזה מדווח על תחילת הרצה של תרחיש בדיקה מסוים. |
שיטות מוגנות | |
|---|---|
final
void
|
clearModuleLogFiles()
מאפשרת לנקות את קובץ המודול כדי שלא נצטרך לשמור אותו יותר מדי זמן. |
final
void
|
clearResultsForName(String testRunName)
מאפשר לנקות את התוצאות של הרצה מסוימת. |
final
void
|
clearTestRunResults()
מאפשר לנקות את כל תוצאות הרצת הבדיקה כדי שלא נשמור אותן יותר מדי זמן. |
void
|
setIsAggregrateMetrics(boolean aggregate)
החלפת המצב של האפשרות 'מטריקות מצטברות' |
Constructors ציבוריים
CollectingTestListener
public CollectingTestListener ()
methods ציבוריים
getBuildInfo
public IBuildInfo getBuildInfo ()
השיטה הזו הוצאה משימוש.
אפשר לסמוך על IBuildInfo מ-getInvocationContext().
מחזירה את פרטי ה-build.
| החזרות | |
|---|---|
IBuildInfo |
|
getCurrentRunResults
public TestRunResult getCurrentRunResults ()
מקבל את התוצאות של הרצת הבדיקה הנוכחית.
שימו לב: יכול להיות שהתוצאות לא יהיו מלאות. מומלץ לבדוק את הערך של TestRunResult.isRunComplete() או של (@link TestRunResult#isRunFailure()} בהתאם לצורך
לפני עיבוד התוצאות.
| החזרות | |
|---|---|
TestRunResult |
TestRunResult שמייצג נתונים שנאספו במהלך הרצת הבדיקה האחרונה |
getExpectedTests
public int getExpectedTests ()
הפונקציה מחזירה את מספר הבדיקות הצפוי. יכול להיות שיהיה שונה מ-getNumTotalTests() אם חלק מהבדיקות לא הופעלו.
| החזרות | |
|---|---|
int |
|
getInvocationContext
public IInvocationContext getInvocationContext ()
החזרת הקשר של הקריאה לפונקציה שדווחה באמצעות invocationStarted(com.android.tradefed.invoker.IInvocationContext)
| החזרות | |
|---|---|
IInvocationContext |
|
getMergedTestRunResults
publicgetMergedTestRunResults ()
החזרת אוסף התוצאות הממוזג של כל ההרצות בניסיונות שונים.
אם יש כמה תוצאות, כל הרצת בדיקה תמוזג, ותוצאת הבדיקה האחרונה תחליף את תוצאות הבדיקה של הרצות קודמות. הפעלות של בדיקות מסודרות לפי מספר הניסיון.
המדדים של אותו ניסיון ימוזגו על סמך ההעדפה שהוגדרה על ידי aggregate-metrics. המדדים הסופיים יהיו המדדים של הניסיון האחרון.
| החזרות | |
|---|---|
|
|
getModuleContextForRunResult
public IInvocationContext getModuleContextForRunResult (String testRunName)
מחזירה את IInvocationContext של המודול שמשויך לתוצאות.
| פרמטרים | |
|---|---|
testRunName |
String: השם שניתן על ידי {testRunStarted(String, int). |
| החזרות | |
|---|---|
IInvocationContext |
הערך IInvocationContext של המודול עבור שם מסוים של הרצת בדיקה null
אם אין תוצאות לשם הזה. |
getModuleLogFiles
public MultiMap<String, LogFile> getModuleLogFiles ()
הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ביומן שמשויך למודול
| החזרות | |
|---|---|
MultiMap<String, LogFile> |
|
getNonAssociatedLogFiles
public MultiMap<String, LogFile> getNonAssociatedLogFiles ()
הפונקציה מחזירה עותק של המפה שמכילה את כל הקבצים שנרשמו ולא משויכים להרצת בדיקה או למודול.
| החזרות | |
|---|---|
MultiMap<String, LogFile> |
|
getNumAllFailedTestRuns
public int getNumAllFailedTestRuns ()
הפונקציה מחזירה את המספר הכולל של הרצות בדיקה במצב כשל.
| החזרות | |
|---|---|
int |
|
getNumAllFailedTests
public int getNumAllFailedTests ()
הפונקציה מחזירה את המספר הכולל של הבדיקות במצב של כשל (רק כשלים, כשלים בהנחות לא נספרים).
| החזרות | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestStatus status)
הפונקציה מחזירה את מספר הבדיקות במצב נתון בהרצה הזו.
| פרמטרים | |
|---|---|
status |
TestStatus |
| החזרות | |
|---|---|
int |
|
getNumTestsInState
public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)
כדי לשמור על תאימות לסוג סטטוס ישן יותר
| פרמטרים | |
|---|---|
ddmlibStatus |
TestResult.TestStatus |
| החזרות | |
|---|---|
int |
|
getNumTotalTests
public int getNumTotalTests ()
הפונקציה מחזירה את המספר הכולל של בדיקות שהושלמו בכל ההרצות.
| החזרות | |
|---|---|
int |
|
getPrimaryBuildInfo
public IBuildInfo getPrimaryBuildInfo ()
מחזירה את פרטי הגרסה העיקרית שדווחו באמצעות invocationStarted(com.android.tradefed.invoker.IInvocationContext). ה-build הראשי הוא ה-build שמוחזר על ידי ספק ה-build הראשון של התצורה הפועלת. הפונקציה מחזירה ערך null אם אין הקשר (אין build למקרה הבדיקה).
| החזרות | |
|---|---|
IBuildInfo |
|
getRunResults
publicgetRunResults ()
השיטה הזו הוצאה משימוש.
שימוש ב-getMergedTestRunResults()
הפונקציה מחזירה את התוצאות של כל הרצות של הבדיקה.
| החזרות | |
|---|---|
|
|
getTestRunAtAttempt
public TestRunResult getTestRunAtAttempt (String testRunName, int attempt)
מחזירים את TestRunResult לניסיון יחיד.
| פרמטרים | |
|---|---|
testRunName |
String: השם שניתן על ידי {testRunStarted(String, int). |
attempt |
int: מזהה הניסיון. |
| החזרות | |
|---|---|
TestRunResult |
TestRunResult עבור השם הנתון ומזהה הניסיון או null אם הוא לא קיים. |
getTestRunAttemptCount
public int getTestRunAttemptCount (String testRunName)
הפונקציה מחזירה את מספר הניסיונות של הרצת בדיקה עם שם נתון.
| פרמטרים | |
|---|---|
testRunName |
String: השם שניתן על ידי {testRunStarted(String, int). |
| החזרות | |
|---|---|
int |
|
getTestRunAttempts
publicgetTestRunAttempts (String testRunName)
מקבל את כל הניסיונות של TestRunResult בהרצת בדיקה נתונה.
| פרמטרים | |
|---|---|
testRunName |
String: השם שניתן על ידי {testRunStarted(String, int). |
| החזרות | |
|---|---|
|
כל TestRunResult עבור הרצת בדיקה נתונה, מסודרים לפי ניסיונות. |
getTestRunForAttempts
publicgetTestRunForAttempts (int attempt)
מקבל את כל התוצאות של ניסיון נתון.
| פרמטרים | |
|---|---|
attempt |
int: הניסיון שאנחנו רוצים לקבל לגביו תוצאות. |
| החזרות | |
|---|---|
|
כל TestRunResult בניסיון נתון. |
getTestRunNames
publicgetTestRunNames ()
מחזירה את כל השמות של כל הרצות הבדיקה.
יכול להיות שהרצת הבדיקות האלה בוצעה כמה פעמים עם ניסיונות שונים.
| החזרות | |
|---|---|
|
|
hasFailedTests
public boolean hasFailedTests ()
הפונקציה מחזירה אם היו קריאות שבהן נכשלו בדיקות או הנחות.
| החזרות | |
|---|---|
boolean |
|
hasTestRunResultsForName
public boolean hasTestRunResultsForName (String testRunName)
הפונקציה מחזירה תשובה אם יש תוצאות לשם של ריצת בדיקה נתונה.
| פרמטרים | |
|---|---|
testRunName |
String: השם שניתן על ידי {testRunStarted(String, int). |
| החזרות | |
|---|---|
boolean |
|
invocationEnded
public void invocationEnded (long elapsedTime)
דיווח על סיום ההפעלה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.
הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.
| פרמטרים | |
|---|---|
elapsedTime |
long: הזמן שחלף מאז ההפעלה במילישניות |
invocationFailed
public void invocationFailed (Throwable cause)
הפונקציה מחזירה דיווח על הפעלה לא מלאה בגלל תנאי שגיאה כלשהו.
הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.
| פרמטרים | |
|---|---|
cause |
Throwable: סיבת הכשל של Throwable |
invocationSkipped
public void invocationSkipped (SkipReason reason)
דיווח על הפעלה שנדלגה
| פרמטרים | |
|---|---|
reason |
SkipReason |
invocationStarted
public void invocationStarted (IInvocationContext context)
הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.
הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation. כדי לתמוך בדיווח ממספר מכשירים, צריך לבטל את ברירת המחדל של השיטה הזו.
| פרמטרים | |
|---|---|
context |
IInvocationContext: מידע על הקריאה |
isDisabled
public boolean isDisabled ()
הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (דילוג על ההגדרה ועל הניקוי). אחרת, הפלט הוא False.
| החזרות | |
|---|---|
boolean |
|
logAssociation
public void logAssociation (String dataName,
LogFile logFile)במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). לכן, פונקציית הקריאה החוזרת הזו מאפשרת לספק שיוך חזק באופן מפורש.
| פרמטרים | |
|---|---|
dataName |
String: שם הנתונים |
logFile |
LogFile: LogFile שנרשם קודם וצריך להיות משויך לתרחיש הבדיקה. |
setBuildInfo
public void setBuildInfo (IBuildInfo buildInfo)
השיטה הזו הוצאה משימוש.
כבר לא צריך את זה לבדיקה.
הגדרת פרטי הגרסה. היא מיועדת לבדיקה בלבד.
| פרמטרים | |
|---|---|
buildInfo |
IBuildInfo |
setDisable
public void setDisable (boolean isDisabled)
הגדרת האם האובייקט צריך להיות מושבת. ההגדרה Disabled (מושבת) פירושה שצריך לדלג על שלבי ההגדרה וההסרה. אפשר להשתמש בזה כדי להשבית אובייקט כברירת מחדל בבונה ברירת המחדל.
| פרמטרים | |
|---|---|
isDisabled |
boolean: המצב שאליו צריך להעביר את האובייקט. |
setMergeStrategy
public void setMergeStrategy (MergeStrategy strategy)
הגדרת MergeStrategy לשימוש במיזוג תוצאות.
| פרמטרים | |
|---|---|
strategy |
MergeStrategy |
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: מזהה את הבדיקה |
testModuleEnded
public void testModuleEnded ()
הפונקציה מדווחת על סיום הרצה של מודול.
testModuleStarted
public void testModuleStarted (IInvocationContext moduleContext)
הפונקציה מחזירה את תחילת ההרצה של מודול. הקריאה החוזרת הזו משויכת ל-testModuleEnded() והיא אופציונלית ברצף. הוא נמצא בשימוש רק במהלך הרצה שמשתמשת במודולים: רצים מבוססי-חבילה.
| פרמטרים | |
|---|---|
moduleContext |
IInvocationContext: IInvocationContext של המודול. |
testRunEnded
public void testRunEnded (long elapsedTime,
runMetrics) דוחות על סיום הרצת הבדיקה.
| פרמטרים | |
|---|---|
elapsedTime |
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 name,
int numTests,
int attemptNumber)הפונקציה מחזירה את תחילת ההרצה של הבדיקה.
| פרמטרים | |
|---|---|
name |
String: השם של הרצת הבדיקה |
numTests |
int: המספר הכולל של הבדיקות בהרצת הבדיקה |
attemptNumber |
int: מספר ההזמנה, שמזהה את הניסיונות השונים של אותו runName
שמופעל כמה פעמים. הערך של attemptNumber מתחיל מ-0 וצריך לעלות בכל פעם שמתבצעת הפעלה חדשה. לדוגמה: אם מתבצע ניסיון חוזר של בדיקה 3 פעמים, צריכות להיות 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה מ-0 עד 3. |
testRunStarted
public void testRunStarted (String name,
int numTests)הפונקציה מחזירה את תחילת ההרצה של הבדיקה.
| פרמטרים | |
|---|---|
name |
String: השם של הרצת הבדיקה |
numTests |
int: המספר הכולל של הבדיקות בהרצת הבדיקה |
testRunStarted
public void testRunStarted (String name,
int numTests,
int attemptNumber,
long startTime)הפונקציה מחזירה את תחילת ההרצה של הבדיקה.
| פרמטרים | |
|---|---|
name |
String: השם של הרצת הבדיקה |
numTests |
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: מזהה את הבדיקה |
שיטות מוגנות
clearModuleLogFiles
protected final void clearModuleLogFiles ()
מאפשרת לנקות את קובץ המודול כדי שלא נצטרך לשמור אותו יותר מדי זמן.
clearResultsForName
protected final void clearResultsForName (String testRunName)
מאפשר לנקות את התוצאות של הרצה מסוימת. צריך להשתמש בה רק במקרים מסוימים, כמו במצטבר של התוצאות.
| פרמטרים | |
|---|---|
testRunName |
String |
clearTestRunResults
protected final void clearTestRunResults ()
מאפשר לנקות את כל תוצאות הרצת הבדיקה כדי שלא נשמור אותן יותר מדי זמן.
setIsAggregrateMetrics
protected void setIsAggregrateMetrics (boolean aggregate)
החלפת המצב של האפשרות 'מטריקות מצטברות'
| פרמטרים | |
|---|---|
aggregate |
boolean |