اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

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

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 و14 غيرها

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	جمع bugreportz عند تعذُّر تنفيذ حالة اختبار
BugreportzOnTestCaseFailureCollector	جمع bugreportz عند تعذُّر تنفيذ حالة اختبار في عملية تشغيل
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات التغطية في Clang من الجهاز ويسجّلها كعناصر اختبار.
CodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب مقاييس تغطية Java والرمز البرمجي الأصلي من الجهاز ويسجّلها كعناصر اختبار.
CountTestCasesCollector	احتساب عدد حالات الاختبار لـ `IRemoteTest` معيّن وإعداد تقرير عنه
DebugHostLogOnFailureCollector	أداة تجميع ستجمع سجلات جانب المضيف وتسجّلها عند حدوث خطأ في حالة الاختبار.
DeviceTraceCollector	أداة تجميع ستبدأ تتبُّع Perfetto عند بدء تشغيل الاختبار وتسجيل ملف التتبُّع في النهاية.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الوارد من الجهاز ويجلبها كملف من الجهاز.
FilePullerLogCollector	مسجّل الملف الذي تم الإبلاغ عنه من جهة الجهاز
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات تغطية gcov من الجهاز ويسجّلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية gcov kernel من debugfs ومن الجهاز، ثم يسجّلها أخيرًا كعناصر اختبار.
HostStatsdMetricCollector	`IMetricCollector` التي تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات تغطية Java من الجهاز ويسجّلها كعناصر اختبار.
LogcatOnFailureCollector	أداة تجميع ستسجّل logcat عند تعذُّر تنفيذ حالة اختبار.
LogcatTimingMetricCollector	أداة لجمع المقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء إجراء اختبار واحد أو أكثر من الاختبارات المتكرّرة باستخدام أنماط regex المحدّدة لتحليل إشارات البدء والانتهاء لحدث من أسطر logcat.
ModuleLogcatCollector	إصدار أداة جمع logcat ولكن للوحدة.
PerfettoFilePullerCollector	أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.
PerfettoPullerMetricCollector	تم إيقاف هذا الصف نهائيًا. يُرجى استخدام `PerfettoFilePullerCollector` و`ERROR(/PerfettoTracePostProcessor)` بدلاً منها.
RebootReasonCollector	أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء التشغيل التجريبي وتُبلغ عنها حسب السبب وعدد المرات.
RuntimeRestartCollector	أداة تجميع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء وقت التشغيل (تعطُّل خادم النظام) أثناء تنفيذ الاختبار، إن وُجدت.
ScreenshotOnFailureCollector	أداة تجميع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر حالة اختبار.
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)` يتم تنفيذ هذا الإجراء عند انتهاء حالة الاختبار.
`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`