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

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

IMetricCollector

public interface IMetricCollector
implements ILogSaverListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

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

BaseDeviceMetricCollector وBugreportzOnFailureCollector وClangCodeCoverageCollector وCountTestCasesCollector وDebugHostLogOnFailureCollector وFilePullerDeviceMetricCollector وFilePullerLogCollector وGcovCodeCoverageCollector وJavaCodeCoverageCollector وLogcatOnFailureCollector وScreenshotOnFailureCollector

BaseDeviceMetricCollector	التنفيذ الأساسي لـ `IMetricCollector` الذي يسمح ببدء عملية جمع البيانات وإيقافها في `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BugreportzOnFailureCollector	جمع تقرير أخطاء عند تعذُّر اختبار حالة
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية Clang من الجهاز ويُسجّلها كعناصر اختبار
CountTestCasesCollector	احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ `IRemoteTest` معيّن
DebugHostLogOnFailureCollector	أداة جمع ستجمع السجلات من جهة المضيف وتسجّلها عند حدوث خطأ في نموذج الاختبار.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات التغطية من gcov من الجهاز ويُسجّلها كعناصر اختبار
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` التي ستسحب قياسات تغطية Java من الجهاز وتُسجّلها كعناصر اختبار
LogcatOnFailureCollector	أداة جمع ستسجِّل logcat وتُسجِّله عند تعذُّر اختبار حالة معيّنة.
ScreenshotOnFailureCollector	أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.

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

لا يمكن استخدام هذه الواجهة حتى إذا كانت تمتد إلى ITestInvocationListener. وسيؤدي التحقّق من الإعدادات إلى رفضه. ويجب استخدامه كأحد "مجمع_المقاييس".

لا يُتوقّع أن تحتفظ أدوات جمع البيانات بحالة داخلية لأنّه قد تتم إعادة استخدامها في عدة أماكن. إذا كان يجب استخدام حالة داخلية، يجب تنظيفها في init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

ملخّص

الطرق العامة
`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)` يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` يتمّ إجراء طلب إعادة الاتصال عند تعذُّر اختبار حالة معيّنة.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` يتمّ إجراء مكالمة هاتفية عند انتهاء إجراء الاختبار.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` يتمّ إجراء طلب إعادة الاتصال عند بدء إجراء اختبار.
`abstract void`	`onTestStart(DeviceMetricData testData)` يتمّ إجراء مكالمة هاتفية عند بدء حالة اختبار.

الطرق العامة

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`	المستمع الجديد يلف المستمع الأصلي

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

يتمّ إجراء طلب إعادة الاتصال عند تعذُّر اختبار حالة معيّنة بسبب تعذُّر افتراض معيّن.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتفظ بالبيانات لحالة الاختبار
`test`	`TestDescription`: `TestDescription` لإطار الاختبار الجاري

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار. من المفترض أن يكون هذا هو وقت التنظيف.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتفظ بالبيانات لحالة الاختبار سيكون هو الكائن نفسه الذي تم استخدامه أثناء `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	‫: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

يتمّ إجراء مكالمة هاتفية عند انتهاء حالة اختبار. من المفترض أن يكون هذا هو وقت التنظيف.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتفظ بالبيانات لحالة الاختبار سيكون هو الكائن نفسه الذي تم استخدامه أثناء `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	‫: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`
`test`	`TestDescription`: `TestDescription` لإطار الاختبار الجاري

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

يتمّ إجراء طلب إعادة الاتصال عند تعذُّر اختبار حالة معيّنة.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتفظ بالبيانات لحالة الاختبار
`test`	`TestDescription`: `TestDescription` لإطار الاختبار الجاري

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

المعلمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات التنفيذ سيكون هو الكائن نفسه المستخدَم أثناء `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	‫: الخريطة الحالية للمقاييس التي تم تمريرها إلى `ITestLifeCycleReceiver.testRunEnded(long, Map)`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

يتمّ إجراء طلب إعادة الاتصال عند بدء إجراء اختبار.

المعلمات
`runData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتوي على بيانات التنفيذ

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

يتمّ إجراء مكالمة هاتفية عند بدء حالة اختبار.

المعلمات
`testData`	`DeviceMetricData`: `DeviceMetricData` الذي يحتفظ بالبيانات لحالة الاختبار