החל מ-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 עבור HCI של Bluetooth ב-DUT ולאיסוף היומן לכל בדיקה.
FilePullerLogCollector	כלי לרישום ביומן של הקובץ שדווח בצד המכשיר.
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.

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

סיכום

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

Constructors ציבוריים
`FilePullerDeviceMetricCollector()`

‫methods ציבוריים
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` קריאה חוזרת כשמקרה בדיקה מסתיים.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` פונקציית Callback כשמסתיימת הרצת בדיקה.
`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)

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

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

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

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