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

סיכום

ערכים קבועים

String TEST_CASE_EXCLUDE_GROUP_OPTION

String TEST_CASE_INCLUDE_GROUP_OPTION

Constructors ציבוריים

BaseDeviceMetricCollector()

‫methods ציבוריים

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

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

final getDevices()

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

File getFileFromTestArtifacts(String fileName)

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

final ITestInvocationListener getInvocationListener()

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

String getModuleName()
final getRealDevices()

הפעולה מחזירה את כל המכשירים שאינם מכשירי stub מהרשימה getDevices().

String getRunName()

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

String getTestName()

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

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)

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

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

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

void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

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

void onTestFail(DeviceMetricData testData, TestDescription test)

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

void onTestModuleEnded()

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

void onTestModuleStarted()

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

void onTestRunEnd(DeviceMetricData runData, currentRunMetrics)

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

void onTestRunFailed(DeviceMetricData testData, FailureDescription failure)

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

void onTestRunStart(DeviceMetricData runData)

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

void onTestStart(DeviceMetricData testData)

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

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)

בדיקת התקשרות חזרה

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)

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

ערכים קבועים

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

ערך קבוע: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

ערך קבוע: "test-case-include-group"

Constructors ציבוריים

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

‫methods ציבוריים

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getBuildInfos

public final  getBuildInfos ()

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

החזרות

getDevices

public final  getDevices ()

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

החזרות

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

החזרות
ITestInvocationListener

getModuleName

public String getModuleName ()

החזרות
String

getRealDevices

public final  getRealDevices ()

הפעולה מחזירה את כל המכשירים שאינם מכשירי stub מהרשימה getDevices().

החזרות

getRunName

public String getRunName ()

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

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

getTestName

public String getTestName ()

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

החזרות
String ‫mTestName, שם הבדיקה הנוכחית.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

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

invocationEnded

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה שנדלגה

פרמטרים
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

‫Invocation Listeners להעברה

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

isDisabled

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)

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

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

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

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

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

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

onTestStart

public void onTestStart (DeviceMetricData testData)

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

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

rebootEnded

public void rebootEnded (ITestDevice device)

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

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

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

rebootStarted

public void rebootStarted (ITestDevice device)

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

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

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

setDisable

public final void setDisable (boolean isDisabled)

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

פרמטרים
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 תיאור הכשל וההקשר שלו.

testEnded

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) של המדדים שמוצגים

testFailed

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 לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו 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)

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

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

testRunEnded

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, תיאור הסיבה לכישלון ההרצה.

testRunStarted

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.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

בדיקת התקשרות חזרה

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

testRunStarted

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

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

testSkipped

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)

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

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