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

IMetric Collector

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

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

AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , HostStatsdMetricCollector , JavaCodeCoverageCollector , and 9 others.

AtraceCollector	یک `IMetricCollector` که atrace را در طول تست اجرا می کند و نتیجه را جمع آوری می کند و آنها را در فراخوانی ثبت می کند.
AtraceRunMetricCollector	ردیابی‌ها را از تمام دایرکتوری آزمایشی زیر فهرست داده‌شده از دستگاه آزمایشی جمع‌آوری می‌کند، فهرست راهنمای آزمایش را ثبت می‌کند و فایل‌های ردیابی را در زیر فهرست راهنمای آزمایش پردازش می‌کند و معیارها را جمع می‌کند.
BaseDeviceMetricCollector	اجرای پایه `IMetricCollector` که امکان شروع و توقف مجموعه را در `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` می دهد.
Bluetooth ConnectionLatency Collector	گردآورنده یک پیکربندی متریک مدت زمان statsd از پیش تعریف شده را به دستگاه ها فشار می دهد و مدت زمان اتصال بلوتوث را برای هر نمایه جمع آوری می کند.
BluetoothConnectionStateCollector	این گردآورنده معیارهای BluetoothConnectionStateChanged را جمع آوری می کند و شماره وضعیت اتصال را برای هر نمایه ثبت می کند.
BugreportzOnFailureCollector	هنگامی که یک مورد آزمایشی با شکست مواجه شد، یک bugreportz جمع آوری کنید.
BugreportzOnTestCaseFailureCollector	هنگامی که یک مورد آزمایشی در یک اجرا با شکست مواجه می شود، یک bugreportz جمع آوری کنید.
ClangCodeCoverageCollector	یک `BaseDeviceMetricCollector` که اندازه گیری های پوشش Clang را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند.
CountTestCasesCollector	تعداد موارد آزمایش را برای یک `IRemoteTest` معین بشمارید و گزارش دهید.
DebugHostLogOnFailureCollector	جمع‌آوری که در صورت بروز خطای مورد آزمایش، گزارش‌های سمت میزبان را جمع‌آوری و ثبت می‌کند.
FilePullerDeviceMetricCollector	یک `BaseDeviceMetricCollector` که به کلیدهای متریک که از دستگاه می آید گوش می دهد و آنها را به عنوان فایل از دستگاه می کشد.
FilePullerLogCollector	گزارشگر فایل گزارش شده توسط دستگاه سمت.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` که اندازه گیری های پوشش gcov را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند.
HostStatsdMetricCollector	یک `IMetricCollector` که معیارهای statsd را از سمت میزبان با استفاده از دستورات ابزار statsd جمع آوری می کند.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` که اندازه گیری های پوشش جاوا را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند.
LogcatOnFailureCollector	مجموعه‌ای که در صورت شکست یک مورد آزمایشی، یک logcat را ضبط و ثبت می‌کند.
LogcatTimingMetricCollector	جمع‌آوری متریک که اطلاعات زمان‌بندی (مثلاً زمان سوئیچ کاربر) را از logcat در طول یک یا چند آزمایش مکرر با استفاده از الگوهای regex داده‌شده برای تجزیه سیگنال‌های شروع و پایان یک رویداد از خطوط logcat جمع‌آوری می‌کند.
ModuleLogcatCollector	نسخه کلکتور logcat اما برای ماژول.
PerfettoPullerMetricCollector	اجرای پایه `FilePullerDeviceMetricCollector` که اجازه می دهد فایل های perfetto را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید.
RebootReasonCollector	مجموعه‌ای که راه‌اندازی مجدد دستگاه را در طول اجرای آزمایشی جمع‌آوری می‌کند و آنها را با دلیل و شمارش گزارش می‌دهد.
RuntimeRestartCollector	جمع‌آوری که در صورت وجود، مُهرهای زمانی راه‌اندازی مجدد زمان اجرا (از کار افتادن سرور سیستم) را در طول اجرای آزمایشی جمع‌آوری می‌کند.
ScreenshotOnFailureCollector	مجموعه‌ای که در صورت شکست یک مورد آزمایشی، اسکرین‌شات می‌گیرد و ثبت می‌کند.
ShowmapPullerMetricCollector	پیاده سازی پایه `FilePullerDeviceMetricCollector` که اجازه می دهد فایل های نمایش نقشه را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید.
TraceCmdCollector	یک `IMetricCollector` که ردیابی ها را در طول آزمایش با استفاده از trace-cmd جمع آوری می کند و آنها را در فراخوان ثبت می کند.

این رابط به عنوان یک تزئین کننده هنگام گزارش نتایج آزمایش ها به منظور جمع آوری معیارهای منطبق اضافه می شود.

این رابط نمی تواند به عنوان یک استفاده شود حتی ITestInvocationListener را گسترش می دهد. بررسی پیکربندی آن را رد می کند. باید به عنوان "مجموعه_متریک" استفاده شود.

انتظار نمی رود که کلکسیونرها وضعیت داخلی خود را حفظ کنند زیرا ممکن است در چندین مکان مجددا استفاده شوند. اگر واقعاً باید از یک حالت داخلی استفاده شود، باید در init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) پاک شود.

خلاصه

روش های عمومی
`abstract`	`getBuildInfos ()` لیستی از اطلاعات ساخت موجود در فراخوان را برمی گرداند.
`abstract`	`getDevices ()` لیست دستگاه های موجود در فراخوان را برمی گرداند.
`abstract ITestInvocationListener`	`getInvocationListener ()` `ITestInvocationListener` اصلی را برمی‌گرداند که در آن نتایج را فوروارد می‌کنیم.
`abstract ITestInvocationListener`	`init ( IInvocationContext context, ITestInvocationListener listener)` راه‌اندازی جمع‌آورنده با شرایط فعلی و مکان ارسال نتایج.
`abstract void`	`onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)` هنگامی که یک مورد آزمایشی با شکست فرضی شکست می خورد.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` هنگامی که یک مورد آزمایشی به پایان می رسد، تماس بگیرید.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` هنگامی که یک مورد آزمایشی به پایان می رسد، تماس بگیرید.
`abstract void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` هنگامی که یک مورد آزمایشی با شکست مواجه می شود.
`default void`	`onTestModuleEnded ()` امکان ثبت رویداد پایان یافته ماژول را فراهم می کند.
`default void`	`onTestModuleStarted ()` به ضبط رویداد شروع شده ماژول اجازه می دهد.
`abstract void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` هنگامی که یک اجرای آزمایشی به پایان می رسد، تماس بگیرید.
`abstract void`	`onTestRunStart ( DeviceMetricData runData)` هنگامی که یک اجرای آزمایشی شروع می شود، تماس بگیرید.
`abstract void`	`onTestStart ( DeviceMetricData testData)` هنگامی که یک مورد آزمایشی شروع می شود، تماس بگیرید.

روش های عمومی

getBuildInfos

public abstract  getBuildInfos ()

لیستی از اطلاعات ساخت موجود در فراخوان را برمی گرداند.

برمی گرداند

getDevices

public abstract  getDevices ()

لیست دستگاه های موجود در فراخوان را برمی گرداند.

برمی گرداند

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

ITestInvocationListener اصلی را برمی‌گرداند که در آن نتایج را فوروارد می‌کنیم.

برمی گرداند
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

راه‌اندازی جمع‌آورنده با شرایط فعلی و مکان ارسال نتایج. در هر نمونه فقط یک بار فراخوانی می شود و انتظار می رود که گردآورنده زمینه و شنونده داخلی خود را به روز کند. Init هرگز در طول اجرای آزمایشی همیشه قبل از آن فراخوانی نمی شود.

نادیده نگیرید مگر اینکه بدانید در حال انجام چه کاری هستید.

مولفه های
`context`	`IInvocationContext` : `IInvocationContext` برای فراخوانی در حال انجام.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` که در آن نتایج را قرار دهید.

برمی گرداند
`ITestInvocationListener`	شنونده جدید شنونده اصلی را می پیچد.

پرتاب می کند
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

هنگامی که یک مورد آزمایشی با شکست فرضی شکست می خورد.

مولفه های
`testData`	`DeviceMetricData` : `DeviceMetricData` که داده‌های مورد آزمایشی را نگه می‌دارد.
`test`	`TestDescription` : `TestDescription` مورد آزمایشی در حال انجام است.

پرتاب می کند
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

هنگامی که یک مورد آزمایشی به پایان می رسد، تماس بگیرید. این باید زمان پاکسازی باشد.

مولفه های
`testData`	`DeviceMetricData` : `DeviceMetricData` که داده‌های مورد آزمایشی را نگه می‌دارد. همان شیء در هنگام `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` خواهد بود.
`currentTestCaseMetrics`	: نقشه فعلی معیارها به `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` منتقل شد.
`test`	`TestDescription` : `TestDescription` مورد آزمایشی در حال انجام است.

پرتاب می کند
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

هنگامی که یک مورد آزمایشی به پایان می رسد، تماس بگیرید. این باید زمان پاکسازی باشد.

مولفه های
`testData`	`DeviceMetricData` : `DeviceMetricData` که داده‌های مورد آزمایشی را نگه می‌دارد. همان شیء در هنگام `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` خواهد بود.
`currentTestCaseMetrics`	: نقشه فعلی معیارها به `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` منتقل شد.

پرتاب می کند
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

هنگامی که یک مورد آزمایشی با شکست مواجه می شود.

مولفه های
`testData`	`DeviceMetricData` : `DeviceMetricData` که داده‌های مورد آزمایشی را نگه می‌دارد.
`test`	`TestDescription` : `TestDescription` مورد آزمایشی در حال انجام است.

پرتاب می کند
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

امکان ثبت رویداد پایان یافته ماژول را فراهم می کند.

پرتاب می کند
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

به ضبط رویداد شروع شده ماژول اجازه می دهد.

پرتاب می کند
`DeviceNotAvailableException`

درTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

هنگامی که یک اجرای آزمایشی به پایان می رسد، تماس بگیرید. این باید زمان پاکسازی باشد.

مولفه های
`runData`	`DeviceMetricData` : `DeviceMetricData` که داده ها را برای اجرا نگه می دارد. همان شیء در هنگام `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` خواهد بود.
`currentRunMetrics`	: نقشه فعلی معیارها به `ERROR(/#testRunEnded(long,Map))` منتقل شد.

پرتاب می کند
`DeviceNotAvailableException`

درTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

هنگامی که یک اجرای آزمایشی شروع می شود، تماس بگیرید.

مولفه های
`runData`	`DeviceMetricData` : `DeviceMetricData` که داده ها را برای اجرا نگه می دارد.

پرتاب می کند
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

هنگامی که یک مورد آزمایشی شروع می شود، تماس بگیرید.

مولفه های
`testData`	`DeviceMetricData` : `DeviceMetricData` که داده‌های مورد آزمایشی را نگه می‌دارد.

پرتاب می کند
`DeviceNotAvailableException`