BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.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()

הפונקציה מחזירה את כל המכשירים שאינם stubs מהרשימה 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)

קריאה חוזרת (call back) בסיום בדיקת מקרה.

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

קריאה חוזרת (call back) בסיום בדיקת מקרה.

void onTestFail(DeviceMetricData testData, TestDescription test)

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

void onTestModuleEnded()

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

void onTestModuleStarted()

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

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

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

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)

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

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)

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

שדות

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

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

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

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

החזרות

getDevices

public final  getDevices ()

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

החזרות

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

אחזור הקובץ מהארטיפקטים של הבדיקה או מהארטיפקטים של המודול ושמירתו במטמון במפה לשיחות הבאות.

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

החזרות
ITestInvocationListener

getModuleName

public String getModuleName ()

החזרות
String

getRealDevices

public final  getRealDevices ()

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

החזרות

getRunName

public String getRunName ()

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

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

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

פרמטרים
context IInvocationContext: ה-IInvocationContext להפעלה מתבצעת.
listener ITestInvocationListener: ה-ITestInvocationListener שבו צריך להציב את התוצאות.
החזרות
ITestInvocationListener המאזין החדש עוטף את המאזין המקורי.
זריקות
DeviceNotAvailableException

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

public final void invocationEnded (long elapsedTime)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

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

invocationFailed

public final void invocationFailed (FailureDescription failure)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

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

invocationFailed

public final void invocationFailed (Throwable cause)

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

הקריאה תתבצע באופן אוטומטי על ידי מסגרת TradeFederation.

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

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

public void invocationSkipped (SkipReason reason)

דיווח על קריאה כ'דילוג'

פרמטרים
reason SkipReason

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

public final void invocationStarted (IInvocationContext context)

Listeners להפעלה להעברה

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

מושבתת

public final boolean isDisabled ()

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

החזרות
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)

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

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

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

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

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

קריאה חוזרת (callback) לאירועים מסוג testRunFailed

זריקות
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

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

פרמטרים
runData DeviceMetricData: ה-DeviceMetricData שמכיל את הנתונים של ההרצה.
זריקות
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

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

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

rebootEnded

public void rebootEnded (ITestDevice device)

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

הערה: מומלץ להימנע מהפעלה מחדש של המכשירים במהלך השיחה החוזרת. המערכת תתעלם מכל ניסיון להפעיל מחדש.

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

הופעלה מחדש

public void rebootStarted (ITestDevice device)

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

הערה: מומלץ להימנע מהפעלה מחדש של המכשירים במהלך השיחה החוזרת. המערכת תתעלם מכל ניסיון להפעיל מחדש.

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

testEnded

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 שמתאר את התקלה ואת ההקשר שלה.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

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

פרמטרים
test TestDescription: מזהה את הבדיקה
trace String: דוח קריסות של כשל

testIgnored

public final void testIgnored (TestDescription test)

הקריאה מתבצעת כשבדיקה לא מופעלת, בדרך כלל כי השיטה לבדיקה מסומנת ב-org.junit.Ignore.

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

testLog

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 לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה.
dataType LogDataType: ה-LogDataType של הנתונים
dataStream InputStreamSource: ה-InputStreamSource של הנתונים. מי שמטמיע את הקוד צריך להפעיל את createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהוא סוגר את ה-InputStream שנוצר בסיום. מבצעי הקריאה צריכים לוודא שמקור הנתונים יישאר נוכח ונגיש עד להשלמת השיטה 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 כדי להתחיל לקרוא את הנתונים, ולוודא שה-InputStream שנוצר נסגר בסיום.
logFile LogFile: ה-LogFile שמכיל את המטא-נתונים של הקובץ שנשמר.

testModuleEnded

public final void testModuleEnded ()

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

TestModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

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

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

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 שרצים כמה פעמים. הערך של attemptNumber מתחיל ב-0 וצריך לעלות בכל פעם שמתבצעה הפעלה חדשה. לדוגמה, אם מתבצעות 3 ניסיונות מפורטים של בדיקה, צריכות להיות לה 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה בין 0 ל-3.

בדיקת ההרצה

public final void testRunStarted (String runName, 
                int testCount)

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

פרמטרים
runName String: שם ההרצה לניסיון
testCount int: המספר הכולל של הבדיקות בהרצה לניסיון

בדיקת ההרצה

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

TestRunSStop

public final void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

הבדיקה דילגה

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

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

testStarted

public final void testStarted (TestDescription test)

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

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