IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector


ستتم إضافة هذه الواجهة كمزيّن عند إعداد تقارير نتائج الاختبارات من أجل جمع المقاييس المطابقة.

لا يمكن استخدام هذه الواجهة حتى إذا كانت تمتد إلى ITestInvocationListener. وسيؤدي التحقّق من الإعدادات إلى رفضه. ويجب استخدامه كأحد "مجمع_المقاييس".

لا يُتوقّع أن تحتفظ المجمعات بحالة داخلية لأنّه قد تتم إعادة استخدامها في عدة مواضع. إذا كان يجب استخدام حالة داخلية، يجب تنظيفها في init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

ملخّص

الطرق العامة

default boolean captureModuleLevel()

ما إذا كان أداة جمع البيانات قابلة للتطبيق على الالتقاط على مستوى الوحدة ويجب أن تكون مُنشأة.

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)

يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.

abstract void onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)

يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.

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)

يتمّ إجراء مكالمة هاتفية عند بدء نموذج اختبار.

الطرق العامة

captureModuleLevel

public boolean captureModuleLevel ()

ما إذا كان أداة جمع البيانات قابلة للتطبيق على الالتقاط على مستوى الوحدة أم لا، وما إذا كان يجب بدء تشغيلها

المرتجعات
boolean

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 ()

يسمح بتسجيل حدث انتهاء الوحدة.

عمليات الرمي
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

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

يتمّ إجراء مكالمة هاتفية عند بدء نموذج اختبار.

المعلمات
testData DeviceMetricData: DeviceMetricData الذي يحتفظ بالبيانات لحالة الاختبار

عمليات الرمي
DeviceNotAvailableException