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

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

IDeviceActionReceiver

public interface IDeviceActionReceiver

com.android.tradefed.device.IDeviceActionReceiver

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

‫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، ويسجّلها في عملية الاستدعاء.

توفّر واجهة برمجة تطبيقات لتلقّي أحداث الجهاز.

ملاحظة: تتوفّر هذه الميزة حاليًا لجامعي المقاييس فقط.

ملخّص

الطُرق العامة
`default boolean`	`isDisabledReceiver()` تحديد ما إذا كانت ميزة `IDeviceActionReceiver` غير مفعَّلة أم لا
`abstract void`	`rebootEnded(ITestDevice device)` تلقّي إشعار عند انتهاء عملية إعادة التشغيل على الجهاز
`abstract void`	`rebootStarted(ITestDevice device)` تلقّي إشعار عند بدء إعادة التشغيل على الجهاز
`abstract void`	`setDisableReceiver(boolean isDisabled)` تحدّد ما إذا كان يجب إيقاف `IDeviceActionReceiver`.

الطُرق العامة

isDisabledReceiver

public boolean isDisabledReceiver ()

تحديد ما إذا كانت ميزة IDeviceActionReceiver غير مفعَّلة أم لا

المرتجعات
`boolean`	تعرض هذه السمة القيمة "صحيح" إذا كانت ميزة "الوضع الداكن" غير مفعّلة، والقيمة "خطأ" في الحالات الأخرى.

rebootEnded

public abstract void rebootEnded (ITestDevice device)

تلقّي إشعار عند انتهاء عملية إعادة التشغيل على الجهاز

ملاحظة: يجب على أجهزة الاستقبال تجنُّب إعادة التشغيل أثناء معاودة الاتصال هذه. وسيتم تجاهل أي محاولة لإعادة التشغيل.

المعلمات
`device`	‫`ITestDevice`: `ITestDevice` حيث انتهت عملية إعادة التشغيل

الرميات
`DeviceNotAvailableException`

rebootStarted

public abstract void rebootStarted (ITestDevice device)

تلقّي إشعار عند بدء إعادة التشغيل على الجهاز

المعلمات
`device`	`ITestDevice`: `ITestDevice` حيث بدأت عملية إعادة التشغيل

الرميات
`DeviceNotAvailableException`

setDisableReceiver

public abstract void setDisableReceiver (boolean isDisabled)

تحدّد ما إذا كان يجب إيقاف IDeviceActionReceiver. يعني إيقافها أنّه لن يتم تسجيلها على الجهاز لتلقّي أحداث إجراءات الجهاز.

المعلمات
`isDisabled`	`boolean`