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()
הפונקציה מחזירה את |
String
|
getModuleName()
|
final
|
getRealDevices()
הפונקציה מחזירה את כל המכשירים שאינם מכשירי הדמיה מתוך הרשימה |
String
|
getRunName()
הפונקציה מחזירה את השם של הרצת הבדיקה |
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()
האם |
final
void
|
logAssociation(String dataName, LogFile logFile)
אין להשתמש בהטמעה של אוסף מדדים. |
void
|
onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)
קריאה חוזרת (callback) כשמקרה בדיקה נכשל בגלל כשל בהנחה. |
void
|
onTestEnd(DeviceMetricData testData,
התקשרות חזרה בסיום בקשת בדיקה. |
void
|
onTestEnd(DeviceMetricData testData,
התקשרות חזרה בסיום בקשת בדיקה. |
void
|
onTestFail(DeviceMetricData testData, TestDescription test)
קריאה חוזרת (callback) כשמקרה בדיקה נכשל. |
void
|
onTestModuleEnded()
מאפשר תיעוד של האירוע שהסתיים במודול. |
void
|
onTestModuleStarted()
מאפשר תיעוד של האירוע שהתחיל במודול. |
void
|
onTestRunEnd(DeviceMetricData runData,
קריאה חוזרת (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)
המדיניות קובעת אם צריך להשבית את |
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,
חלופה ל- |
final
void
|
testEnded(TestDescription test,
מדווח על סיום ההפעלה של מקרה בדיקה ספציפי. |
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,
הדוחות הסתיימו של הרצת הבדיקה. |
final
void
|
testRunFailed(FailureDescription failure)
הרצת בדיקת הדוחות נכשלה בגלל כשל שתואר על ידי |
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)
חלופה ל- |
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 finalgetBuildInfos ()
הפונקציה מחזירה את רשימת פרטי ה-build שזמינים בהפעלה.
החזרות | |
---|---|
|
אחזור מכשירים
public finalgetDevices ()
מחזירה את רשימת המכשירים הזמינים בהפעלה.
החזרות | |
---|---|
|
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 finalgetRealDevices ()
הפונקציה מחזירה את כל המכשירים שאינם מכשירי הדמיה מתוך הרשימה 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 : מזהה את הבדיקה |