CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener

תת-כיתות ישירות ידועות JsonHttpTestResultReporter, ‏ LUCIResultReporter, ‏ MetricsXMLResultReporter, ‏ ModuleListener, ‏ ReportPassedTests, ‏ ResultAggregator, ‏ ShardListener, ‏ SuiteResultReporter, ‏ XmlResultReporter JsonHttpTestResultReporter דיווח על תוצאות שמקודד את תוצאות מדדי הבדיקה ואת הענף, פרטי המכשיר ל-JSON ושולח את ה-POST לנקודת קצה של שירות HTTP.  LUCIResultReporter דיווח על תוצאות ששומר את תוצאות הבדיקה שנדרשות ל-ResultDB ול-LUCI בפורמט JSON‏ (go/result-sink) ומתעדה את מיקום הקובץ במסוף.  MetricsXMLResultReporter MetricsXMLResultReporter כותב מדדי בדיקה ומדדי ריצה לקובץ XML בתיקייה שצוינה על ידי הפרמטר metrics-folder בשלב invocationEnded של הבדיקה.  ModuleListener מאזין שמצורף לכל IRemoteTest של כל מודול כדי לאסוף את רשימת התוצאות.  ReportPassedTests דיווח בקובץ על מסננים אפשריים להחרגת בדיקה שעברה.  ResultAggregator שרת העברה מיוחד שמאגד את התוצאות לפי הצורך, על סמך שיטת הניסיון החוזר שנבחרה.  ShardListener ITestInvocationListener שאוסף תוצאות מחלק של קריאה (קריאה שמפוצלת לצורך הפעלה בכמה משאבים בו-זמנית) ומעביר אותן למאזין אחר.  SuiteResultReporter איסוף תוצאות הבדיקה של הרצת חבילת הבדיקה כולה והצגת התוצאות הסופיות בפלט.  XmlResultReporter הספרייה כותבת את תוצאות JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

תת-כיתות עקיפות ידועות FormattedGeneratorReporter, ‏ XmlFormattedGeneratorReporter FormattedGeneratorReporter כלי דיווח שמאפשר ליצור דוחות בפורמט מסוים.  XmlFormattedGeneratorReporter הטמעה של FormattedGeneratorReporter שמעבירה את תוצאות הבדיקה בפורמט xml.

---

ITestInvocationListener שיאסוף את כל תוצאות הבדיקה.

אמנם מבני הנתונים שבהם נעשה שימוש באובייקט הזה בטוחים לשרשור, אבל צריך להפעיל את הפונקציות החוזרות של ITestInvocationListener בסדר הנכון.

סיכום

קונסטרוקטורים גלויים לכולם
CollectingTestListener()

שיטות ציבוריות
IBuildInfo	getBuildInfo() השיטה הזו הוצאה משימוש. להסתמך על IBuildInfo מ-getInvocationContext().
TestRunResult	getCurrentRunResults() הפונקציה מקבלת את התוצאות של הריצ'ה הנוכחית של הבדיקה.
int	getExpectedTests() הפונקציה מחזירה את מספר הבדיקות הצפויות.
IInvocationContext	getInvocationContext() החזרת הקשר ההפעלה שדווח דרך invocationStarted(com.android.tradefed.invoker.IInvocationContext)
	getMergedTestRunResults() החזרת האוסף הממוזג של התוצאות מכל ההרצות בניסיונות שונים.
IInvocationContext	getModuleContextForRunResult(String testRunName) הפונקציה מחזירה את הערך של IInvocationContext של המודול שמשויך לתוצאות.
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() הפונקציה מחזירה את פרטי ה-build הראשיים שדווחו באמצעות invocationStarted(com.android.tradefed.invoker.IInvocationContext).
	getRunResults() השיטה הזו הוצאה משימוש. שימוש ב-getMergedTestRunResults()
TestRunResult	getTestRunAtAttempt(String testRunName, int attempt) מחזירים את TestRunResult לניסיון יחיד.
int	getTestRunAttemptCount(String testRunName) הפונקציה מחזירה את מספר הניסיונות של הרצה נתונה של בדיקה.
	getTestRunAttempts(String testRunName) הפונקציה מקבלת את כל הניסיונות של TestRunResult של הרצה נתונה של הבדיקה.
	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) במקרים מסוימים, צריך לשייך את היומן באופן חזק למקרה בדיקה, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).
void	setBuildInfo(IBuildInfo buildInfo) השיטה הזו הוצאה משימוש. אין יותר צורך בבדיקה.
void	setDisable(boolean isDisabled) מגדיר אם האובייקט יושבת.
void	setMergeStrategy(MergeStrategy strategy) הגדרת MergeStrategy לשימוש במיזוג התוצאות.
void	testAssumptionFailure(TestDescription test, String trace) הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
void	testAssumptionFailure(TestDescription test, FailureDescription failure) הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
void	testEnded(TestDescription test, long endTime, testMetrics) חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), שבה אפשר לציין את שעת הסיום ישירות.
void	testEnded(TestDescription test, testMetrics) דיווח על סיום הביצוע של מקרה בדיקה ספציפי.
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, runMetrics) דיווח על סיום הרצת הבדיקה.
void	testRunFailed(FailureDescription failure) הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-FailureDescription.
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) חלופה ל-testStarted(com.android.tradefed.result.TestDescription) שבה מציינים גם את מועד ההתחלה של הבדיקה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.
void	testStarted(TestDescription test) דיווח על התחלת מקרה בדיקה ספציפי.

שיטות מוגנות
final void	clearModuleLogFiles() מאפשרת לנקות את קובץ המודול כדי שלא נשא אותם יותר מדי זמן.
final void	clearResultsForName(String testRunName) מאפשרת לנקות את התוצאות של שם הרצה נתון.
void	setIsAggregrateMetrics(boolean aggregate) מפעילים או משביתים את האפשרות 'מדדים מצטברים'.

קונסטרוקטורים גלויים לכולם

CollectingTestListener

public CollectingTestListener ()

שיטות ציבוריות

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

public  getMergedTestRunResults ()

החזרת האוסף הממוזג של התוצאות מכל ההרצות בניסיונות שונים.

אם יש כמה תוצאות, כל הרצות הבדיקה מוזגו, ותוצאת הבדיקה האחרונה מחליפה את תוצאות הבדיקה של ההרצות הקודמות. הרצות הבדיקה ממוינות לפי מספר הניסיון.

המדדים של אותה ניסיון ימוזגו על סמך ההעדפה שהוגדרה ב-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 ()

הפונקציה מחזירה את פרטי ה-build הראשיים שדווחו באמצעות invocationStarted(com.android.tradefed.invoker.IInvocationContext). ה-build הראשי הוא ה-build שמוחזר על ידי ספק ה-build הראשון של התצורה שפועלת. הפונקציה מחזירה ערך null אם אין הקשר (אין build ל-test case).

החזרות
IBuildInfo

getRunResults

public  getRunResults ()

השיטה הזו הוצאה משימוש.
שימוש ב-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

public  getTestRunAttempts (String testRunName)

הפונקציה מקבלת את כל הניסיונות של TestRunResult של הרצה נתונה של הבדיקה.

פרמטרים
testRunName	String: השם שצוין על ידי {testRunStarted(String, int).

החזרות
	כל TestRunResult של הרצה נתונה של הבדיקה, לפי סדר הניסיונות.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

הפונקציה מקבלת את כל התוצאות של ניסיון נתון.

פרמטרים
attempt	int: הניסיון שעבורו רוצים לקבל תוצאות.

החזרות
	כל TestRunResult בניסיון נתון.

getTestRunNames

public  getTestRunNames ()

החזרת כל השמות של כל הרצות הבדיקה.

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

החזרות

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)

במקרים מסוימים, צריך לשייך את היומן באופן חזק למקרה בדיקה, אבל אי אפשר לעשות זאת בקריאה החוזרת (callback) הישירה של testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). כך, קריאה חוזרת (callback) מאפשרת לספק באופן מפורש שיוך חזק.

פרמטרים
dataName	String: השם של הנתונים
logFile	LogFile: ה-LogFile שרשום ביומן קודם וצריך לשייך למקרה הבדיקה.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

השיטה הזו הוצאה משימוש.
כבר לא נחוץ לבדיקה.

הגדרת פרטי ה-build. יש להשתמש בה רק לצורכי בדיקה.

פרמטרים
buildInfo	IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

מגדיר אם האובייקט יושבת. אם האפשרות מושבתת, צריך לדלג על שני השלבים של ההגדרה והפירוק. אפשר להשתמש בה כדי להשבית אובייקט כברירת מחדל ב-constructor של ברירת המחדל.

פרמטרים
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)

האירוע הזה מדווח על תחילת ההרצה של מודול. קריאת החזרה (callback) הזו משויכת ל-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

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

מפעילים או משביתים את האפשרות 'מדדים מצטברים'.

פרמטרים
aggregate	boolean