از 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	ردیابی‌ها را از تمام دایرکتوری آزمایشی زیر فهرست داده‌شده از دستگاه آزمایشی جمع‌آوری می‌کند، فهرست راهنمای آزمایش را ثبت می‌کند و فایل‌های ردیابی را در زیر فهرست راهنمای آزمایش پردازش می‌کند و معیارها را جمع می‌کند.
بلوتوثHciSnoopLogCollector	جمع‌آوری برای فعال کردن بلوتوث HCI Snoop Logging در DUT و جمع‌آوری گزارش برای هر آزمایش.
FilePullerLogCollector	گزارشگر فایل گزارش شده توسط دستگاه سمت.
PerfettoPullerMetricCollector	اجرای پایه `FilePullerDeviceMetricCollector` که اجازه می دهد فایل های perfetto را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید.
ShowmapPullerMetricCollector	پیاده سازی پایه `FilePullerDeviceMetricCollector` که اجازه می دهد فایل های نمایش نقشه را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید.

یک BaseDeviceMetricCollector که به کلیدهای متریک که از دستگاه می آید گوش می دهد و آنها را به عنوان فایل از دستگاه می کشد. برای پردازش اضافی فایل قابل تمدید است.

خلاصه

فیلدها
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

سازندگان عمومی
`FilePullerDeviceMetricCollector ()`

روش های عمومی
`void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` هنگامی که یک مورد آزمایشی به پایان می رسد، تماس بگیرید.
`void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `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`

درTestRunEnd

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` که در آن معیارها می توانند ذخیره شوند.

روش های محافظت شده

افزودن کلیدها

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`