اعتبارًا من 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 وFilePullerLogCollector وPerfettoPullerMetricCollector وShowmapPullerMetricCollector

AtraceRunMetricCollector	تجمع هذه الوظيفة عمليات التتبّع من جميع الدليل التجريبي ضمن الدليل المحدّد من الجهاز التجريبي، وتسجّل الدليل التجريبي وتعالج ملفات التتبّع بعد تسجيلها ضمن الدليل التجريبي وتجميع المقاييس.
BluetoothHciSnoopLogCollector	أداة جمع لتسجيل التطفل على واجهة وحدة تحكّم المضيف في بلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار
FilePullerLogCollector	أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بشدّ ملفات perfetto من الجهاز وجمع المقاييس منه
ShowmapPullerMetricCollector	التنفيذ الأساسي `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه

BaseDeviceMetricCollector يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز. يمكن تمديدها لمعالجة إضافية للملف.

ملخّص

الحقول
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

وظائف الإنشاء العامة
`FilePullerDeviceMetricCollector()`

الطرق العامة
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` يتمّ إجراء مكالمة هاتفية عند انتهاء إجراء الاختبار.
`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)` سحب الملف من المسار المحدّد في الجهاز

الحقول

mDirectoryKeys

protected  mDirectoryKeys

mTestCaseMetrics

public  mTestCaseMetrics

وظائف الإنشاء العامة

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

الطرق العامة

onTestEnd

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`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

يتمّ إجراء مكالمة هاتفية عند انتهاء إجراء الاختبار. من المفترض أن يكون هذا هو وقت التنظيف.

المعلمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات التنفيذ سيكون هو الكائن نفسه المستخدَم أثناء `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	‫: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ERROR(/#testRunEnded(long,Map))`

عمليات الرمي
`DeviceNotAvailableException`

processMetricDirectory

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

من المفترض أن يسمح تنفيذ الطريقة بتسجيل الدليل وتحليله للعثور على المقاييس التي يجب وضعها في DeviceMetricData.

المعلمات
`key`	‫`String`: مفتاح الخيار المرتبط بالدليل الذي تم استرجاعه.
`metricDirectory`	`File`: `ERROR(/File)` تم استرجاعه من الجهاز الذي يتطابق مع مفتاح الخيار.
`data`	‫`DeviceMetricData`: `DeviceMetricData` حيث يمكن تخزين المقاييس

processMetricFile

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

من المفترض أن يسمح تنفيذ الطريقة بتسجيل الملف وتحليله للحصول على المقاييس التي سيتم وضعها في DeviceMetricData.

المعلمات
`key`	‫`String`: مفتاح الخيار المرتبط بالملف الذي تم استرجاعه
`metricFile`	`File`: `ERROR(/File)` تم استرجاعه من الجهاز الذي يتطابق مع مفتاح الخيار.
`data`	‫`DeviceMetricData`: `DeviceMetricData` حيث يمكن تخزين المقاييس

الطرق المحمية

addKeys

protected void addKeys (String... keys)

تضيف مفاتيح إضافية للنمط إلى عملية السحب من الجهاز.

المعلمات
`keys`	`String`

retrieveFile

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

سحب الملف من المسار المحدّد في الجهاز

المعلمات
`device`	`ITestDevice`: التي تحتوي على الملف.
`remoteFilePath`	‫`String`: الموقع الجغرافي في الجهاز
`userId`	`int`: رقم تعريف المستخدم المطلوب سحبه

المرتجعات
`File`	تم استرداد الملف من المسار المحدَّد في الجهاز.

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`