اعتبارًا من عام 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.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

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

‫AggregatePostProcessor وAndroidBuildResultReporter وAtraceCollector وAtraceRunMetricCollector وAveragePostProcessor وBaseDeviceMetricCollector وBasePostProcessor وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothConnectionSuccessRatePostProcessor وBluetoothHciSnoopLogCollector وBugreportCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector و87 غيرها

AggregatePostProcessor	أداة تجميع المقاييس التي تعرض الحد الأدنى والحد الأقصى والمتوسط والتباين والانحراف المعياري والإجمالي والعدد، بالإضافة إلى النِسَب المئوية الاختيارية للمقاييس الرقمية التي يتم جمعها أثناء عمليات تشغيل الاختبار المتعددة التكرار، مع التعامل معها كأرقام مضاعفة.
AndroidBuildResultReporter	إرسال نتائج الاختبار إلى Android Build API
AtraceCollector	`IMetricCollector` هو برنامج يتم تشغيله أثناء الاختبار لجمع النتائج وتسجيلها في سجلّ الاستدعاء.
AtraceRunMetricCollector	يجمع عمليات التتبُّع من جميع أدلة الاختبار ضمن الدليل المحدّد من الجهاز الاختباري، ويسجّل دليل الاختبار، ويعالج ملفات التتبُّع بعد ذلك ضمن دليل الاختبار، ويجمع المقاييس.
AveragePostProcessor	تنفيذ معالج لاحق يحسب متوسط قائمة المقاييس
BaseDeviceMetricCollector	التنفيذ الأساسي لـ `IMetricCollector` الذي يتيح بدء عملية الجمع وإيقافها في `onTestRunStart(DeviceMetricData)` و`onTestRunEnd(DeviceMetricData,Map)`
BasePostProcessor	الفئة الأساسية `IPostProcessor` التي يجب أن يوسّعها كل تنفيذ.
BluetoothConnectionLatencyCollector	سيرسل أداة جمع البيانات إعدادات مقياس المدة الزمنية المحدّدة مسبقًا في statsd إلى الأجهزة، وسيجمع مدة اتصال البلوتوث لكل ملف شخصي.
BluetoothConnectionStateCollector	سيجمع هذا الجامع مقاييس BluetoothConnectionStateChanged وسيسجّل رقم حالة الاتصال لكل ملف شخصي.
BluetoothConnectionSuccessRatePostProcessor	تنفيذ معالج لاحق يحسب معدّل النجاح لملف تعريف البلوتوث استخدِم "metric-key-match" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في مصفوفة رقمية، مثل [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	أداة جمع لتفعيل تسجيل التطفل على واجهة وحدة تحكّم المضيف للبلوتوث على الجهاز قيد الاختبار وجمع السجلّ لكل اختبار
BugreportCollector	`ITestInvocationListener` وسيط يجمع تقارير الأخطاء عند وقوع أحداث قابلة للضبط، ثم يستدعي `ITestInvocationListener.testLog` على العناصر التابعة له بعد جمع كل تقرير خطأ.
BugreportzOnFailureCollector	جمع bugreportz عند تعذُّر تنفيذ حالة اختبار
BugreportzOnTestCaseFailureCollector	جمع bugreportz عند تعذُّر تنفيذ حالة اختبار في عملية تشغيل
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات تغطية Clang من الجهاز ويسجّلها كعناصر اختبار.
CodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب مقاييس تغطية Java والرمز البرمجي الأصلي من الجهاز ويسجّلها كعناصر اختبار.
CollectingTestListener	`ITestInvocationListener` سيتم من خلاله جمع جميع نتائج الاختبار.
CommandStatusHandler	معالج يساعد في تتبُّع حالة عملية استدعاء وتعديلها.
ConditionFailureMonitor	راقِب أي أخطاء ناتجة عن عملية الاستدعاء.
ConsoleResultReporter	أداة إعداد التقارير عن النتائج لطباعة نتائج الاختبار في وحدة التحكّم
CountTestCasesCollector	احتساب عدد حالات الاختبار `IRemoteTest` وإعداد تقرير بها
CoverageMetadataCollector	`ILogSaverListener` الذي يجمع قياسات التغطية المسجّلة وينشئ CoverageMetadataProto لمعالجتها بواسطة خدمة "تغطية الرموز البرمجية" في Android
DebugHostLogOnFailureCollector	المجمِّع الذي سيجمع سجلّات جانب المضيف ويسجّلها عند حدوث خطأ في حالة الاختبار.
DeviceReleaseReporter	فئة Device release reporter التي تتعامل مع التواصل مع العملية الرئيسية للأجهزة التي سيتم إطلاقها.
DeviceTraceCollector	أداة تجميع ستبدأ تتبُّع Perfetto عند بدء تشغيل الاختبار وتسجيل ملف التتبُّع في النهاية.
DeviceUnavailableMonitor	يحاول هذا المستمع تسجيل DNAE على مستوى حالة الاختبار فقط.
EventsLoggerListener	أداة معالجة تسجّل جميع الأحداث التي تتلقّاها في ملف
FileProtoResultReporter	أداة إعداد تقارير Proto التي تنقل `TestRecord` إلى ملف.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الوارد من الجهاز ويجلبها كملف من الجهاز.
FilePullerLogCollector	مسجّل الملف الذي تم الإبلاغ عنه من جهة الجهاز
FilteredResultForwarder	صيغة `ResultForwarder` التي تسمح فقط بالإبلاغ عن قائمة `TestDescription` المسموح بها.
FormattedGeneratorReporter	أداة إعداد التقارير التي تتيح إنشاء التقارير بتنسيق معيّن
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيجلب قياسات التغطية باستخدام gcov من الجهاز ويسجّلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات تغطية gcov kernel من debugfs ومن الجهاز، ثم يسجّلها أخيرًا كعناصر اختبار.
GeminiDebuggingPostProcessor	معالج ما بعد الإنتاج ينشئ طلبات بحث لتصحيح الأخطاء.
GranularRetriableTestWrapper.StartEndCollector	أداة مساعدة الصف لتحديد بداية ونهاية التشغيل المفقودتَين
HostStatsdMetricCollector	`IMetricCollector` التي تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd.
ICommandScheduler.IScheduledInvocationListener	أداة معالجة أحداث الاستدعاء عند اكتمال الاستدعاء
ILogSaverListener	يسمح `ITestInvocationListener` بالاستماع إلى وقت حفظ ملفات السجلّ.
IMetricCollector	ستتم إضافة هذه الواجهة كعنصر تزييني عند إعداد تقارير بنتائج الاختبارات من أجل جمع المقاييس المطابقة.
IPostProcessor	المعالجات اللاحقة هي عنصر في Trade Federation يهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج.
IShardableListener	`ITestInvocationListener` يمكن تقسيمها
ISupportGranularResults	واجهة تحدّد ما إذا كان `ITestInvocationListener` يتيح تلقّي النتائج الدقيقة أم لا.
ITestSummaryListener	واجهة تتيح لـ `ITestInvocationListener` تبادل بعض المعلومات المحدودة من خلال الملخّصات.
InvocationProtoResultReporter	المسؤول عن تخزين معلومات التخزين المؤقت على مستوى الاستدعاء وقائمة الوحدات
InvocationToJUnitResultForwarder	فئة تستمع إلى أحداث `ITestInvocationListener` وتعيد توجيهها إلى `TestListener`.
JarHostTest.HostTestListener	أداة معالجة برنامج التضمين التي تعيد توجيه جميع الأحداث باستثناء testRunStarted()‎ وtestRunEnded()‎ إلى أداة المعالجة المضمّنة.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` سيتم من خلاله استخراج مقاييس تغطية Java من الجهاز وتسجيلها كعناصر اختبار.
JsonHttpTestResultReporter	أداة إعداد تقارير النتائج التي ترمّز نتائج مقاييس الاختبار ومعلومات الفرع والجهاز إلى JSON ثم تنشرها إلى نقطة نهاية خدمة HTTP
LUCIResultReporter	أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبارات التي يحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجّل موقع الملف في وحدة التحكّم.
LastShardDetector	عند تنفيذ التقسيم المحلي، نريد أحيانًا تنفيذ بعض الإجراءات فقط عندما يصل الجزء الأخير إلى `invocationEnded(long)`.
LegacySubprocessResultsReporter	تنفيذ ثابت لأداة تسجيل نتائج العمليات الفرعية يجب أن يظل متوافقًا مع الإصدارات السابقة من TF/CTS (مثل 8 والإصدارات الأحدث)، على الرغم من التغييرات في الفئة الرئيسية.
LogSaverResultForwarder	`ResultForwarder` لحفظ السجلات باستخدام أداة حفظ الملفات العامة
LogcatCrashResultForwarder	المستمع الخاص: عند حدوث أعطال (تعطُّل عملية القياس)، سيحاول استخراج العطل من logcat وإضافته إلى رسالة العطل المرتبطة بالاختبار.
LogcatOnFailureCollector	أداة تجميع ستسجّل logcat عند تعذُّر حالة اختبار أو تشغيل اختبار.
LogcatTimingMetricCollector	أداة لجمع المقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء إجراء اختبار واحد أو أكثر من الاختبارات المتكررة باستخدام أنماط regex المحدّدة لتحليل إشارات البدء والانتهاء لحدث من أسطر logcat.
MetricFilePostProcessor	يُستخدَم لتحميل ملف سجلّ المقاييس الذي تمّ جمعه أثناء الاختبار وعلى مستوى التشغيل.
MetricsXMLResultReporter	تكتب أداة MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد من خلال المَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.
ModuleListener	يتم ربط أداة معالجة الأحداث بكل `IRemoteTest` في كل وحدة من أجل جمع قائمة النتائج.
ModuleLogcatCollector	إصدار أداة جمع logcat ولكن للوحدة.
ModulePerfettoCollector	أداة تجميع ستبدأ عملية تتبُّع Perfetto عند بدء وحدة الاختبار وانتهائها وإعادة تشغيل الجهاز.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج التي تهدف إلى إعداد تقارير عن النتائج على مستوى الوحدة فقط
ModuleResultsAndMetricsForwarder	تمثّل هذه السمة امتدادًا للسمة `ResultAndLogForwarder`، وهي تضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.
NameMangleListener	مستمع وكيل لترجمة أسماء طرق الاختبار والفئات والحِزم عند الإبلاغ عن النتائج.
PassingTestFileReporter	`ITestInvocationListener` يحفظ قائمة بحالات الاختبار الناجحة في ملف اختبار
PerfettoFilePullerCollector	أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.
PerfettoGenericPostProcessor	معالج لاحق يعالج ملف proto الخاص بمقياس نصي/ثنائي في أزواج مفتاح/قيمة من خلال التوسيع بشكل متكرر لرسائل proto والحقول ذات القيم النصية إلى أن يتم العثور على الحقل ذي القيمة الرقمية.
PerfettoPullerMetricCollector	تم إيقاف هذه الفئة نهائيًا. يُرجى استخدام `PerfettoFilePullerCollector` و`ERROR(/PerfettoTracePostProcessor)` بدلاً من ذلك.
PerfettoTracePostProcessor	معالج لاحق يستردّ ملفات تتبُّع Perfetto من سجلّات الاختبار ويشغّل معالج التتبُّع عليها لإنتاج نموذج أولي لمقياس Perfetto.
PrettyTestEventLogger	مسجّل يطابق الأحداث ويسجّلها لتسهيل عملية تصحيح الأخطاء
ProtoResultReporter	يُنشئ برنامج إعداد التقارير عن النتائج `TestRecord` بروتوكول buffer يحتوي على جميع النتائج.
PythonBinaryHostTest.PythonForwarder	أداة إعادة توجيه النتائج لاستبدال اسم التشغيل باسم الملف الثنائي
RebootReasonCollector	أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء التشغيل التجريبي وتُبلغ عنها حسب السبب وعدد المرات.
RemoteTestTimeOutEnforcer	برامج معالجة الأحداث التي تتيح التحقّق من وقت تنفيذ إعداد اختبار معيّن وإيقافه إذا تجاوز المهلة المحدّدة.
ReportPassedTests	الإبلاغ في ملف عن الفلاتر المحتملة لاستبعاد الاختبارات الناجحة
ResultAggregator	معالج خاص يعرض النتائج المجمّعة عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتّخاذها.
ResultAndLogForwarder	أداة إعادة التوجيه للنتائج وأحداث السجلات
ResultDBReporter	أداة إعداد تقارير النتائج التي تحمّل نتائج الاختبار إلى ResultDB.
ResultForwarder	`ITestInvocationListener` يعيد توجيه نتائج الاستدعاء إلى قائمة بمستمعين آخرين.
ResultReporter
RetryLogSaverResultForwarder	دالة إعادة توجيه تعالج أيضًا تمرير المحاولة الحالية التي نحن بصددها.
RetryResultForwarder	إضافة `ResultForwarder` التي يتم دائمًا إرسالها إلى رقم محاولة معيّن
RuntimeRestartCollector	أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء وقت التشغيل (تعطُّل خادم النظام) أثناء تنفيذ الاختبار، إن وُجدت.
ScreenRecordOnFailureCollector	أداة تجميع ستسجّل لقطة شاشة وتدوّنها عند تعذُّر تنفيذ حالة اختبار.
ScreenshotOnFailureCollector	أداة تجميع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر إحدى حالات الاختبار.
ShardListener	`ITestInvocationListener` يجمع النتائج من جزء من عملية الاستدعاء (يُعرف أيضًا باسم تقسيم عملية الاستدعاء لتنفيذها على موارد متعددة بالتوازي)، ويعيد توجيهها إلى مستمع آخر.
ShardMainResultForwarder	`ResultForwarder` يجمع نتائج عمليات استدعاء الاختبارات المجزأة.
ShowmapPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منها.
SimpleperfProfilePostProcessor	معالج لاحق يعثر على بيانات تحديد الأداء في simpleperf وينشئ ملف تعريف pprof.
StatsdBeforeAfterGaugeMetricPostProcessor	معالج لاحق يعالج مقاييس المقياس التي تم جمعها باستخدام أسلوب "قبل/بعد"، أي
StatsdEventMetricPostProcessor	معالج لاحق يعالج مقاييس الأحداث في تقارير statsd إلى أزواج المفتاح/القيمة، وذلك باستخدام أدوات التنسيق المحدّدة في المعالج.
StatsdGenericPostProcessor	معالج لاحق يعالج تقارير statsd الثنائية الخاصة ببروتوكول proto إلى أزواج مفتاح/قيمة من خلال توسيع التقرير كبنية شجرية.
StreamProtoResultReporter	مثال على تنفيذ `ProtoResultReporter`
SubprocessResultsReporter	تنفِّذ `ITestInvocationListener` ليتم تحديدها على أنّها result_reporter ويتم إعادة توجيه نتائج الاختبارات وعمليات تشغيل الاختبارات وطلبات الاختبار من العملية الفرعية.
SuiteResultReporter	جمع نتائج الاختبارات لتنفيذ مجموعة اختبارات كاملة وعرض النتائج النهائية
TestRunResultListener	معالج أحداث يتيح قراءة حالة تشغيل الاختبار النهائي.
TestTimeoutEnforcer	برامج معالجة الأحداث التي تتيح التحقّق من وقت تنفيذ حالة اختبار معيّنة وإيقافها إذا تجاوزت المهلة المحدّدة.
TextResultReporter	أداة إعداد تقارير عن نتائج الاختبار تعيد توجيه النتائج إلى أداة طباعة نتائج اختبار JUnit النصية.
TraceCmdCollector	`IMetricCollector` يجمع عمليات التتبُّع أثناء الاختبار باستخدام trace-cmd، ويسجّلها في عملية الاستدعاء.
TradefedSandboxRunner.StubScheduledInvocationListener	رمز بديل `IScheduledInvocationListener` لا ينفّذ أي إجراء.
XmlFormattedGeneratorReporter	تنفيذ `FormattedGeneratorReporter` الذي يحدد التنسيق الذي ستعرض به نتائج الحزمة بتنسيق xml.
XmlResultReporter	يكتب نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

معالج نتائج الاختبار من عملية استدعاء الاختبار

يمكن أن يتضمّن استدعاء الاختبار نفسه عمليات تشغيل اختبار متعددة، لذا سيكون تسلسل عمليات الاستدعاء

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

ملخّص

الإجراءات العامة
`default TestSummary`	`getSummary()` تسمح هذه السمة لـ InvocationListener بعرض ملخّص.
`default void`	`invocationEnded(long elapsedTime)` تعرض هذه السمة ما إذا تم إنهاء عملية الاستدعاء بنجاح أو بسبب حدوث خطأ.
`default void`	`invocationFailed(FailureDescription failure)` تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.
`default void`	`invocationFailed(Throwable cause)` تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.
`default void`	`invocationInterrupted()` يتم استدعاؤها عند إيقاف المشغّل، وتتيح عملية الاستدعاء فرصة تنفيذ إجراء معيّن قبل الإنهاء.
`default void`	`invocationSkipped(SkipReason reason)` تسجيل حالة استدعاء على أنّه تم تخطّيه
`default void`	`invocationStarted(IInvocationContext context)` تسجّل هذه السمة بداية تنفيذ الاختبار.
`default void`	`testModuleEnded()` تسجّل هذه السمة نهاية عملية تنفيذ وحدة.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` تسجّل هذه السمة بداية تشغيل وحدة.

الإجراءات العامة

getSummary

public TestSummary getSummary ()

تسمح هذه السمة لـ InvocationListener بعرض ملخّص.

المرتجعات
`TestSummary`	`TestSummary` تلخّص عملية التشغيل، أو قيمة فارغة

invocationEnded

public void invocationEnded (long elapsedTime)

تعرض هذه السمة ما إذا تم إنهاء عملية الاستدعاء بنجاح أو بسبب حدوث خطأ.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation.

المعلَمات
`elapsedTime`	‫`long`: الوقت المنقضي لتنفيذ الاستدعاء بالملّي ثانية

invocationFailed

public void invocationFailed (FailureDescription failure)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation.

المعلَمات
`failure`	`FailureDescription`: `FailureDescription` الذي يصف سبب التعذُّر

invocationFailed

public void invocationFailed (Throwable cause)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation.

المعلَمات
`cause`	`Throwable`: سبب الخطأ `Throwable`

invocationInterrupted

public void invocationInterrupted ()

يتم استدعاؤها عند إيقاف المشغّل، وتتيح عملية الاستدعاء فرصة تنفيذ إجراء معيّن قبل الإنهاء.

invocationSkipped

public void invocationSkipped (SkipReason reason)

تسجيل حالة استدعاء على أنّه تم تخطّيه

المعلَمات
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

تسجّل هذه السمة بداية تنفيذ الاختبار.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation. على مقدّمي التقارير إلغاء هذه الطريقة لتفعيل إعداد التقارير على أجهزة متعددة.

المعلَمات
`context`	‫`IInvocationContext`: معلومات حول طلب التنفيذ

testModuleEnded

public void testModuleEnded ()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

تسجّل هذه السمة بداية تشغيل وحدة. يرتبط هذا الإجراء الاحتياطي بـ testModuleEnded() وهو اختياري في التسلسل. يتم استخدامها فقط أثناء عملية تشغيل تستخدم وحدات: أدوات التشغيل المستندة إلى الحزمة.

المعلَمات
`moduleContext`	`IInvocationContext`: `IInvocationContext` الخاص بالوحدة