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

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

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector

תת-כיתות ישירות ידועות

AtraceRunMetricCollector	האובייקט הזה אוסף את כל הטראסים מתיקיית הבדיקה בתיקייה הנתונה במכשיר הבדיקה, מתעד את תיקיית הבדיקה, מעבד את קובצי הטראס בתיקיית הבדיקה ומאגד את המדדים.
BluetoothHciSnoopLogCollector	כלי איסוף לצורך הפעלת רישום Snoop של Bluetooth HCI ב-DUT ואיסוף היומן לכל בדיקה.
FilePullerLogCollector	יומן של הקובץ שדווח בצד המכשיר.
PerfettoPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את קובצי perfetto מהמכשיר ולאסוף ממנו את המדדים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים.

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

סיכום

שדות
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

קונסטרוקטורים גלויים לכולם
`FilePullerDeviceMetricCollector()`

שיטות ציבוריות
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` קריאה חוזרת (call back) בסיום בדיקת מקרה.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` קריאה חוזרת (call back) בסיום הרצה של בדיקה.
`abstract void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` ההטמעה של השיטה אמורה לאפשר לתעד את הספרייה, לנתח אותה ולמצוא מדדים שאפשר להוסיף ל-`DeviceMetricData`.
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` ההטמעה של השיטה אמורה לאפשר לרשום את הקובץ ביומן, לנתח אותו כדי לקבל מדדים ולהוסיף אותם ל-`DeviceMetricData`.

שיטות מוגנות
`void`	`addKeys(String... keys)` הוספת מפתחות תבנית נוספים לגרירה מהמכשיר.
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` מחלצים את הקובץ מהנתיב שצוין במכשיר.

protected  mDirectoryKeys

public  mTestCaseMetrics

public FilePullerDeviceMetricCollector ()

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

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

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

זריקות
`DeviceNotAvailableException`

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

זריקות
`DeviceNotAvailableException`

public abstract void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData data)

ההטמעה של השיטה אמורה לאפשר לתעד את הספרייה, לנתח אותה ולמצוא מדדים שאפשר להוסיף ל-DeviceMetricData.

פרמטרים
`key`	`String`: מפתח האפשרויות שמשויך לספרייה שחולצה.
`metricDirectory`	`File`: ה-`ERROR(/File)` שנשלף מהמכשיר התואם למפתח האפשרות.
`data`	`DeviceMetricData`: ה-`DeviceMetricData` שבו אפשר לאחסן מדדים.

public abstract void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData data)

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

פרמטרים
`key`	`String`: מפתח האפשרות שמשויך לקובץ שחולץ.
`metricFile`	`File`: ה-`ERROR(/File)` שנשלף מהמכשיר התואם למפתח האפשרות.
`data`	`DeviceMetricData`: ה-`DeviceMetricData` שבו אפשר לאחסן מדדים.

protected void addKeys (String... keys)

הוספת מפתחות תבנית נוספים לגרירה מהמכשיר.

פרמטרים
`keys`	`String`

protected File retrieveFile (ITestDevice device, 
                String remoteFilePath, 
                int userId)

מחלצים את הקובץ מהנתיב שצוין במכשיר.

פרמטרים
`device`	`ITestDevice`: שבו נמצא הקובץ.
`remoteFilePath`	`String`: המיקום במכשיר.
`userId`	`int`: מזהה המשתמש שממנו רוצים למשוך את הנתונים

החזרות
`File`	קובץ שאוחזר מהנתיב שצוין במכשיר.

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