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

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

IMetricCollector

public interface IMetricCollector
implements ILogSaverListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

תת-כיתות עקיפות ידועות

BaseDeviceMetricCollector, ‏ BugreportzOnFailureCollector, ‏ ClangCodeCoverageCollector, ‏ CountTestCasesCollector, ‏ DebugHostLogOnFailureCollector, ‏ FilePullerDeviceMetricCollector, ‏ FilePullerLogCollector, ‏ GcovCodeCoverageCollector, ‏ JavaCodeCoverageCollector, ‏ LogcatOnFailureCollector, ‏ ScreenshotOnFailureCollector

BaseDeviceMetricCollector	הטמעה בסיסית של `IMetricCollector` שמאפשרת להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` וב-`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BugreportzOnFailureCollector	איסוף דוח bugreportz כשמקרה בדיקה נכשל.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדה אותן כפריטי בדיקה.
CountTestCasesCollector	ספירה של מספר המקרים לבדיקה ודיווח עליו עבור `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	אוסף יומנים בצד המארח ומתעדה אותם כשמתרחשת כשל בתרגיל הבדיקה.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמאזין למפתח מדדים שמגיע מהמכשיר ושולח אותם כקובץ מהמכשיר.
FilePullerLogCollector	יומן של הקובץ שדווח בצד המכשיר.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` שמושך את מדידות הכיסוי של gcov מהמכשיר ומתעדה אותן כפריטי בדיקה.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` שמושך מהמכשיר מדידות של כיסוי Java ומתעדה אותן כפריטי בדיקה.
LogcatOnFailureCollector	אסוף נתונים שיתעדה ויתעד ביומן logcat כאשר מקרה בדיקה נכשל.
ScreenshotOnFailureCollector	אסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשמקרה בדיקה נכשל.

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

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

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

סיכום

שיטות ציבוריות
`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)` קריאה חוזרת (call back) בסיום בדיקת מקרה.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` קריאה חוזרת (call back) בסיום בדיקת מקרה.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` קריאה חוזרת (callback) כשמקרה בדיקה נכשל.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` קריאה חוזרת (call back) בסיום הרצה של בדיקה.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` קריאה חוזרת (callback) כשהרצת הבדיקה מתחילה.
`abstract void`	`onTestStart(DeviceMetricData testData)` קריאה חוזרת (callback) כשמקרה בדיקה מתחיל.

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

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`	המאזין החדש עוטף את המאזין המקורי.

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

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

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

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

פרמטרים
`testData`	`DeviceMetricData`: ה-`DeviceMetricData` שמכיל את הנתונים של תרחיש הבדיקה. יהיה אותו אובייקט כמו במהלך `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: המפה הנוכחית של המדדים שהועברו אל `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

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

פרמטרים
`testData`	`DeviceMetricData`: ה-`DeviceMetricData` שמכיל את הנתונים של תרחיש הבדיקה. יהיה אותו אובייקט כמו במהלך `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: המפה הנוכחית של המדדים שהועברו אל `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.
`test`	`TestDescription`: ה-`TestDescription` של מקרה הבדיקה הפעיל.

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

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

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

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

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

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

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

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