BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

JavaScript.lang.Object
com.android.tradefed.device.metric.BaseDeviceMetricCollector


הטמעת בסיס של IMetricCollector שמאפשרת להתחיל ולהפסיק את האיסוף onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) וגם ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))

סיכום

שדות

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

בנאים ציבוריים

BaseDeviceMetricCollector()

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

void extraInit(IInvocationContext context, ITestInvocationListener listener)
final getBuildInfos()

הפונקציה מחזירה את רשימת פרטי ה-build שזמינים בהפעלה.

final getDevices()

מחזירה את רשימת המכשירים הזמינים בהפעלה.

File getFileFromTestArtifacts(String fileName)

מאחזרים את הקובץ מפריטי המידע שנוצרו בתהליך הפיתוח (Artifact) או מפריטי המודול, ומהמטמון. אותו במפה לשיחות הבאות.

final ITestInvocationListener getInvocationListener()

הפונקציה מחזירה את ITestInvocationListener המקורי שאליו אנחנו מעבירים את התוצאות.

String getModuleName()
final getRealDevices()

הפונקציה מחזירה את כל המכשירים שאינם מכשירי הדמיה מתוך הרשימה getDevices().

String getRunName()

הפונקציה מחזירה את השם של הרצת הבדיקה mRunName שמפעילה את הקולקטור.

final ITestInvocationListener init(IInvocationContext context, ITestInvocationListener listener)

אתחול המלקט עם ההקשר הנוכחי ולאן להעביר את התוצאות.

final void invocationEnded(long elapsedTime)

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

final void invocationFailed(FailureDescription failure)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

final void invocationFailed(Throwable cause)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

void invocationSkipped(SkipReason reason)

דיווח על הפעלה כתוכן שדילגת עליו

final void invocationStarted(IInvocationContext context)

פונקציות מאזיני הפעלה להעברה

final boolean isDisabled()

הפונקציה מחזירה את הערך True אם כל האובייקט מושבת (דילוג על ההגדרה וגם על הפריקה).

boolean isDisabledReceiver()

האם IDeviceActionReceiver מושבת או לא.

final void logAssociation(String dataName, LogFile logFile)

אין להשתמש בהטמעה של אוסף מדדים.

void onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)

קריאה חוזרת (callback) כשמקרה בדיקה נכשל בגלל כשל בהנחה.

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

התקשרות חזרה בסיום בקשת בדיקה.

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

התקשרות חזרה בסיום בקשת בדיקה.

void onTestFail(DeviceMetricData testData, TestDescription test)

קריאה חוזרת (callback) כשמקרה בדיקה נכשל.

void onTestModuleEnded()

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

void onTestModuleStarted()

מאפשר תיעוד של האירוע שהתחיל במודול.

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

קריאה חוזרת (callback) בסיום הרצת בדיקה.

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

קריאה חוזרת (callback) לאירועי testRunנכשל

void onTestRunStart(DeviceMetricData runData)

קריאה חוזרת (callback) כשהתחלת הרצת בדיקה.

void onTestStart(DeviceMetricData testData)

קריאה חוזרת (callback) כשמתחיל תהליך בדיקה.

void rebootEnded(ITestDevice device)

תתקבל התראה כשההפעלה מחדש הסתיימה במכשיר.

void rebootStarted(ITestDevice device)

תתקבל התראה כשמפעילים את המכשיר מחדש.

final void setDisable(boolean isDisabled)

מגדירה אם יש להשבית את האובייקט.

void setDisableReceiver(boolean isDisabled)

המדיניות קובעת אם צריך להשבית את IDeviceActionReceiver.

final void setLogSaver(ILogSaver logSaver)

אין להשתמש בהטמעה של אוסף מדדים.

final void testAssumptionFailure(TestDescription test, String trace)

מופעלת כשבדיקה אטומית מסמנת שהיא מניחה שהתנאי לא נכון

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

מופעלת כשבדיקה אטומית מסמנת שהיא מניחה שהתנאי לא נכון

final void testEnded(TestDescription test, long endTime, testMetrics)

חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) שבה ניתן לציין את שעת הסיום ישירות.

final void testEnded(TestDescription test, testMetrics)

מדווח על סיום ההפעלה של מקרה בדיקה ספציפי.

final void testFailed(TestDescription test, FailureDescription failure)

מדווח על כשל במקרה בדיקה ספציפי.

final void testFailed(TestDescription test, String trace)

מדווח על כשל במקרה בדיקה ספציפי.

final void testIgnored(TestDescription test)

נשלחת קריאה כאשר בדיקה לא תבוצע, בדרך כלל מפני שלשיטת בדיקה יש הערות עם org.junit.ignore.

final void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

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

final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

אין להשתמש בהטמעה של אוסף מדדים.

final void testModuleEnded()

מדווח על סיום הרצת מודול.

final void testModuleStarted(IInvocationContext moduleContext)

מדווח על תחילת המודול שפועל.

final void testRunEnded(long elapsedTime, runMetrics)

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

final void testRunFailed(FailureDescription failure)

הרצת בדיקת הדוחות נכשלה בגלל כשל שתואר על ידי FailureDescription.

final void testRunFailed(String errorMessage)

הפעלת בדיקת הדוחות נכשלה עקב שגיאה חמורה.

final void testRunStarted(String runName, int testCount, int attemptNumber)

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

final void testRunStarted(String runName, int testCount)

הרצה של קריאה חוזרת (callback)

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

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

final void testRunStopped(long elapsedTime)

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

final void testSkipped(TestDescription test, SkipReason reason)

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

final void testStarted(TestDescription test, long startTime)

חלופה ל-testStarted(com.android.tradefed.result.TestDescription) שבה מציינים גם מתי הבדיקה התחיל, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.

final void testStarted(TestDescription test)

קריאות חוזרות (callback) של מקרי בדיקה

שדות

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

בנאים ציבוריים

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

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

אקסטרה-Init

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

הפונקציה מחזירה את רשימת פרטי ה-build שזמינים בהפעלה.

החזרות

אחזור מכשירים

public final  getDevices ()

מחזירה את רשימת המכשירים הזמינים בהפעלה.

החזרות

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

מאחזרים את הקובץ מפריטי המידע שנוצרו בתהליך הפיתוח (Artifact) או מפריטי המודול, ומהמטמון. אותו במפה לשיחות הבאות.

פרמטרים
fileName String: שם הקובץ לחיפוש בפריטי המידע שנוצרו בתהליך הפיתוח (Artifact).

החזרות
File קובץ מפריטי המידע שנוצרו בתהליך הפיתוח (Artifact) או מפריט המידע שנוצר בתהליך הפיתוח (Artifact) של המודול. החזרת ערך null אם הקובץ לא נמצא.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

הפונקציה מחזירה את ITestInvocationListener המקורי שאליו אנחנו מעבירים את התוצאות.

החזרות
ITestInvocationListener

getModuleName

public String getModuleName ()

החזרות
String

getRealמכשירים

public final  getRealDevices ()

הפונקציה מחזירה את כל המכשירים שאינם מכשירי הדמיה מתוך הרשימה getDevices().

החזרות

getRunName

public String getRunName ()

הפונקציה מחזירה את השם של הרצת הבדיקה mRunName שמפעילה את הקולקטור.

החזרות
String mRunName, השם הנוכחי של הרצת הבדיקה.

להתחיל

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

אין לשנות את ההגדרה הזו, אלא אם אתם יודעים מה לעשות.

פרמטרים
context IInvocationContext: ה-IInvocationContext להפעלה מתבצעת.

listener ITestInvocationListener: ITestInvocationListener איפה להציג את התוצאות.

החזרות
ITestInvocationListener את המאזינים החדשים שעוטפים את ההאזנה המקורית.

קליעות
DeviceNotAvailableException

ההפעלה הסתיימה

public final void invocationEnded (long elapsedTime)

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

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
elapsedTime long: זמן ההפעלה שחלף באלפיות השנייה

ההפעלה נכשלה

public final void invocationFailed (FailureDescription failure)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
failure FailureDescription: FailureDescription שמתאר את הסיבה לכשל

ההפעלה נכשלה

public final void invocationFailed (Throwable cause)

מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
cause Throwable: הסיבה Throwable לכשל

המערכת דילגה על ההפעלה

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה כתוכן שדילגת עליו

פרמטרים
reason SkipReason

ההפעלה התחילה

public final void invocationStarted (IInvocationContext context)

פונקציות מאזיני הפעלה להעברה

פרמטרים
context IInvocationContext: מידע על ההפעלה

מושבתת

public final boolean isDisabled ()

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

החזרות
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

האם IDeviceActionReceiver מושבת או לא.

החזרות
boolean הפונקציה מחזירה true אם מושבתת, או false אם לא.

שיוך (logAssociation)

public final void logAssociation (String dataName, 
                LogFile logFile)

אין להשתמש בהטמעה של אוסף מדדים. זו רק העברה.

פרמטרים
dataName String: שם הנתונים

logFile LogFile: ה-LogFile שתועד בעבר וצריך להיות משויך אל מקרה בדיקה.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

קריאה חוזרת (callback) כשמקרה בדיקה נכשל בגלל כשל בהנחה.

פרמטרים
testData DeviceMetricData: הפרמטר DeviceMetricData מכיל את הנתונים של מקרי הבדיקה.

test TestDescription: ה-TestDescription של מקרה הבדיקה שנמצא בטיפול.

קליעות
DeviceNotAvailableException

onTestEnd (סיום הבדיקה)

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

התקשרות חזרה בסיום בקשת בדיקה. זה אמור להיות הזמן לניקוי.

פרמטרים
testData DeviceMetricData: הפרמטר DeviceMetricData מכיל את הנתונים של מקרי הבדיקה. יהיה אותו אובייקט כמו במהלך onTestStart(com.android.tradefed.device.metric.DeviceMetricData).

currentTestCaseMetrics : מפת המדדים הנוכחית שהועברה אל ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)).

test TestDescription: ה-TestDescription של מקרה הבדיקה שנמצא בטיפול.

קליעות
DeviceNotAvailableException

onTestEnd (סיום הבדיקה)

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

התקשרות חזרה בסיום בקשת בדיקה. זה אמור להיות הזמן לניקוי.

פרמטרים
testData DeviceMetricData: הפרמטר DeviceMetricData מכיל את הנתונים של מקרי הבדיקה. יהיה אותו אובייקט כמו במהלך onTestStart(com.android.tradefed.device.metric.DeviceMetricData).

currentTestCaseMetrics : מפת המדדים הנוכחית שהועברה אל ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)).

קליעות
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

קריאה חוזרת (callback) כשמקרה בדיקה נכשל.

פרמטרים
testData DeviceMetricData: הפרמטר DeviceMetricData מכיל את הנתונים של מקרי הבדיקה.

test TestDescription: ה-TestDescription של מקרה הבדיקה שנמצא בטיפול.

קליעות
DeviceNotAvailableException

onTestModuleEnded (סיום הבדיקה)

public void onTestModuleEnded ()

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

קליעות
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

מאפשר תיעוד של האירוע שהתחיל במודול.

קליעות
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

קריאה חוזרת (callback) בסיום הרצת בדיקה. זה אמור להיות הזמן לניקוי.

פרמטרים
runData DeviceMetricData: ה-DeviceMetricData שמאחסן את נתוני הריצה. העדכון יהיה זהה אובייקט כמו במהלך onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData).

currentRunMetrics : מפת המדדים הנוכחית שהועברה אל ERROR(/#testRunEnded(long,Map)).

קליעות
DeviceNotAvailableException

onTestRunError

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

קריאה חוזרת (callback) לאירועי testRunנכשל

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

קריאה חוזרת (callback) כשהתחלת הרצת בדיקה.

פרמטרים
runData DeviceMetricData: ה-DeviceMetricData שמאחסן את נתוני הריצה.

קליעות
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

קריאה חוזרת (callback) כשמתחיל תהליך בדיקה.

פרמטרים
testData DeviceMetricData: הפרמטר DeviceMetricData מכיל את הנתונים של מקרי הבדיקה.

קליעות
DeviceNotAvailableException

ההפעלה מחדש הסתיימה

public void rebootEnded (ITestDevice device)

תתקבל התראה כשההפעלה מחדש הסתיימה במכשיר.

הערה: על המקלטים להימנע מהפעלה מחדש במהלך הקריאה החוזרת (callback). כל ניסיון הפעלה מחדש יהיה המערכת מתעלמת ממנו.

פרמטרים
device ITestDevice: ITestDevice המקום שבו הסתיימה ההפעלה מחדש.

קליעות
DeviceNotAvailableException

הופעלה מחדש

public void rebootStarted (ITestDevice device)

תתקבל התראה כשמפעילים את המכשיר מחדש.

הערה: על המקלטים להימנע מהפעלה מחדש במהלך הקריאה החוזרת (callback). כל ניסיון הפעלה מחדש יהיה המערכת מתעלמת ממנו.

פרמטרים
device ITestDevice: ITestDevice המקום שבו התחילה ההפעלה מחדש.

קליעות
DeviceNotAvailableException

הגדרה השבתה

public final void setDisable (boolean isDisabled)

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

פרמטרים
isDisabled boolean: המצב שצריך להוסיף אליו את האובייקט.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

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

פרמטרים
isDisabled boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

אין להשתמש בהטמעה של אוסף מדדים. זו רק העברה.

פרמטרים
logSaver ILogSaver: ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

מופעלת כשבדיקה אטומית מסמנת שהיא מניחה שהתנאי לא נכון

פרמטרים
test TestDescription: מזהה את הבדיקה

trace String: דוח קריסות של כשל

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

מופעלת כשבדיקה אטומית מסמנת שהיא מניחה שהתנאי לא נכון

פרמטרים
test TestDescription: מזהה את הבדיקה

failure FailureDescription: FailureDescription מתאר את הכשל ואת ההקשר שלו.

הבדיקה הסתיימה

public final 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) מהמדדים שנפלטו

הבדיקה הסתיימה

public final void testEnded (TestDescription test, 
                 testMetrics)

מדווח על סיום ההפעלה של מקרה בדיקה ספציפי.

אם לא הפעלת את testFailed(TestDescription, FailureDescription), הבדיקה הזו עברה. מחזירה גם כל מפתח/ערך מדדים שייתכן שהתקבלו במהלך הביצוע של מקרה הבדיקה.

פרמטרים
test TestDescription: מזהה את הבדיקה

testMetrics : ERROR(/Map) מהמדדים שנפלטו

הבדיקה נכשלה

public final void testFailed (TestDescription test, 
                FailureDescription failure)

מדווח על כשל במקרה בדיקה ספציפי.

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
test TestDescription: מזהה את הבדיקה

failure FailureDescription: FailureDescription מתאר את הכשל ואת ההקשר שלו.

הבדיקה נכשלה

public final void testFailed (TestDescription test, 
                String trace)

מדווח על כשל במקרה בדיקה ספציפי.

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
test TestDescription: מזהה את הבדיקה

trace String: דוח קריסות של כשל

התעלמות מבדיקה

public final void testIgnored (TestDescription test)

נשלחת קריאה כאשר בדיקה לא תבוצע, בדרך כלל מפני שלשיטת בדיקה יש הערות עם org.junit.ignore.

פרמטרים
test TestDescription: מזהה את הבדיקה

יומן בדיקה

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

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

חובה להתקשר לפני ERROR(/ITestInvocationListener#invocationFailed(Throwable)) או ERROR(/ITestInvocationListener#invocationEnded(long))

מערכת TradeFederation תקרא באופן אוטומטי לשיטה הזו, ותספק את יומן המארח ואם רלוונטי, את ה-Logcat של המכשיר.

פרמטרים
dataName String: שם תיאורי של הנתונים String. לדוגמה 'device_logcat'. הערה dataName לא יכול להיות ייחודי בכל הפעלה. כלומר, הטמעות צריכות להיות מסוגלות לטפל כמה קריאות עם אותו dataName

dataType LogDataType: ה-LogDataType של הנתונים

dataStream InputStreamSource: ה-InputStreamSource של הנתונים. מטמיעים צריכים להתקשר CreateInputStream כדי להתחיל לקרוא את הנתונים, ולוודא לסגור את StreamStream לאחר השלמת הפעולה. המתקשרים צריכים לוודא שמקור הנתונים יישאר קיימים ונגישים עד לסיום שיטת testLog.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

אין להשתמש בהטמעה של אוסף מדדים. זו רק העברה.

פרמטרים
dataName String: שם תיאורי של הנתונים String. לדוגמה 'device_logcat'. הערה dataName לא יכול להיות ייחודי בכל הפעלה. כלומר, הטמעות צריכות להיות מסוגלות לטפל כמה קריאות עם אותו dataName

dataType LogDataType: ה-LogDataType של הנתונים

dataStream InputStreamSource: ה-InputStreamSource של הנתונים. מטמיעים צריכים להתקשר CreateInputStream כדי להתחיל לקרוא את הנתונים, ולוודא לסגור את StreamStream לאחר השלמת הפעולה.

logFile LogFile: ה-LogFile שמכיל את המטא-נתונים של הקובץ שנשמר.

testModuleEnded

public final void testModuleEnded ()

מדווח על סיום הרצת מודול.

TestModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

מדווח על תחילת המודול שפועל. הקריאה החוזרת הזו משויכת ל-testModuleEnded() והיא אופציונלית ברצף. נעשה בו שימוש רק במהלך הרצה שנעשה בה שימוש מודולים של הרצה בחבילות.

פרמטרים
moduleContext IInvocationContext: ה-IInvocationContext של המודול.

הבדיקה הסתיימה

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

הדוחות הסתיימו של הרצת הבדיקה. FIXME: אנחנו לא יכולים ליצור שתי מפות<> עם סוגים שונים, כאן צריך להשתמש ב-HashMap.

פרמטרים
elapsedTime long: דיווח על הזמן שחלף במכשיר, באלפיות השנייה

runMetrics : צמדי מפתח/ערך מדווחים בסיום הרצת בדיקה עם Metric.

הבדיקה נכשלה

public final void testRunFailed (FailureDescription failure)

הרצת בדיקת הדוחות נכשלה בגלל כשל שתואר על ידי FailureDescription.

פרמטרים
failure FailureDescription: FailureDescription מתאר את הכשל ואת ההקשר שלו.

הבדיקה נכשלה

public final void testRunFailed (String errorMessage)

הפעלת בדיקת הדוחות נכשלה עקב שגיאה חמורה.

פרמטרים
errorMessage String: String מתארת את הסיבה לכשל בהפעלה.

בדיקת ההרצה

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

פרמטרים
runName String: שם הרצת הבדיקה

testCount int: מספר הבדיקות הכולל בהרצת הבדיקה

attemptNumber int: מספר הזמנה, לזיהוי הניסיונות השונים של אותו runName שפועלים כמה פעמים. ה-TryNumber הוא 0 באינדקס והוא אמור לגדול מדי פעם מתרחשת ריצה חדשה. לדוגמה הבדיקה מתבצעת שוב ושוב 3 פעמים. היא צריכה להיות 4 סה"כ פועל תחת אותו runName ו-TryNumber הוא בין 0 ל-3.

בדיקת ההרצה

public final void testRunStarted (String runName, 
                int testCount)

הרצה של קריאה חוזרת (callback)

פרמטרים
runName String: שם הרצת הבדיקה

testCount int: מספר הבדיקות הכולל בהרצת הבדיקה

בדיקת ההרצה

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

פרמטרים
runName String: שם הרצת הבדיקה

testCount int: מספר הבדיקות הכולל בהרצת הבדיקה

attemptNumber int: מספר הזמנה, לזיהוי הניסיונות השונים של אותו runName שפועלים כמה פעמים. ה-TryNumber הוא 0 באינדקס והוא אמור לגדול בכל פעם מתבצעת הרצה חדשה. לדוגמה בדיקה מפורטת מתבצעת שוב 3 פעמים, והבדיקה צריכה להימשך 4 הפעלות בסך הכל באותו runName ו-TryNumber הוא בין 0 ל-3.

startTime long: משך הזמן שבו התחילה הריצה, שנמדדת באמצעות System.currentTimeMillis()

TestRunSStop

public final void testRunStopped (long elapsedTime)

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

TODO: לא בשימוש כרגע, כדאי להסיר

פרמטרים
elapsedTime long: דיווח על הזמן שחלף במכשיר, באלפיות השנייה

הבדיקה דילגה

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

פרמטרים
test TestDescription: מזהה את הבדיקה

reason SkipReason: SkipReason

הבדיקה התחילה

public final 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()

הבדיקה התחילה

public final void testStarted (TestDescription test)

קריאות חוזרות (callback) של מקרי בדיקה

פרמטרים
test TestDescription: מזהה את הבדיקה