جمع‌کننده IMetric

public interface IMetricCollector
implements IDisableable , ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

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

این رابط را نمی‌توان به عنوان ... استفاده کرد. حتی اگر از ITestInvocationListener ارث‌بری کند. بررسی پیکربندی آن را رد می‌کند. باید به عنوان یک "metrics_collector" استفاده شود.

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

خلاصه

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

default boolean captureModuleLevel ()

اینکه آیا کلکتور برای ضبط در سطح ماژول قابل استفاده است یا خیر و باید init باشد.

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)

فراخوانی مجدد (callback) پس از پایان یک مورد آزمایشی (test case).

abstract void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

فراخوانی مجدد (callback) پس از پایان یک مورد آزمایشی (test case).

abstract void onTestFail ( DeviceMetricData testData, TestDescription test)

فراخوانی مجدد در صورت عدم موفقیت یک مورد آزمایشی.

default void onTestModuleEnded ()

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

default void onTestModuleStarted ()

امکان ثبت رویداد آغاز شده ماژول را فراهم می‌کند.

abstract void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)

فراخوانی مجدد پس از پایان اجرای آزمایشی.

abstract void onTestRunStart ( DeviceMetricData runData)

فراخوانی مجدد هنگام شروع اجرای آزمایشی.

default void onTestRunStart ( DeviceMetricData runData, int testCount)

فراخوانی مجدد هنگام شروع اجرای آزمایشی.

abstract void onTestStart ( DeviceMetricData testData)

فراخوانی مجدد هنگام شروع یک مورد آزمایشی.

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

سطح ماژول را ضبط کنید 

public boolean captureModuleLevel ()

اینکه آیا کلکتور برای ضبط در سطح ماژول قابل استفاده است یا خیر و باید init باشد.

بازگشت‌ها
boolean

اطلاعات ساخت را دریافت کنید 

public abstract  getBuildInfos ()

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

بازگشت‌ها

دریافت دستگاه‌ها 

public abstract  getDevices ()

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

بازگشت‌ها

getInvocationListener 

public abstract ITestInvocationListener getInvocationListener ()

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

بازگشت‌ها
ITestInvocationListener

اولیه 

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

مگر اینکه بدانید چه می‌کنید، آن را لغو نکنید.

پارامترها
context IInvocationContext : IInvocationContext برای فراخوانی که در حال انجام است.

listener ITestInvocationListener : این ITestInvocationListener محل قرار دادن نتایج است.

بازگشت‌ها
ITestInvocationListener شنونده‌ی جدید، شنونده‌ی اصلی را در بر می‌گیرد.

پرتاب‌ها
DeviceNotAvailableException

خطای onTestAssumption 

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد.

test TestDescription : TestDescription موردِ آزمایشیِ در حال انجام.

پرتاب‌ها
DeviceNotAvailableException

پایان آزمون 

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

پایان آزمون 

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

onTestModuleEnd شده 

public void onTestModuleEnded ()

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

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

onTestModuleStarted 

public void onTestModuleStarted ()

امکان ثبت رویداد آغاز شده ماژول را فراهم می‌کند.

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

onTestRunEnd 

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

فراخوانی مجدد پس از پایان اجرای آزمایشی. این زمان باید زمان پاکسازی باشد.

پارامترها
runData DeviceMetricData : DeviceMetricData که داده‌ها را برای اجرا نگه می‌دارد. همان شیء‌ای خواهد بود که در طول onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) وجود داشت.

currentRunMetrics : نقشه فعلی معیارهای ارسال شده به ERROR(/#testRunEnded(long,Map)) .

پرتاب‌ها
DeviceNotAvailableException

onTestRunStart 

public abstract void onTestRunStart (DeviceMetricData runData)

فراخوانی مجدد هنگام شروع اجرای آزمایشی.

پارامترها
runData DeviceMetricData : DeviceMetricData داده‌ها را برای اجرا نگه می‌دارد.

پرتاب‌ها
DeviceNotAvailableException

onTestRunStart 

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

فراخوانی مجدد هنگام شروع اجرای آزمایشی.

پارامترها
runData DeviceMetricData : DeviceMetricData داده‌ها را برای اجرا نگه می‌دارد.

testCount int : تعداد موارد آزمون در این اجرای آزمون.

پرتاب‌ها
DeviceNotAvailableException

شروع آزمون 

public abstract void onTestStart (DeviceMetricData testData)

فراخوانی مجدد هنگام شروع یک مورد آزمایشی.

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد.

پرتاب‌ها
DeviceNotAvailableException