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

AtraceRunMetricCollector	يجمع عمليات التتبُّع من جميع أدلة الاختبار ضمن الدليل المحدّد من الجهاز الاختباري، ويسجّل دليل الاختبار، ويعالج ملفات التتبُّع بعد ذلك ضمن دليل الاختبار، ويجمع المقاييس.
BluetoothHciSnoopLogCollector	أداة جمع لتفعيل تسجيل التطفل على واجهة وحدة تحكّم المضيف للبلوتوث على الجهاز قيد الاختبار وجمع السجلّ لكل اختبار
FilePullerLogCollector	مسجّل الملف الذي تم الإبلاغ عنه من جهة الجهاز
PerfettoFilePullerCollector	أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.
PerfettoPullerMetricCollector	تم إيقاف هذا الصف نهائيًا. يُرجى استخدام `PerfettoFilePullerCollector` و`ERROR(/PerfettoTracePostProcessor)` بدلاً منها.
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`