דף זה תורגם על ידי 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 ו-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`