اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IDeviceActionReceiver

public interface IDeviceActionReceiver

com.android.tradefed.device.IDeviceActionReceiver

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

AtraceCollector وAtraceRunMetricCollector وBaseDeviceMetricCollector وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothHciSnoopLogCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector وCountTestCasesCollector وDebugHostLogOnFailureCollector وDeviceTraceCollector وFilePullerDeviceMetricCollector وFilePullerLogCollector و16 صفًا آخر

AtraceCollector	‫`IMetricCollector` الذي يُشغِّل أداة Atrace أثناء الاختبار ويجمع النتيجة ويسجِّل ها في الاستدعاء
AtraceRunMetricCollector	يجمع هذا الصف آثار التتبُّع من جميع أدلة الاختبار ضِمن الدليل المحدّد من جهاز الاختبار، ويسجِّل دليل الاختبار، ويُجري عملية ما بعد المعالجة لملفات آثار التتبُّع ضِمن دليل الاختبار، ويجمع المقاييس.
BaseDeviceMetricCollector	تنفيذ أساسي لـ `IMetricCollector` يسمح ببدء عملية الجمع وإيقافها في `onTestRunStart(DeviceMetricData)` و`onTestRunEnd(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` الذي سيجلب قياسات تغطية kernel من gcov من debugfs ومن الجهاز ثم يسجِّلها أخيرًا كعناصر اختبار.
HostStatsdMetricCollector	‫`IMetricCollector` الذي يجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd.
JavaCodeCoverageCollector	‫`BaseDeviceMetricCollector` الذي سيجلب قياسات تغطية Java من الجهاز ويسجِّلها كعناصر اختبار.
LogcatOnFailureCollector	جامع سيجمع سجلّ logcat ويسجّله عند فشل حالة اختبار أو تشغيل اختبار.
LogcatTimingMetricCollector	جامع مقاييس يجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدة اختبارات متكررة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والانتهاء لحدث من أسطر logcat.
ModuleLogcatCollector	إصدار من جامع logcat ولكن للوحدة
ModulePerfettoCollector	جامع سيُشغِّل أداة تتبُّع Perfetto عند بدء وحدة اختبار وانتهائها وإعادة تشغيل الجهاز.
PerfettoFilePullerCollector	جامع يجلب ملفات تتبُّع Perfetto من الجهاز، ويضغطها اختياريًا، و يضيفها إلى سجلّات الاختبار.
PerfettoPullerMetricCollector	تم إيقاف هذا الصف نهائيًا. يُرجى استخدام `PerfettoFilePullerCollector` و`ERROR(/PerfettoTracePostProcessor)` بدلاً منه.
RebootReasonCollector	جامع يجمع عمليات إعادة تشغيل الجهاز أثناء تشغيل الاختبار ويبلِغ عنها حسب السبب والعدد.
RuntimeRestartCollector	جامع يجمع الطوابع الزمنية لعمليات إعادة تشغيل وقت التشغيل (أعطال خادم النظام) أثناء تشغيل الاختبار ، إن وُجدت.
ScreenRecordOnFailureCollector	جامع سيجمع تسجيل شاشة ويسجّله عند فشل حالة اختبار.
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`