החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

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 ועוד 14 אחרים.

‫AtraceCollector	‫`IMetricCollector` שמופעל במהלך בדיקה, אוסף את התוצאה ומתעד אותה ביומן של הקריאה.
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 עבור HCI של Bluetooth ב-DUT ולאיסוף היומן לכל בדיקה.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
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, אבל עבור מודול.
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
‫RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RuntimeRestartCollector	כלי לאיסוף נתונים שאוסף חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשהתרחיש לבדיקה ייכשל.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותם ביומן של הקריאה.

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

אי אפשר להשתמש בממשק הזה בתור גם אם הוא מרחיב את ITestInvocationListener. בדיקת ההגדרות תדחה אותו. חובה להשתמש בו כ-metrics_collector.

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

סיכום

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

‫methods ציבוריים

captureModuleLevel

public boolean captureModuleLevel ()

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

החזרות
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

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

החזרות

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)

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

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

זריקות
`DeviceNotAvailableException`

onTestEnd

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

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

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

זריקות
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

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

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

זריקות
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

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

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

זריקות
`DeviceNotAvailableException`