IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

תת-כיתות עקיפות ידועות AtraceCollector,‏ AtraceRunMetricCollector,‏ BaseDeviceMetricCollector,‏ BluetoothConnectionLatencyCollector,‏ BluetoothConnectionStateCollector,‏ BluetoothHciSnoopLogCollector,‏ BugreportzOnFailureCollector,‏ BugreportzOnTestCaseFailureCollector,‏ ClangCodeCoverageCollector,‏ CodeCoverageCollector,‏ CountTestCasesCollector,‏ DebugHostLogOnFailureCollector,‏ DeviceTraceCollector,‏ FilePullerDeviceMetricCollector,‏ FilePullerLogCollector ו-13 אחרים. AtraceCollector IMetricCollector שמפעיל את atrace במהלך בדיקה, אוסף את התוצאה ומעדכן את היומן בקריאה.  AtraceRunMetricCollector האובייקט הזה אוסף את כל הטראסים מתיקיית הבדיקה בתיקייה הנתונה במכשיר הבדיקה, מתעד את תיקיית הבדיקה, מעבד את קובצי הטראס בתיקיית הבדיקה ומאגד את המדדים.  BaseDeviceMetricCollector הטמעה בסיסית של IMetricCollector שמאפשרת להתחיל ולהפסיק את האיסוף ב-onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) וב-ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).  BluetoothConnectionLatencyCollector האוסף ידחוף למכשירים הגדרה מוגדרת מראש של מדד משך זמן ב-statsd, ויאסוף את משך הזמן של חיבור ה-Bluetooth לכל פרופיל.  BluetoothConnectionStateCollector האוסף הזה יאסוף את המדדים של BluetoothConnectionStateChanged ויתעדה את מספר סטטוס החיבור לכל פרופיל.  BluetoothHciSnoopLogCollector כלי איסוף לצורך הפעלת רישום Snoop של Bluetooth HCI ב-DUT ואיסוף היומן לכל בדיקה.  BugreportzOnFailureCollector איסוף דוח bugreportz כשמקרה בדיקה נכשל.  BugreportzOnTestCaseFailureCollector איסוף דוח על באג כשמקרה בדיקה נכשל בהרצה.  ClangCodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדה אותן כפריטי בדיקה.  CodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר מדידות של כיסוי ב-Java ובקוד מקורי, ומתעדה אותן ביומן בתור ארטיפקטים של בדיקה.  CountTestCasesCollector ספירה של מספר תרחישי הבדיקה ודיווח עליהם עבור IRemoteTest נתון.  DebugHostLogOnFailureCollector אוסף את היומנים בצד המארח ומתעדה אותם כשמתרחשת כשל בתרגיל הבדיקה.  DeviceTraceCollector אוסף נתונים שיתחיל מעקב של perfetto כשהרצת הבדיקה תתחיל, וירשום את קובץ המעקב ביומן בסיום.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמאזין למפתח המדדים שמגיע מהמכשיר ושולח אותם כקובץ מהמכשיר.  FilePullerLogCollector יומן של הקובץ שדווח בצד המכשיר.  GcovCodeCoverageCollector BaseDeviceMetricCollector שמושך את מדידות הכיסוי של gcov מהמכשיר ומתעדה אותן כפריטי בדיקה.  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector שמושך מדידות כיסוי של הליבה של gcov מ-debugfs ומהמכשיר, ולאחר מכן מתעד אותן כפריטי מידע שנוצרו במהלך הבדיקה.  HostStatsdMetricCollector IMetricCollector שאוסף מדדי statsd מצד המארח באמצעות פקודות השירות של statsd.  JavaCodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר מדידות של כיסוי Java ומתעדה אותן כפריטי בדיקה.  LogcatOnFailureCollector אוסף שיאגר logcat ויתעדה אותו ביומן כשמקרה בדיקה נכשל.  LogcatTimingMetricCollector אוסף מדדים שאוסף מידע על תזמון (למשל, זמן המעבר של המשתמש) מ-logcat במהלך בדיקה אחת או כמה בדיקות חוזרות, באמצעות דפוסי ביטוי רגולרי נתונים כדי לנתח את אותות ההתחלה והסיום של אירוע משורות logcat.  ModuleLogcatCollector גרסת האוסף של logcat, אבל למודול.  PerfettoPullerMetricCollector הטמעה בסיסית של FilePullerDeviceMetricCollector שמאפשרת למשוך את קובצי perfetto מהמכשיר ולאסוף ממנו את המדדים.  RebootReasonCollector אוסף נתונים של הפעלות מחדש של המכשיר במהלך הרצה של הבדיקה, ומדווח עליהם לפי סיבה ומספר.  RuntimeRestartCollector אגרגטור שאוסף חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.  ScreenshotOnFailureCollector אסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשמקרה בדיקה נכשל.  ShowmapPullerMetricCollector הטמעה בסיסית של FilePullerDeviceMetricCollector שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים.  TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעדה אותם ביומן של ההפעלה.

---

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

אי אפשר להשתמש בממשק הזה בתור , גם אם הוא מאריך את ITestInvocationListener. בדיקת ההגדרות תדחה אותה. צריך להשתמש בו בתור 'metrics_collector'.

לא צפוי ש-Collectors ישמרו מצב פנימי, כי יכול להיות שנעשה בהם שימוש חוזר במספר מקומות. אם באמת צריך להשתמש במצב פנימי, צריך לנקות אותו ב-init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

סיכום

שיטות ציבוריות
default boolean	captureModuleLevel() האם האוסף רלוונטי לתיעוד ברמת המודול ואם צריך להפעיל אותו.
abstract	getBuildInfos() הפונקציה מחזירה את רשימת פרטי ה-build שזמינים בקריאה.
abstract	getDevices() הפונקציה מחזירה את רשימת המכשירים שזמינים בקריאה.
abstract ITestInvocationListener	getInvocationListener() הפונקציה מחזירה את ITestInvocationListener המקורי שאליו אנחנו מעבירים את התוצאות.
abstract ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) אתחול האוסף עם ההקשר הנוכחי ואיפה להעביר את התוצאות.
abstract void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) קריאה חוזרת (callback) כשמקרה בדיקה נכשל בגלל כישלון של הנחת יסוד.
abstract void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) קריאה חוזרת (call back) בסיום בדיקת מקרה.
abstract void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) קריאה חוזרת (call back) בסיום בדיקת מקרה.
abstract void	onTestFail(DeviceMetricData testData, TestDescription test) קריאה חוזרת (callback) כשמקרה בדיקה נכשל.
default void	onTestModuleEnded() מאפשרת לתעד את האירוע 'המודול הסתיים'.
default void	onTestModuleStarted() מאפשרת לתעד את האירוע 'המודול התחיל'.
abstract void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) קריאה חוזרת כשהרצת הבדיקה מסתיימת.
abstract void	onTestRunStart(DeviceMetricData runData) קריאה חוזרת (callback) כשהרצת הבדיקה מתחילה.
default void	onTestRunStart(DeviceMetricData runData, int testCount) קריאה חוזרת (callback) כשהרצת הבדיקה מתחילה.
abstract void	onTestStart(DeviceMetricData testData) קריאה חוזרת (callback) כשמקרה בדיקה מתחיל.

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

captureModuleLevel

public boolean captureModuleLevel ()

האם האוסף רלוונטי לתיעוד ברמת המודול ואם צריך להפעיל אותו.

החזרות
boolean

getBuildInfos

public abstract  getBuildInfos ()

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

החזרות

getDevices

public abstract  getDevices ()

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

החזרות

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

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

החזרות
ITestInvocationListener

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

פרמטרים
context	IInvocationContext: ה-IInvocationContext של הקריאה הנוכחית.
listener	ITestInvocationListener: ה-ITestInvocationListener שבו צריך להציב את התוצאות.

החזרות
ITestInvocationListener	המאזין החדש עוטף את המאזין המקורי.

זריקות
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

זריקות
DeviceNotAvailableException

onTestEnd

public abstract 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 abstract 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 abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

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

זריקות
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

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

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

onTestModuleStarted

public void onTestModuleStarted ()

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

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

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

פרמטרים
runData	DeviceMetricData: ה-DeviceMetricData שמכיל את הנתונים של ההרצה. יהיה זהה לאובייקט onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData).
currentRunMetrics	: המפה הנוכחית של המדדים שהועברו אל ERROR(/#testRunEnded(long,Map)).

זריקות
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

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

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

זריקות
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

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

פרמטרים
runData	DeviceMetricData: ה-DeviceMetricData שמכיל את הנתונים של ההרצה.
testCount	int: מספר תרחישי הבדיקה בריצת הבדיקה הזו.

זריקות
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

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

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

זריקות
DeviceNotAvailableException