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

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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

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

AggregatePostProcessor وAtraceCollector وAtraceRunMetricCollector وAveragePostProcessor وBaseDeviceMetricCollector وBasePostProcessor وBluetoothConnectionLatencyCollector وBluetoothConnectionStateCollector وBluetoothConnectionSuccessRatePostProcessor وBluetoothHciSnoopLogCollector وBugreportCollector وBugreportzOnFailureCollector وBugreportzOnTestCaseFailureCollector وClangCodeCoverageCollector وCodeCoverageCollector و78 عملية أخرى

AggregatePostProcessor	مجمّع مقاييس يقدّم الحدّ الأدنى والحدّ الأقصى والمتوسّط والتباين والانحراف المعياري والإجمالي والعدد والنسب المئوية اختياريًا للمقاييس الرقمية التي يتم جمعها أثناء عمليات تنفيذ الاختبار المتكرّرة، ويتعامل معها على أنّها أعداد مزدوجة.
AtraceCollector	`IMetricCollector` التي تُجري عملية تتبُّع أثناء الاختبار وتجمع النتيجة وتُسجّلها في الطلب
AtraceRunMetricCollector	يتم جمع عمليات التتبّع من جميع الدليل التجريبي ضمن الدليل المحدّد من الجهاز التجريبي، وتسجيل الدليل التجريبي ومعالجة ملفات التتبّع بعد تسجيلها ضمن الدليل التجريبي وتجميع المقاييس.
AveragePostProcessor	تنفيذ وحدة معالجة ما بعد التشغيل التي تحسب متوسّط قائمة المقاييس
BaseDeviceMetricCollector	التنفيذ الأساسي لـ `IMetricCollector` الذي يسمح ببدء عملية جمع البيانات وإيقافها في `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`
BasePostProcessor	القاعدة `IPostProcessor` التي يجب أن تمتد إليها كل عملية تنفيذ
BluetoothConnectionLatencyCollector	سيُرسِل المجمّع إعدادات مقياس مدّة statsd المحدّدة مسبقًا إلى الأجهزة وسيجمع مدّة اتصال Bluetooth لكل ملف شخصي.
BluetoothConnectionStateCollector	سيجمع هذا المجمّع مقاييس BluetoothConnectionStateChanged ويُسجِّل حالة الاتصال رقمًا لكل ملف شخصي.
BluetoothConnectionSuccessRatePostProcessor	تنفيذ المعالج اللاحق الذي يحسب معدّل النجاح لملف شخصي للبلوتوث استخدِم "metric-key-match" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في صفيف صعِد رقمي مثال [0، 1، 2، 3، 0، 1، 2، 3].
BluetoothHciSnoopLogCollector	أداة جمع لتسجيل التطفل على واجهة تحكم المضيف للبلوتوث على جهاز التحكّم في العينة وجمع السجلّ لكل اختبار
BugreportCollector	`ITestInvocationListener` للمرور بدون معالجة تجمع تقارير الأخطاء عند حدوث أحداث قابلة للضبط ، ثم تستدعي `ITestInvocationListener.testLog` في عناصرها الفرعية بعد جمع كل تقرير أخطاء.
BugreportzOnFailureCollector	جمع تقرير أخطاء عند تعذُّر اختبار حالة
BugreportzOnTestCaseFailureCollector	جمع تقرير أخطاء عند تعذُّر تنفيذ حالة اختبار في إحدى عمليات التشغيل
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` لسحب قياسات تغطية Clang من الجهاز وتسجيلها كعناصر اختبار
CodeCoverageCollector	`BaseDeviceMetricCollector` لسحب قياسات التغطية الأصلية لـ Java و من الجهاز وتسجيلها كعناصر اختبار
CollectingTestListener	`ITestInvocationListener` ستجمع جميع نتائج الاختبار.
CommandStatusHandler	معالِج يساعد في مراقبة حالة طلب الاستدعاء وتعديلها
ConditionFailureMonitor	راقِب أيّ أخطاء من طلب التنفيذ.
ConsoleResultReporter	أداة إعداد التقارير لطباعة نتائج الاختبار في وحدة التحكّم
CountTestCasesCollector	احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ `IRemoteTest` معيّن
DebugHostLogOnFailureCollector	أداة جمع ستجمع السجلات من جهة المضيف وتسجّلها عند حدوث خطأ في نموذج الاختبار.
DeviceReleaseReporter	مُرسِل إصدارات الأجهزة الذي يتعامل مع عملية التواصل مع الوالدَين بشأن الأجهزة التي سيتم إصدارها
DeviceTraceCollector	أداة جمع ستُطلق عملية تتبُّع perfetto عند بدء عملية تشغيل اختبار وتسجيل ملف التتبُّع في النهاية.
DeviceUnavailableMonitor	يحاول هذا المستمع تسجيل بيانات تحليل الأداء على مستوى حالة الاختبار فقط.
EventsLoggerListener	مستمع يسجّل جميع الأحداث التي يتلقّاها في ملف
FileProtoResultReporter	أداة Proto reporter التي تُفرِغ `TestRecord` في ملف
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	أداة تسجيل الملفات التي تم الإبلاغ عنها من جانب الجهاز
FilteredResultForwarder	نوع من `ResultForwarder` لا يسمح إلا بتسجيل قائمة مسموح بها من `TestDescription`.
FormattedGeneratorReporter	أداة إعداد التقارير التي تتيح إنشاء تقارير بتنسيق معيّن
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيستخرج قياسات التغطية من gcov من الجهاز ويُسجّلها كعناصر اختبار
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيسحِب قياسات تغطية ملف kernel باستخدام gcov من debugfs وخارج الجهاز، ثم يسجّلها أخيرًا كعناصر اختبار
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 وتُرسِلها باستخدام POST إلى نقطة نهاية خدمة HTTP
LUCIResultReporter	أداة إعداد تقارير النتائج التي تحفظ نتائج الاختبار التي تحتاجها ResultDB وLUCI بتنسيق JSON (go/result-sink) وتسجِّل موقع الملف في وحدة التحكّم
LastShardDetector	عند تشغيل التجزئة المحلية، نريد أحيانًا تنفيذ بعض الإجراءات فقط عندما تصل الشريحة الأخيرة إلى `invocationEnded(long)`.
LegacySubprocessResultsReporter	تنفيذ مجمّد لبرنامج إعداد تقارير نتائج العملية الفرعية الذي من المفترض أن يظل متوافقًا مع الإصدارات السابقة من TF/CTS (مثل الإصدار 8 والإصدارات الأحدث)، على الرغم من التغييرات في الفئة العليا
LogSaverResultForwarder	`ResultForwarder` لحفظ السجلات باستخدام أداة حفظ الملفات الشاملة
LogcatCrashResultForwarder	مستمع خاص: في حال حدوث أخطاء (تعطُّل عملية أداة القياس)، سيحاول استخراج معلومات عن الأعطال من logcat وإضافتها إلى رسالة الخطأ المرتبطة بالاختبار.
LogcatOnFailureCollector	أداة جمع ستسجّل logcat وتسجيله عند تعذُّر اختبار حالة اختبار.
LogcatTimingMetricCollector	أداة جمع مقاييس تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدّة اختبارات متكرّرة باستخدام أنماط التعبير العادي المحدّدة لتحليل إشارات البدء والنهاية لحدث من أسطر logcat
MetricFilePostProcessor	يُستخدَم لتحميل ملف سجلّ المقاييس الذي تم جمعه أثناء مستوى الاختبار والتشغيل.
MetricsXMLResultReporter	يُسجِّل MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بالمَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.
ModuleListener	مستمع مرفق بكل `IRemoteTest` من كل وحدة من أجل جمع قائمة النتائج
ModuleLogcatCollector	إصدار أداة جمع سجلّات logcat ولكن للوحدة.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج مخصّصة لإعداد تقارير عن النتائج على مستوى الوحدة فقط.
ModuleResultsAndMetricsForwarder	إضافة إلى `ResultAndLogForwarder` تضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.
NameMangleListener	مستمع وكيل لترجمة أسماء طريقة الاختبار والفئة والحزمة عند تسجيل النتائج
PassingTestFileReporter	`ITestInvocationListener` لحفظ قائمة حالات الاختبار التي اجتازت الاختبار في ملف اختبار
PerfettoGenericPostProcessor	وحدة معالجة لاحقة تعالج ملف proto لقياسات النص/الثنائي perfetto إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول التي تحتوي على قيم سلاسل بشكل متكرّر إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه
PrettyTestEventLogger	أداة تسجيل تتطابق مع الأحداث وتسجّلها لتسهيل تصحيح الأخطاء
ProtoResultReporter	ينشئ مُبلِّغ النتائج ملفًا بتنسيق `TestRecord` protobuf يحتوي على جميع النتائج.
PythonBinaryHostTest.PythonForwarder	أداة إعادة توجيه النتائج لاستبدال اسم التشغيل باسم ثنائي
RebootReasonCollector	أداة جمع تجمع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار وتُبلغ عنها حسب السبب والعدد.
RemoteTestTimeOutEnforcer	المستمعون الذين يسمحون بالتحقق من وقت تنفيذ إعداد اختبار معيّن وإخفاقه إذا تجاوز مهلة معيّنة
ReportPassedTests	الإبلاغ في ملف عن الفلاتر المحتمَلة لاستبعاد الاختبار الذي تم اجتيازه
ResultAggregator	إعادة توجيه خاصة تُجمِّع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها
ResultAndLogForwarder	أداة إعادة توجيه للنتائج وأحداث السجلّ
ResultDBReporter
ResultForwarder	`ITestInvocationListener` يعيد توجيه نتائج الاستدعاء إلى قائمة بالمستمعِين الآخرين
RetryLogSaverResultForwarder	شركة إعادة التوجيه التي تتعامل أيضًا مع إتمام المحاولة الحالية التي نحاول إجراؤها
RetryResultForwarder	إضافة `ResultForwarder` يتم دفعها دائمًا إلى عدد محاولات معيّن.
RuntimeRestartCollector	أداة جمع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء التشغيل (أعطال خادم النظام) أثناء تنفيذ الاختبار ، إن وجدت
ScreenshotOnFailureCollector	أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.
ShardListener	`ITestInvocationListener` يجمع النتائج من جزء من طلب التنفيذ (المعروف أيضًا باسم تقسيم طلب التنفيذ لتشغيله على موارد متعددة بشكل متزامن)، ويعيد توجيهها إلى مستمع آخر
ShardMainResultForwarder	`ResultForwarder` يجمع نتائج عمليات استدعاء الاختبار المجزّأ
ShowmapPullerMetricCollector	التنفيذ الأساسي `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه
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` الوحدة