يتم تشغيل أدوات جمع المقاييس المستندة إلى المضيف على المضيف وليس على الجهاز. ويتفاعلون مع الجهاز من جهة المضيف لجمع المقاييس التي يستهدفونها.
تصميم أداة جمع المقاييس
الفئة الأساسية التي تمتد إليها جميع أدوات جمع البيانات هي
BaseDeviceMetricCollector،
التي تساعد في توفير الوظائف الأساسية المشتركة نفسها:
- التصفية
- إيقاف
- جمع بيانات حالات الاختبار في مقابل عمليات الاختبار
تتّبع أدوات الالتقاط نموذج مُسجّل النتائج لأنّها تتم مزامنتها مع تنفيذ الاختبار على المضيف. بعبارة أخرى، إذا كانت الاختبارات مستندة إلى المضيف، يتم تنفيذ أدوات الجمع قبل أن ينتقل الاختبار إلى خطوة التنفيذ التالية.
على سبيل المثال، إذا تم تنفيذ عملية جمع البيانات في testEnded، يتم تنفيذ عمليات جمع البيانات
قبل الانتقال إلى الاختبار التالي باستخدام testStart.
تنفيذ أداة جمع مقاييس مستندة إلى المضيف
عند التنفيذ على أساس الفئة الأساسية BaseDeviceMetricCollector،
يمكنك تحديد وقت جمع المقاييس خلال رحلة المستخدِم:
- عند بدء عملية اختبار:
onTestRunStart - عند بدء نموذج اختبار:
onTestStart - عند انتهاء حالة اختبار:
onTestEnd - عند انتهاء إجراء اختبار:
onTestRunEnd
تنفيذ عملية جمع غير متزامنة
بالإضافة إلى الطرق المتزامنة، يوفّر TF فئة أساسية لتنفيذ
عملية جمع غير متزامنة بشكل دوري،
ScheduledDeviceMetricCollector،
التي تقدّم طريقة collect لتنفيذها بشكل
دوري.
يمكن تخصيص الفترة من خلال الخيارات.
إعدادات XML
علامة الكائن هي metrics_collector، على سبيل المثال:
<metrics_collector class="com.android.tradefed.device.metric.AtraceCollector">
<option name="categories" value="freq"/>
</metrics_collector>
الاقتراحات
اطّلِع على القائمة الحالية للمجمعين للتأكّد من أنّك لا تكرّر العمل. نحاول ضمان أقصى قدر من إمكانية إعادة الاستخدام، لذلك، يسمح تعيين كلّ جامع لنوع واحد من عمليات الجمع بمزيد من المزج ومطابقة المجمعات المختلفة أثناء تنفيذ الاختبار.