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

PerfettoFilePullerCollector

public class PerfettoFilePullerCollector
extends FilePullerDeviceMetricCollector

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

أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.

ملخّص

الإنشاءات العامة
`PerfettoFilePullerCollector()`

الطُرق العامة
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` يجب أن يسمح تنفيذ الطريقة بتسجيل الدليل وتحليله للحصول على مقاييس يتم وضعها في `DeviceMetricData`.
`void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` خذ ملف تتبُّع perfetto الذي تم استخراجه من الجهاز، والذي يمكن أن يكون غير مضغوط أو مضغوطًا، وأضِفه إلى سجلّات الاختبار.

الطُرق المحمية
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` اسحب الملف من المسار المحدّد في الجهاز.

الإنشاءات العامة

PerfettoFilePullerCollector

public PerfettoFilePullerCollector ()

الطُرق العامة

processMetricDirectory

public void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData runData)

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

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

processMetricFile

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

خذ ملف تتبُّع perfetto الذي تم استخراجه من الجهاز، والذي يمكن أن يكون غير مضغوط أو مضغوطًا، وأضِفه إلى سجلّات الاختبار.

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

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

retrieveFile

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

اسحب الملف من المسار المحدّد في الجهاز. استرداد المحتوى المضغوط لملف Perfetto إذا كان خيار ضغط ملف Perfetto مفعّلاً

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

المرتجعات
`File`	نسخة مضغوطة أو غير مضغوطة من ملف Perfetto استنادًا إلى ما إذا تم ضبط الخيار mCompressPerfetto أم لا.

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