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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

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

AggregatePostProcessor ، AtraceCollector ، AtraceRunMetricCollector ، AveragePostProcessor ، BaseDeviceMetricCollector ، BasePostProcessor ، BluetoothConnectionLatencyCollector ، BluetoothConnectionStateCollector ، BluetoothConnectionSuccessRatePostProcessor ، BluetoothHciSnoopLogCollector ، BugreportCollector ، BugreportzOnFailure Collector و BugreportzOnTestCaseFailureCollector و ClangCodeCoverageCollector و CollectingTestListener و 73 آخرين.

AggregatePostProcessor	مجمع متري يعطي الحد الأدنى والحد الأقصى والمتوسط والتباين والانحراف المعياري والإجمالي والعدد والنسب المئوية الاختيارية للمقاييس الرقمية التي تم جمعها أثناء تشغيل اختبار التكرار المتعدد، ومعاملتها على أنها مضاعفات.
AtraceCollector	`IMetricCollector` الذي يقوم بتشغيل التتبع أثناء الاختبار ويجمع النتيجة ويسجلها في الاستدعاء.
AtraceRunMetricCollector	يجمع الآثار من كل دليل الاختبار ضمن الدليل المحدد من جهاز الاختبار، ويسجل دليل الاختبار ويعالج ملفات التتبع ضمن دليل الاختبار ويجمع المقاييس.
متوسط ما بعد المعالج	تنفيذ المعالج اللاحق الذي يحسب متوسط قائمة المقاييس.
BaseDeviceMetricCollector	التنفيذ الأساسي لـ `IMetricCollector` الذي يسمح ببدء وإيقاف التجميع على `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` .
BasePostProcessor	`IPostProcessor` الأساسي الذي يجب أن يمتد كل تطبيق.
BluetoothConnectionLatencyCollector	سيقوم المجمع بإرسال تكوين قياس مدة الإحصائيات المحدد مسبقًا إلى الأجهزة وجمع مدة اتصال Bluetooth لكل ملف تعريف.
BluetoothConnectionStateCollector	سيقوم هذا المجمع بجمع مقاييس BluetoothConnectionStateChanged وتسجيل رقم حالة الاتصال لكل ملف تعريف.
BluetoothConnectionSuccessRatePostProcessor	تنفيذ المعالج اللاحق الذي يحسب معدل النجاح لملف تعريف البلوتوث استخدم "مطابقة المفتاح المتري" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث في مصفوفة رقمية مثال [0، 1، 2، 3، 0، 1، 2، 3].
BluetoothHciSnoopLogCollector	Collector لتمكين تسجيل الدخول عبر Bluetooth HCI على DUT وجمع السجل لكل اختبار.
BugreportCollector	`ITestInvocationListener` تمريري يقوم بتجميع تقارير الأخطاء عند حدوث أحداث قابلة للتكوين ثم يقوم باستدعاء `ITestInvocationListener#testLog` على أبنائه بعد جمع كل تقرير خطأ.
BugreportzOnFailureCollector	قم بتجميع تقرير الأخطاء عند فشل حالة الاختبار.
BugreportzOnTestCaseFailureCollector	قم بتجميع تقرير الأخطاء عند فشل حالة الاختبار أثناء التشغيل.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيقوم بسحب قياسات تغطية Clang من الجهاز وتسجيلها كأدوات اختبار.
com.collectingTestListener	`ITestInvocationListener` الذي سيجمع كل نتائج الاختبار.
CommandStatusHandler	يساعد المعالج في مراقبة حالة الاستدعاء وتحديثها.
ConditionFailureMonitor	مراقبة أي فشل من الاستدعاء.
ConsoleResultReporter	مراسل النتيجة لطباعة نتائج الاختبار إلى وحدة التحكم.
CountTestCasesCollector	قم بإحصاء عدد حالات الاختبار الخاصة بـ `IRemoteTest` والإبلاغ عنها.
DebugHostLogOnFailureCollector	Collector الذي سيقوم بجمع وتسجيل سجلات الجانب المضيف عند حدوث فشل في حالة الاختبار.
DeviceReleaseReporter	مراسل إصدار الجهاز الذي يتولى التواصل مع الشركة الأم يقوم بمعالجة الجهاز (الأجهزة) التي سيتم إصدارها.
DeviceTraceCollector	المجمع الذي سيبدأ تتبع perfetto عند بدء التشغيل التجريبي وتسجيل ملف التتبع في النهاية.
جهاز غير متاح مراقب	يحاول هذا المستمع التقاط مستوى حالة اختبار DNAE فقط.
EventsLoggerListener	المستمع الذي يسجل كافة الأحداث التي يتلقاها في ملف
FileProtoResultReporter	مراسل Proto الذي يقوم بتفريغ `TestRecord` في ملف.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` الذي يستمع لمفتاح المقاييس القادمة من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	مسجل الملف الذي أبلغ عنه من جانب الجهاز.
FilterResultForwarder	متغير `ResultForwarder` الذي يسمح فقط بالإبلاغ عن القائمة المسموح بها لـ `TestDescription` .
FormattedGeneratorReporter	مراسل يسمح بإنشاء تقارير بتنسيق معين.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيقوم بسحب قياسات تغطية gcov من الجهاز وتسجيلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيقوم بسحب قياسات تغطية kernel gcov من تصحيحات الأخطاء ومن الجهاز، ثم يقوم في النهاية بتسجيلها كعناصر اختبار.
GranularRetriableTestWrapper.StartEndCollector	مساعد الفصل للقبض على بداية ونهاية المدى المفقود.
HostStatsdMetricCollector	`IMetricCollector` الذي يجمع مقاييس statsd من جانب المضيف باستخدام أوامر الأداة المساعدة statsd.
ICommandScheduler.IScheduledInvocationListener	مستمع لأحداث الاستدعاء عند اكتمال الاستدعاء.
ILogSaverListener	يسمح لـ `ITestInvocationListener` بالاستماع إلى وقت حفظ ملفات السجل.
IMetricCollector	ستتم إضافة هذه الواجهة كديكور عند الإبلاغ عن نتائج الاختبارات من أجل جمع المقاييس المطابقة.
IPostProcessor	تعد معالجات النشر أحد كائنات الاتحاد التجاري التي تهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل الإبلاغ عن النتائج.
IShardableListener	`ITestInvocationListener` الذي يمكن تقسيمه.
ISupportGranularResults	واجهة تحدد ما إذا كان `ITestInvocationListener` يدعم تلقي النتائج الدقيقة أم لا.
ITestSummaryListener	واجهة تسمح لـ `ITestInvocationListener` بتبادل بعض المعلومات المحدودة عبر الملخصات.
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 أثناء اختبار واحد أو عدة اختبارات متكررة باستخدام أنماط regex معينة لتحليل إشارات البداية والنهاية لحدث من خطوط logcat.
MetricFilePostProcessor	يُستخدم لتحميل ملف سجل المقاييس الذي تم جمعه أثناء مستوى الاختبار والتشغيل.
MetricsXMLResultReporter	يقوم MetricsXMLResultReporter بكتابة مقاييس الاختبار وتشغيل المقاييس إلى ملف XML في مجلد محدد بواسطة معلمة مجلد المقاييس في مرحلة الاستدعاء المنتهية للاختبار.
ModuleListener	يتم إرفاق المستمع بكل `IRemoteTest` لكل وحدة من أجل جمع قائمة النتائج.
ModuleLogcatCollector	إصدار جامع logcat ولكن للوحدة النمطية.
NameMangleListener	مستمع وكيل لترجمة طريقة الاختبار والفئات وأسماء الحزم عند الإبلاغ عن النتائج.
PassingTestFileReporter	`ITestInvocationListener` الذي يحفظ قائمة حالات الاختبار التي تم تمريرها إلى ملف اختبار
PerfettoGenericPostProcessor	معالج نشر يقوم بمعالجة ملف perfetto proto النصي/الثنائي المتري إلى أزواج قيمة المفتاح عن طريق توسيع الرسائل الأولية والحقول ذات قيم السلسلة بشكل متكرر حتى تتم مواجهة الحقل ذو القيمة الرقمية.
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه.
PrettyTestEventLogger	يقوم المسجل بمطابقة الأحداث وتسجيلها لتسهيل تصحيح الأخطاء.
ProtoResultReporter	يقوم مراسل النتائج ببناء نموذج `TestRecord` مع جميع النتائج بداخله.
PythonBinaryHostTest.PythonForwarder	معيد توجيه النتيجة لاستبدال اسم التشغيل بالاسم الثنائي.
RebootReasonCollector	المجمع الذي يجمع عمليات إعادة تشغيل الجهاز أثناء التشغيل التجريبي والإبلاغ عنها حسب الأسباب والأعداد.
RemoteTestTimeOutEnforcer	المستمعون الذين يسمحون بالتحقق من وقت تنفيذ تكوين اختبار معين وفشله إذا تجاوز مهلة معينة.
تقرير الاختبارات الناجحة	قم بالإبلاغ في ملف عن المرشحات المحتملة لاستبعاد الاختبار الذي تم اجتيازه.
مجمع النتائج	معيد توجيه خاص يقوم بتجميع النتائج عند الحاجة، بناءً على استراتيجية إعادة المحاولة التي تم اتخاذها.
ResultAndLogForwarder	معيد التوجيه للنتائج وسجلات الأحداث.
ResultForwarder	`ITestInvocationListener` الذي يعيد توجيه نتائج الاستدعاء إلى قائمة المستمعين الآخرين.
RetryLogSaverResultForwarder	وكيل الشحن الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن فيها.
إعادة المحاولةResultForwarder	امتداد `ResultForwarder` الذي يدفع دائمًا إلى رقم محاولة معين.
RuntimeRestartCollector	Collector الذي يجمع الطوابع الزمنية لعمليات إعادة تشغيل وقت التشغيل (تعطل خادم النظام) أثناء التشغيل التجريبي، إن وجد.
لقطة شاشة OnFailureCollector	Collector الذي سيقوم بالتقاط لقطة شاشة وتسجيلها عند فشل حالة الاختبار.
ShardListener	`ITestInvocationListener` الذي يجمع النتائج من جزء الاستدعاء (المعروف أيضًا باسم تقسيم الاستدعاء للتشغيل على موارد متعددة بالتوازي)، ويعيد توجيهها إلى مستمع آخر.
ShardMainResultForwarder	`ResultForwarder` الذي يجمع نتائج استدعاءات الاختبار المجزأة.
ShowmapPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه.
StatsdBeforeAfterGaugeMetricPostProcessor	معالج ما بعد يقوم بمعالجة مقاييس القياس المجمعة بطريقة "قبل/بعد"، أي
StatsdEventMetricPostProcessor	معالج ما بعد يقوم بمعالجة مقاييس الأحداث في تقارير statsd إلى أزواج قيمة المفتاح، باستخدام التنسيقات المحددة في المعالج.
StatsdGenericPostProcessor	معالج ما بعد يقوم بمعالجة تقارير الإحصائيات الأولية الثنائية إلى أزواج ذات قيمة أساسية عن طريق توسيع التقرير كبنية شجرة.
StreamProtoResultReporter	تنفيذ `ProtoResultReporter`
تقرير نتائج العمليات الفرعية	ينفذ `ITestInvocationListener` ليتم تحديده كنتيجة_reporter وإعادة توجيه نتائج الاختبارات وعمليات التشغيل الاختبارية واستدعاءات الاختبار من العملية الفرعية.
تقرير نتائج سويت	جمع نتائج الاختبار لاستدعاء مجموعة كاملة وإخراج النتائج النهائية.
TestFailureListener	اعتاد المستمع على اتخاذ إجراءات مثل لقطة الشاشة وتقرير الأخطاء وجمع السجل عند فشل الاختبار عند الطلب.
TestTimeoutEnforcer	المستمعون الذين يسمحون بالتحقق من وقت تنفيذ حالة اختبار معينة والفشل فيها إذا تجاوزت مهلة معينة.
TextResultReporter	مراسل نتائج الاختبار الذي يقوم بإعادة توجيه النتائج إلى طابعة نتائج النص JUnit.
TraceCmdCollector	`IMetricCollector` الذي يجمع التتبعات أثناء الاختبار باستخدام Trace-cmd، ويسجلها في الاستدعاء.
TradefedSandboxRunner.StubScheduledInvocationListener	كعب روتين `IScheduledInvocationListener` الذي لا يفعل شيئًا.
XmlFormattedGeneratorReporter	يؤدي تنفيذ `FormattedGeneratorReporter` الذي يقوم بتنسيق المجموعة إلى ظهور تنسيق xml.
XmlResultReporter	يكتب نتائج JUnit إلى ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter الخاص بـ Ant.

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

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

بدأ الاستدعاء (معلومات البناء)
testRunStarted
testStarted
[فشل الاختبار]
انتهى الاختبار
...
testRunEnded
...
testRunStarted
...
testRunEnded
[فشل الاستدعاء]
[سجل الاختبار+]
انتهت الدعوة
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`	`invocationStarted ( IInvocationContext context)` تقارير بداية استدعاء الاختبار.
`default void`	`testModuleEnded ()` تقارير نهاية تشغيل الوحدة النمطية.
`default void`	`testModuleStarted ( IInvocationContext moduleContext)` يُبلغ عن بداية تشغيل الوحدة النمطية.

الأساليب العامة

getSummary

public TestSummary getSummary ()

يسمح لـ InvocationListener بإرجاع ملخص.

عائدات
`TestSummary`	`TestSummary` يلخص التشغيل، أو فارغ

انتهت الدعوة

public void invocationEnded (long elapsedTime)

تقارير تفيد بأن الاستدعاء قد تم إنهاؤه، سواء بنجاح أو بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

حدود
`elapsedTime`	`long` : الوقت المنقضي للاستدعاء في مللي ثانية

فشل الاستدعاء

public void invocationFailed (FailureDescription failure)

يُبلغ عن استدعاء غير مكتمل بسبب بعض حالات الخطأ.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

حدود
`failure`	`FailureDescription` : `FailureDescription` الذي يصف سبب الفشل

فشل الاستدعاء

public void invocationFailed (Throwable cause)

يُبلغ عن استدعاء غير مكتمل بسبب بعض حالات الخطأ.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

حدود
`cause`	`Throwable` : السبب `Throwable` للفشل

invocationInterrupted

public void invocationInterrupted ()

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

invocationStarted

public void invocationStarted (IInvocationContext context)

تقارير بداية استدعاء الاختبار.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم التقارير على أجهزة متعددة.

حدود
`context`	`IInvocationContext` : معلومات حول الاستدعاء

testModuleEnded

public void testModuleEnded ()

تقارير نهاية تشغيل الوحدة النمطية.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

حدود
`moduleContext`	`IInvocationContext` : `IInvocationContext` للوحدة.