أدوات جمع المقاييس المستندة إلى المضيف

تعمل أدوات جمع المقاييس المستندة إلى المضيف على المضيف وليس على الجهاز. وتتفاعل مع الجهاز من جانب المضيف لجمع المقاييس التي تستهدفها.

تصميم أداة جمع المقاييس

الصنف الأساسي الذي تستند إليه جميع أدوات الجمع هو BaseDeviceMetricCollector، ما يساعد في توفير الوظائف الأساسية المشترَكة نفسها:

• التصفية
• تعطيل
• الجمع في حالات الاختبار مقابل عمليات التشغيل التجريبية

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

على سبيل المثال، إذا تم تنفيذ أداة الجمع في testEnded، يتم تنفيذ أدوات الجمع قبل أن ينتقل التنفيذ إلى الاختبار التالي باستخدام testStart.

تنفيذ أداة جمع المقاييس المستندة إلى المضيف

عند التنفيذ استنادًا إلى الفئة الأساسية BaseDeviceMetricCollector، يمكنك تحديد وقت جمع مقاييسك خلال دورة الحياة:

• عند بدء تشغيل تجريبي: onTestRunStart
• عند بدء حالة اختبار: onTestStart
• عند انتهاء حالة اختبار: onTestEnd
• عند انتهاء تشغيل تجريبي: onTestRunEnd

تنفيذ عملية جمع غير متزامنة

بالإضافة إلى الطرق المتزامنة، يوفّر إطار عمل الاختبار صنفًا أساسيًا لتنفيذ عملية جمع غير متزامنة دورية، ScheduledDeviceMetricCollector، وهي collect التي توفّر طريقة لتنفيذها بشكلٍ دوري.

يمكن تخصيص الفترة من خلال الخيارات.

إعدادات XML

علامة الكائن هي metrics_collector، على سبيل المثال:

<metrics_collector class="com.android.tradefed.device.metric.AtraceCollector">
    <option name="categories" value="freq"/>
</metrics_collector>

الاقتراحات

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