تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

موقع IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

الفئات الفرعية المعروفة غير المباشرة

AtraceCollector	يشير هذا المصطلح إلى `IMetricCollector` يتم تنفيذه أثناء الاختبار ويجمع النتيجة والسجلّ. إلى الاستدعاء.
AtraceRunMetricCollector	جمع آثار الأنشطة من كل دليل الاختبار ضمن الدليل المحدّد من جهاز الاختبار، سجل دليل الاختبار وانشر ملفات التتبع أسفل دليل الاختبار وتجميع المقاييس.
BaseDeviceMetricCollector	التنفيذ الأساسي لآلية `IMetricCollector` التي تسمح ببدء جمع البيانات وإيقافها في `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BluetoothConnectionLatencyCollector	سترسل أداة التجميع إلى الأجهزة إعدادات مقياس المدة المحدّدة مسبقًا للإحصاءات وستجمع هذه الإعدادات. مدة اتصال البلوتوث لكل ملف شخصي.
BluetoothConnectionStateCollector	ستجمع أداة التجميع هذه مقاييس BluetoothConnectionStateChanged وستسجّل حالة الاتصال رقم لكل ملف شخصي.
BluetoothHciSnoopLogCollector	أداة جمع البيانات لتفعيل تسجيل التطفل عبر وحدة تحكم المضيف في بلوتوث (DUT) وجمع السجلّ لكل اختبار.
BugreportzOnFailureCollector	جمع تقرير بالأخطاء عند تعذُّر تقديم حالة اختبار.
BugreportzOnTestCaseFailureCollector	جمع تقرير الأخطاء عند تعذُّر إجراء اختبار أثناء إجراء عملية تشغيل.
ClangCodeCoverageCollector	مفتاح `BaseDeviceMetricCollector` الذي يسحب الاختصار قياسات التغطية خارج الجهاز وتسجيلها كعناصر اختبار.
CountTestCasesCollector	احتساب عدد حالات الاختبار لـ "`IRemoteTest`" والإبلاغ عنه
DebugHostLogOnFailureCollector	المجمِّع الذي سيجمع السجلات من جهة المضيف ويسجِّلها عند حدوث فشل في حالة الاختبار.
DeviceTraceCollector	المجمِّع الذي سيبدأ تتبع الأداء عند بدء تشغيل الاختبار وملف تتبع السجل في النهاية.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يرصد مفتاح المقاييس الواردة من الجهاز ويسحب كملف من الجهاز.
FilePullerLogCollector	سجلّ الملف الذي تم الإبلاغ عنه من جانب الجهاز.
GcovCodeCoverageCollector	دالة `BaseDeviceMetricCollector` التي ستسحب gcov قياسات التغطية خارج الجهاز وتسجيلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيسحب نواة gcov قياسات التغطية من برامج تصحيح الأخطاء وخارجها، ثم تسجِّلها في النهاية كاختبار والأدوات.
HostStatsdMetricCollector	`IMetricCollector` الذي يجمع المقاييس الإحصائية من جهة المضيف باستخدام أداة الإحصاءات الأوامر.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيسحب Java قياسات التغطية خارج الجهاز وتسجيلها كعناصر اختبار.
LogcatOnFailureCollector	المجمِّع الذي سيلتقط أداة Logcat وتسجيلها عند تعذُّر حالة الاختبار.
LogcatTimingMetricCollector	أداة تجميع المقاييس التي تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من Logcat أثناء اختبار واحد أو عدة اختبارات متكررة باستخدام أنماط تعبير عادي محددة لتحليل إشارات البداية والنهاية الحدث من أسطر Logcat.
ModuleLogcatCollector	يشير ذلك المصطلح إلى نسخة من أداة جمع السجلّات ولوحدة القياس.
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح سحب ملفات الأداء من الجهاز وجمع المقاييس منه.
RewreasonCollector	يجمع هذا المجمِّع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار ويبلِّغ عنها حسب السبب والعدد.
RuntimeRedirectCollector	أداة التجميع التي تجمع الطوابع الزمنية لعمليات إعادة التشغيل في وقت التشغيل (أعطال خادم النظام) أثناء الاختبار التشغيل، إن وجدت.
لقطة الشاشة OnFailureCollector	المجمِّع الذي سيلتقط لقطة شاشة ويسجلها عند إخفاق حالة اختبار.
ShowmapPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب خريطة العرض من الجهاز وجمع المقاييس منه.
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)` معاودة الاتصال عند انتهاء حالة اختبار.
`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)` معاودة الاتصال عند بدء حالة اختبار.

الطرق العامة

مستوى التقاط الوحدة

public boolean captureModuleLevel ()

تحدّد هذه السمة ما إذا كان يمكن تطبيق التجميع على مستوى الوحدة ويجب تنفيذه.

المرتجعات
`boolean`

الحصول على معلومات الإصدار

public abstract  getBuildInfos ()

تعرض قائمة معلومات الإصدار المتوفّرة في عملية الاستدعاء.

المرتجعات

الحصول على أجهزة

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`

onTestUnitEnded

public void onTestModuleEnded ()

يسمح بالتقاط حدث انتهى الوحدة.

الرميات
	com.android.tradefed.device.DeviceNotavailableException
`DeviceNotAvailableException`

تم بدء onTestModule

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`