IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

الفئات الفرعية غير المباشرة المعروفة AtraceCollector وAtraceRunMetricCollector وBaseDeviceMetricCollector وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothHciSnoopLogCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector وCountTestCasesCollector وDebugHostLogOnFailureCollector وDeviceTraceCollector وFilePullerDeviceMetricCollector وFilePullerLogCollector و13 عملية أخرى AtraceCollector IMetricCollector التي تُجري عملية تتبُّع أثناء الاختبار وتجمع النتيجة وتُسجّلها في الطلب  AtraceRunMetricCollector يتم جمع عمليات التتبّع من جميع الدليل التجريبي ضمن الدليل المحدّد من الجهاز التجريبي، وتسجيل الدليل التجريبي ومعالجة ملفات التتبّع بعد تسجيلها ضمن الدليل التجريبي وتجميع المقاييس.  BaseDeviceMetricCollector التنفيذ الأساسي لـ IMetricCollector الذي يسمح ببدء عملية جمع البيانات وإيقافها في onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) وERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))  BluetoothConnectionLatencyCollector سيُرسِل أداة جمع البيانات إعدادات مقياس مدّة statsd المحدّدة مسبقًا إلى الأجهزة وسيجمع مدّة اتصال البلوتوث لكل ملف شخصي.  BluetoothConnectionStateCollector سيجمع هذا المجمّع مقاييس BluetoothConnectionStateChanged ويُسجّل حالة الاتصال رقمًا لكل ملف شخصي.  BluetoothHciSnoopLogCollector أداة جمع لتسجيل التطفل على واجهة وحدة تحكّم المضيف في بلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار  BugreportzOnFailureCollector جمع تقرير أخطاء عند تعذُّر اختبار حالة  BugreportzOnTestCaseFailureCollector جمع تقرير أخطاء عند تعذُّر تنفيذ حالة اختبار في إحدى عمليات التشغيل  ClangCodeCoverageCollector BaseDeviceMetricCollector الذي سيستخرج قياسات تغطية Clang من الجهاز ويُسجّلها كعناصر اختبار  CodeCoverageCollector BaseDeviceMetricCollector لسحب قياسات التغطية الأصلية من Java و من الجهاز وتسجيلها كعناصر اختبار  CountTestCasesCollector احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ IRemoteTest معيّن  DebugHostLogOnFailureCollector أداة جمع ستجمع السجلات من جهة المضيف وتسجّلها عند حدوث خطأ في نموذج الاختبار.  DeviceTraceCollector أداة جمع البيانات التي ستبدأ عملية تتبُّع perfetto عند بدء عملية تشغيل الاختبار وستسجِّل ملف تتبُّع في النهاية.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.  FilePullerLogCollector أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز  GcovCodeCoverageCollector BaseDeviceMetricCollector الذي سيستخرج قياسات تغطية gcov من الجهاز ويُسجّلها كعناصر اختبار  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector التي ستسحب قياسات تغطية ملف kernel باستخدام gcov من debugfs وخارج الجهاز، ثم تسجّلها أخيرًا كعناصر اختبار  HostStatsdMetricCollector IMetricCollector تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd  JavaCodeCoverageCollector BaseDeviceMetricCollector التي ستسحب قياسات تغطية Java من الجهاز وتُسجّلها كعناصر اختبار  LogcatOnFailureCollector أداة جمع ستسجِّل logcat وتُسجِّله عند تعذُّر اختبار حالة معيّنة.  LogcatTimingMetricCollector أداة جمع مقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدّة اختبارات متكرّرة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والنهاية لحدث من أسطر logcat  ModuleLogcatCollector إصدار أداة جمع سجلّات logcat ولكن للوحدة.  PerfettoPullerMetricCollector التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه  RebootReasonCollector أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار وتُبلغ عنها حسب السبب والعدد.  RuntimeRestartCollector أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء التشغيل (أعطال خادم النظام) أثناء تنفيذ الاختبار ، إن وجدت.  ScreenshotOnFailureCollector أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.  ShowmapPullerMetricCollector التنفيذ الأساسي FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه  TraceCmdCollector IMetricCollector تجمع عمليات التتبّع أثناء الاختبار باستخدام trace-cmd، وتُسجّلها في عملية الاستدعاء.

---

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

لا يمكن استخدام هذه الواجهة حتى إذا كانت تمتد إلى 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