اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 Set<String>`	`mDirectoryKeys`
`public Map<String, String>`	`mTestCaseMetrics`

طُرق وضع التصميم العامة
`FilePullerDeviceMetricCollector()`

الإجراءات العامة
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` دالة ردّ الاتصال عند انتهاء حالة الاختبار.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> 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 Set<String> mDirectoryKeys

mTestCaseMetrics

public Map<String, String> mTestCaseMetrics

طُرق وضع التصميم العامة

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

الإجراءات العامة

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

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

المعلَمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	‫`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testEnded(TestDescription,Map)`

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

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

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

المعلَمات
`runData`	استبدِل `DeviceMetricData` بـ `DeviceMetricData` الذي يحتوي على بيانات عملية التشغيل. سيكون الكائن نفسه كما كان خلال `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	‫`Map`: الخريطة الحالية للمقاييس التي تم تمريرها إلى `testRunEnded(long,Map)`

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

processMetricDirectory

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

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

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

processMetricFile

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

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

المعلَمات
`key`	`String`: مفتاح الخيار المرتبط بالملف الذي تم استرداده.
`metricFile`	`File`: هي `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`