از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار trunk و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، توصیه می‌کنیم android-latest-release به جای aosp-main استفاده کنید. شاخه manifest در android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

شیء جاوا
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector
	↳	com.android.tradefed.device.metric.FilePullerDeviceMetricCollector

زیرکلاس‌های مستقیم شناخته‌شده

AtraceRunMetricCollector ، BluetoothHciSnoopLogCollector ، FilePullerLogCollector ، PerfettoFilePullerCollector ، PerfettoPullerMetricCollector ، ShowmapPullerMetricCollector

AtraceRunMetricCollector	ردیابی‌ها را از تمام دایرکتوری تست تحت دایرکتوری داده شده از دستگاه تست جمع‌آوری می‌کند، دایرکتوری تست را ثبت می‌کند و فایل‌های ردیابی تحت دایرکتوری تست را پس‌پردازش می‌کند و معیارها را تجمیع می‌کند.
جمع‌کننده‌ی گزارش بلوتوث HciSnoop	گردآورنده برای فعال کردن ثبت وقایع Bluetooth HCI snoop روی DUT و جمع‌آوری گزارش برای هر آزمایش.
جمع‌کننده‌ی لاگ فایل‌پِلر	ثبت‌کننده‌ی فایل گزارش‌شده توسط دستگاه.
گردآورنده فایل کامل	یک جمع‌کننده که فایل‌های ردیابی بی‌نقص را از دستگاه می‌گیرد، به صورت اختیاری آنها را فشرده می‌کند و به گزارش‌های آزمایشی اضافه می‌کند.
PerfettoPullerMetricCollector	این کلاس منسوخ شده است. به جای آن از `PerfettoFilePullerCollector` و `ERROR(/PerfettoTracePostProcessor)` استفاده کنید.
نمایش نقشهPullerMetricCollector	پیاده‌سازی پایه `FilePullerDeviceMetricCollector` که امکان دریافت فایل‌های showmap از دستگاه و جمع‌آوری معیارها از آن را فراهم می‌کند.

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

خلاصه

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

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

روش‌های عمومی
`void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` فراخوانی مجدد (callback) پس از پایان یک مورد آزمایشی (test case).
`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)` فایل را از مسیر مشخص شده در دستگاه دریافت کنید.

فیلدها

کلیدهای دایرکتوری m

protected  mDirectoryKeys

معیارهای mTestCase

public  mTestCaseMetrics

سازندگان عمومی

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

روش‌های عمومی

پایان آزمون

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`

دایرکتوری فرآیند

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`

بازیابی فایل

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

فایل را از مسیر مشخص شده در دستگاه دریافت کنید.

پارامترها
`device`	`ITestDevice` : که فایل را دارد.
`remoteFilePath`	`String` : مکان در دستگاه.
`userId`	`int` : شناسه کاربری که قرار است از آن استخراج شود

بازگشت‌ها
`File`	فایل از مسیر داده شده در دستگاه بازیابی شد.

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`