جامع متري

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

الفئات الفرعية غير المباشرة المعروفة AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , and 12 others. جامع أتراس IMetricCollector يقوم بتشغيل atrace أثناء الاختبار ويجمع النتيجة ويسجلها في الاستدعاء. جامع AtraceRunMetric يجمع التتبع من كل دليل الاختبار ضمن الدليل المحدد من جهاز الاختبار ، ويسجل دليل الاختبار ويعالج ملفات التتبع تحت دليل الاختبار ويجمع المقاييس. BaseDeviceMetricCollector التنفيذ الأساسي لـ IMetricCollector الذي يسمح ببدء وإيقاف التجميع على onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) و ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) . BluetoothConnectionLatencyCollector سيقوم المُجمع بدفع تكوين قياس المدة statsd المحدد مسبقًا إلى الأجهزة ويجمع مدة اتصال Bluetooth لكل ملف تعريف. BluetoothConnectionStateCollector سيجمع هذا المجمع مقاييس BluetoothConnectionStateChanged ويسجل رقم حالة الاتصال لكل ملف تعريف. جامع BluetoothHciSnoopLogCollector أداة التجميع لتمكين تسجيل التطفل عبر Bluetooth HCI على DUT وتجميع السجل لكل اختبار. جامع BugreportzOnFailure اجمع تقرير الأخطاء عند فشل حالة الاختبار. BugreportzOnTestCaseFailureCollector اجمع تقرير bugreportz عند فشل حالة الاختبار في التشغيل. ClangCodeCoverageCollector BaseDeviceMetricCollector الذي سيسحب قياسات تغطية Clang من الجهاز ويسجلها كعناصر اختبار. CountTestCasesCollector قم بحساب عدد حالات الاختبار الخاصة باختبار IRemoteTest المحدد والإبلاغ عنها. DebugHostLogOnFailureCollector المُجمع الذي سيقوم بجمع وتسجيل سجلات جانب المضيف عند حدوث فشل في حالة الاختبار. DeviceTraceCollector المُجمع الذي سيبدأ تتبع perfetto عند بدء تشغيل اختباري وتسجيل ملف التتبع في النهاية. FilePullerDeviceMetricCollector BaseDeviceMetricCollector الذي يستمع لمفتاح المقاييس القادم من الجهاز ويسحبها كملف من الجهاز. FilePullerLogCollector مسجل الملف المبلغ عنه من جانب الجهاز. جامع GcovCodeCoverage BaseDeviceMetricCollector الذي سيسحب قياسات تغطية gcov من الجهاز ويسجلها كعناصر اختبار. جامع GcovKernelCodeCodeCoverage BaseDeviceMetricCollector الذي سيسحب قياسات تغطية gcov kernel من debugfs وإخراجها من الجهاز ثم يسجلها أخيرًا كعناصر اختبار. HostStatsdMetricCollector IMetricCollector يجمع مقاييس statsd من جانب المضيف باستخدام أوامر الأداة المساعدة statsd. JavaCodeCoverageCollector BaseDeviceMetricCollector الذي سيسحب قياسات تغطية Java من الجهاز ويسجلها كعناصر اختبار. جامع LogcatOnFailure المُجمع الذي سيقوم بالتقاط وتسجيل logcat عند فشل حالة الاختبار. LogcatTimingMetricCollector أداة تجميع المقاييس التي تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدة اختبارات متكررة باستخدام أنماط regex معينة لتحليل إشارات البداية والنهاية لحدث ما من خطوط logcat. الوحدة النمطية LogcatCollector إصدار جامع logcat لكن للوحدة النمطية. PerfettoPullerMetricCollector التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه. RebootReasonCollector أداة التجميع التي تجمع إعادة تشغيل الجهاز أثناء التشغيل التجريبي والإبلاغ عنها حسب السبب والأهم. وقت التشغيل المُجمع الذي يجمع الطوابع الزمنية لإعادة تشغيل وقت التشغيل (تعطل خادم النظام) أثناء التشغيل التجريبي ، إن وجد. لقطة شاشة OnFailureCollector المُجمع الذي سيقوم بالتقاط وتسجيل لقطة شاشة عند فشل حالة الاختبار. ShowmapPullerMetricCollector. العرض التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه. TraceCmdCollector IMetricCollector يقوم بتجميع التتبع أثناء الاختبار باستخدام trace-cmd ، ويسجلها في الاستدعاء.

---

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

لا يمكن استخدام هذه الواجهة كملف حتى أنه يوسع ITestInvocationListener . فحص التكوين سيرفضه. يجب استخدامه كـ "metrics_collector".

لا يُتوقع من هواة الجمع الاحتفاظ بحالة داخلية حيث يمكن إعادة استخدامها في عدة أماكن. إذا كان يجب استخدام حالة داخلية بالفعل ، فيجب تنظيفها في 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) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) رد الاتصال عند انتهاء حالة الاختبار.
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) رد الاتصال عند انتهاء حالة الاختبار.
abstract void	onTestFail ( DeviceMetricData testData, TestDescription test) رد الاتصال عند فشل حالة الاختبار.
default void	onTestModuleEnded () يسمح بالتقاط وحدة الحدث المنتهية.
default void	onTestModuleStarted () يسمح بالتقاط حدث بدء الوحدة النمطية.
abstract void	onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) 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

فيه

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

انتهى onTestModule

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