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

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

תתי-מחלקות עקיפות ידועות

AtraceCollector	`IMetricCollector` שרץ במירוץ במהלך בדיקה ואוסף את התוצאה ויומן אותם להפעלה.
AtraceRunMetricCollector	אוסף את נתוני המעקב מכל ספריית הבדיקות בספרייה הנתונה ממכשיר הבדיקה, רושמים את ספריית הבדיקה ומתחילים לעבד את קובצי המעקב בספריית הבדיקות וצבירת המדדים.
BaseDeviceMetricCollector	הטמעת בסיס של `IMetricCollector` שמאפשרת להתחיל ולהפסיק את האיסוף `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` וגם `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BluetoothConnectionLatencyCollector	האספן יחסום הגדרה מוגדרת מראש של מדד משך הזמן של הנתונים הסטטיסטיים במכשיר, ויאסוף משך החיבור של Bluetooth לכל פרופיל.
BluetoothConnectionStateCollector	האספן הזה יאסוף מדדי BluetoothConnectionStateChanged ויתעד את מצב החיבור המספר של כל פרופיל.
BluetoothHciSnoopLogCollector	Collector כדי להפעיל רישום snoop של Bluetooth HCI ב-DUT ולאסוף את היומן עבור כל בדיקה.
BugreportzOnFailureCollector	איסוף דוח על באג אם מקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף דוח על באג כשתרחיש בדיקה בהרצה נכשל.
ClangCodeCoverCollector	`BaseDeviceMetricCollector` שימשוך את Clang של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
CountTestCasesCollector	ספירה ודיווח על מספר מקרי הבדיקה של `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	Collector שיאסוף את היומנים בצד המארח וירשום אותם ביומן כאשר מתרחש כשל בתרחיש בדיקה.
DeviceTraceCollector	אוסף שיתחיל לעקוב באופן עצמאי כשהפעלת בדיקה מתחילה וקובץ מעקב ביומן בסוף.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמזהה מפתח מדדים שמגיע מהמכשיר ומושך כקובץ מהמכשיר.
FilePullerLogCollector	יומן הרישום של הקובץ שדווח בצד המכשיר.
GcovCodeCoverCollector	`BaseDeviceMetricCollector` שימשוך gcov של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
GcovKernelCodeCoverCollector	`BaseDeviceMetricCollector` שימשוך ליבה (kernel) של gcov מדידות של הכיסוי מתוך ניפוי באגים ומחוץ למכשיר, ואז הן מתועדות כבדיקה. ארטיפקטים.
HostStatsdMetricCollector	`IMetricCollector` שאוסף מדדים סטטיסטיים מהצד המארח באמצעות נתונים סטטיסטיים פקודות.
JavaCodeCoverCollector	`BaseDeviceMetricCollector` שיאחזר את Java של מדידות הכיסוי מהמכשיר ולרשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
LogcatOnFailureCollector	Collector שיתעד וירשום ביומן Logcat כשמקרה בדיקה נכשל.
LogcatTimingMetricCollector	כלי לאיסוף מדדים שאוסף פרטי תזמון (למשל, זמן המעבר של המשתמש) מ-Logcat במהלך בדיקה חוזרת אחת או יותר על ידי שימוש בתבניות ביטויים רגולריים (regex) כדי לנתח אותות התחלה וסיום של אירוע משורות Logcat.
ModuleLogcatCollector	גרסת אספן Logcat, אבל למודול.
PerfettoPullerMetricCollector	ההטמעה הבסיסית של `FilePullerDeviceMetricCollector` שמאפשרת שולפת את הקבצים הקבועים מהמכשיר ואוספת ממנו את המדדים.
להפעיל מחדש את האסיסטנט	אוסף שאוסף הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהן לפי סיבה וספירה.
RuntimeResumeCollector	אוסף שאוסף חותמות זמן של הפעלות מחדש של סביבת זמן הריצה (קריסות של שרת המערכת) במהלך הבדיקה להפעיל, אם בכלל.
ScreenshotOnFailureCollector	Collector שיצלם ויתעד צילום מסך כשמקרה בדיקה ייכשל.
ShowmapPullerMetricCollector	הטמעת הבסיס של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את מפת התוכנית קבצים מהמכשיר ולאסוף ממנו את המדדים.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות מעקב cmd, ומתועד בהם בהפעלה.

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

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

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

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

takeModuleLevel (הקלטה)

public boolean captureModuleLevel ()

האם הקולקטור רלוונטי לתיעוד ברמת המודול וצריך להתחיל אותו.

החזרות
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

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

החזרות

אחזור מכשירים

public abstract  getDevices ()

מחזירה את רשימת המכשירים הזמינים בהפעלה.

החזרות

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

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

החזרות
`ITestInvocationListener`

להתחיל

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

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

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

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

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

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

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

קליעות
`DeviceNotAvailableException`

onTestModuleEnded (סיום הבדיקה)

public void onTestModuleEnded ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`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)

קריאה חוזרת (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`