IMetricCollector
public
interface
IMetricCollector
implements
IDisableable,
ILogSaverListener
| com.android.tradefed.device.metric.IMetricCollector |
ستتم إضافة هذه الواجهة كعنصر تزييني عند إعداد تقارير بنتائج الاختبارات من أجل جمع المقاييس المطابقة.
لا يمكن استخدام هذه الواجهة كـ ITestInvocationListener. سيتم رفضها عند التحقّق من الإعدادات. يجب استخدامه كـ "metrics_collector".
لا يُتوقّع من أدوات التجميع الاحتفاظ بحالة داخلية لأنّه يمكن إعادة استخدامها في عدة مواضع. إذا كان يجب استخدام حالة داخلية، يجب محوها عند init(IInvocationContext,ITestInvocationListener).
ملخّص
الإجراءات العامة | |
|---|---|
default
boolean
|
captureModuleLevel()
تحديد ما إذا كان أداة جمع البيانات قابلة للتطبيق على مستوى الوحدة ويجب تهيئتها |
default
boolean
|
doesModuleContainFailure()
تعرض القيمة "صحيح" إذا كانت الوحدة الحالية تحتوي على أي حالات اختبار أو عمليات اختبار غير ناجحة. |
default
void
|
enableDefaultMetricCollection()
تسمح هذه السمة لجامعي البيانات بتفعيل جمع بيانات المقاييس التلقائي. |
default
IMetricCollector.MetricCollectionLevel
|
getAlwaysOnCollectionLevel()
|
abstract
List<IBuildInfo>
|
getBuildInfos()
تعرض هذه الطريقة قائمة بمعلومات الإصدار المتوفّرة في عملية الاستدعاء. |
abstract
List<ITestDevice>
|
getDevices()
تعرض هذه السمة قائمة بالأجهزة المتاحة في طلب الاستدعاء. |
abstract
ITestInvocationListener
|
getInvocationListener()
تعرض هذه السمة |
default
IMetricCollector.MetricCollectionLevel
|
getOnFailureCollectionLevel()
|
abstract
ITestInvocationListener
|
init(IInvocationContext context, ITestInvocationListener listener)
تهيئة أداة التجميع باستخدام السياق الحالي ومكان إعادة توجيه النتائج |
default
boolean
|
isDefaultMetricCollectionEnabled()
تُستخدَم لتحديد ما إذا كان الجامع يجمع المقاييس كجزء من عملية جمع المقاييس التلقائية. |
abstract
void
|
onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)
يتم تنفيذ هذا الإجراء عند تعذُّر تنفيذ حالة اختبار بسبب تعذُّر استيفاء أحد الافتراضات. |
abstract
void
|
onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)
دالة ردّ الاتصال عند انتهاء حالة الاختبار. |
abstract
void
|
onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)
دالة ردّ الاتصال عند انتهاء حالة الاختبار. |
abstract
void
|
onTestFail(DeviceMetricData testData, TestDescription test)
دالة ردّ الاتصال عند فشل حالة اختبار. |
default
void
|
onTestModuleEnded()
تتيح تسجيل حدث انتهاء الوحدة. |
default
void
|
onTestModuleStarted()
يسمح بتسجيل حدث بدء الوحدة. |
abstract
void
|
onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)
دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار. |
abstract
void
|
onTestRunStart(DeviceMetricData runData)
دالة ردّ الاتصال عند بدء تشغيل تجريبي. |
default
void
|
onTestRunStart(DeviceMetricData runData, int testCount)
دالة ردّ الاتصال عند بدء تشغيل تجريبي. |
default
void
|
onTestRunStartBlocking()
دالة ردّ نداء صريحة لبدء أداة تجميع يدويًا إذا كانت تتيح ذلك. |
abstract
void
|
onTestStart(DeviceMetricData testData)
يتم تنفيذ هذه الدالة عند بدء حالة اختبار. |
default
void
|
setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)
تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات بغض النظر عن حالات الأعطال. |
default
void
|
setModuleContainsFailure()
تضبط هذه السمة ما إذا كانت الوحدة قد واجهت أي أخطاء (حالة الاختبار، التشغيل التجريبي). |
default
void
|
setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)
تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات أثناء حدوث الأعطال. |
الإجراءات العامة
captureModuleLevel
public boolean captureModuleLevel ()
تحديد ما إذا كان أداة جمع البيانات قابلة للتطبيق على مستوى الوحدة ويجب تهيئتها
| المرتجعات | |
|---|---|
boolean |
|
doesModuleContainFailure
public boolean doesModuleContainFailure ()
تعرض القيمة "صحيح" إذا كانت الوحدة الحالية تحتوي على أي حالات اختبار أو عمليات اختبار غير ناجحة.
| المرتجعات | |
|---|---|
boolean |
|
enableDefaultMetricCollection
public void enableDefaultMetricCollection ()
تسمح هذه السمة لجامعي البيانات بتفعيل جمع بيانات المقاييس التلقائي. عند تفعيل جمع بيانات المقاييس التلقائي، يجب أن يجمع برنامج التجميع البيانات على مستوى التجميع المحدّد فقط.
getAlwaysOnCollectionLevel
public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()
| المرتجعات | |
|---|---|
IMetricCollector.MetricCollectionLevel |
|
getBuildInfos
public abstract List<IBuildInfo> getBuildInfos ()
تعرض هذه الطريقة قائمة بمعلومات الإصدار المتوفّرة في عملية الاستدعاء.
| المرتجعات | |
|---|---|
List<IBuildInfo> |
|
getDevices
public abstract List<ITestDevice> getDevices ()
تعرض هذه السمة قائمة بالأجهزة المتاحة في طلب الاستدعاء.
| المرتجعات | |
|---|---|
List<ITestDevice> |
|
getInvocationListener
public abstract ITestInvocationListener getInvocationListener ()
تعرض هذه السمة ITestInvocationListener الأصلية التي نعيد توجيه النتائج إليها.
| المرتجعات | |
|---|---|
ITestInvocationListener |
|
getOnFailureCollectionLevel
public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()
| المرتجعات | |
|---|---|
IMetricCollector.MetricCollectionLevel |
|
init
public abstract ITestInvocationListener init (IInvocationContext context, ITestInvocationListener listener)
تهيئة أداة التجميع باستخدام السياق الحالي ومكان إعادة توجيه النتائج سيتم استدعاء هذه الدالة مرة واحدة فقط لكل مثيل، ومن المتوقّع أن يعدّل جامع البيانات سياقه الداخلي والمستمع. لن يتم استدعاء الدالة Init أثناء تشغيل الاختبار، بل سيتم استدعاؤها دائمًا قبل ذلك.
لا تتجاهل هذه الإعدادات إلا إذا كنت تعرف ما تفعله.
| المعلَمات | |
|---|---|
context |
IInvocationContext: IInvocationContext الخاص بالاستدعاء قيد التنفيذ |
listener |
ITestInvocationListener: ITestInvocationListener حيث يتم عرض النتائج |
| المرتجعات | |
|---|---|
ITestInvocationListener |
المستمع الجديد الذي يغلف المستمع الأصلي |
| عمليات الطرح | |
|---|---|
DeviceNotAvailableException |
|
isDefaultMetricCollectionEnabled
public boolean isDefaultMetricCollectionEnabled ()
تُستخدَم لتحديد ما إذا كان الجامع يجمع المقاييس كجزء من عملية جمع المقاييس التلقائية.
| المرتجعات | |
|---|---|
boolean |
|
onTestAssumptionFailure
public abstract void onTestAssumptionFailure (DeviceMetricData testData, TestDescription test)
يتم تنفيذ هذا الإجراء عند تعذُّر تنفيذ حالة اختبار بسبب تعذُّر استيفاء أحد الافتراضات.
| المعلَمات | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار |
test |
TestDescription: TestDescription لإطار الاختبار قيد التقدّم |
| عمليات الطرح | |
|---|---|
DeviceNotAvailableException |
|
onTestEnd
public abstract void onTestEnd (DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)
دالة ردّ الاتصال عند انتهاء حالة الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.
| المعلَمات | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال onTestStart(DeviceMetricData). |
currentTestCaseMetrics |
Map: الخريطة الحالية للمقاييس التي تم تمريرها إلى testEnded(TestDescription,Map) |
test |
TestDescription: TestDescription لإطار الاختبار قيد التقدّم |
| عمليات الطرح | |
|---|---|
DeviceNotAvailableException |
|
onTestEnd
public abstract void onTestEnd (DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)
دالة ردّ الاتصال عند انتهاء حالة الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.
| المعلَمات | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار سيكون الكائن نفسه كما كان خلال onTestStart(DeviceMetricData). |
currentTestCaseMetrics |
Map: الخريطة الحالية للمقاييس التي تم تمريرها إلى testEnded(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, Map<String, MetricMeasurement.Metric> currentRunMetrics)
دالة ردّ الاتصال عند انتهاء عملية تشغيل الاختبار. يجب أن يكون هذا هو الوقت المناسب للتنظيف.
| المعلَمات | |
|---|---|
runData |
استبدِل DeviceMetricData بـ DeviceMetricData الذي يحتوي على بيانات عملية التشغيل. سيكون الكائن نفسه
كما كان خلال onTestRunStart(DeviceMetricData). |
currentRunMetrics |
Map: الخريطة الحالية للمقاييس التي تم تمريرها إلى 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 |
|
onTestRunStartBlocking
public void onTestRunStartBlocking ()
دالة ردّ نداء صريحة لبدء أداة تجميع يدويًا إذا كانت تتيح ذلك. يسمح ذلك بضمان الخروج من بعض مراحل الاختبار غير المتزامنة.
| عمليات الطرح | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
onTestStart
public abstract void onTestStart (DeviceMetricData testData)
يتم تنفيذ هذه الدالة عند بدء حالة اختبار.
| المعلَمات | |
|---|---|
testData |
DeviceMetricData: DeviceMetricData الذي يحتوي على بيانات حالة الاختبار |
| عمليات الطرح | |
|---|---|
DeviceNotAvailableException |
|
setAlwaysOnCollectionLevel
public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)
تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات بغض النظر عن حالات الأعطال.
سيؤدي مستوى NULL إلى عدم جمع البيانات.
| المعلَمات | |
|---|---|
level |
IMetricCollector.MetricCollectionLevel: MetricCollectionLevel الذي سيتم فيه جمع السجلات. |
setModuleContainsFailure
public void setModuleContainsFailure ()
تضبط هذه السمة ما إذا كانت الوحدة قد واجهت أي أخطاء (حالة الاختبار، التشغيل التجريبي).
setOnFailureCollectionLevel
public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)
تضبط هذه السمة المستوى الذي يجب أن تجمع فيه أداة الجمع السجلات أثناء حدوث الأعطال.
سيؤدي مستوى NULL إلى عدم جمع البيانات.
| المعلَمات | |
|---|---|
level |
IMetricCollector.MetricCollectionLevel: MetricCollectionLevel الذي سيتم فيه جمع السجلات. |