تمت ترجمة هذه الصفحة بواسطة 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 , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , and 72 others.

AggregatePostProcessor	مُجمِّع للمقاييس يعطي الحد الأدنى ، والحد الأقصى ، والمتوسط ، والتباين ، والانحراف المعياري ، والإجمالي ، والعدد ، والنسب المئوية اختياريًا للمقاييس الرقمية التي تم جمعها أثناء عمليات اختبار التكرار المتعدد ، ومعاملتها على أنها مضاعفات.
جامع أتراس	`IMetricCollector` يقوم بتشغيل atrace أثناء الاختبار ويجمع النتيجة ويسجلها في الاستدعاء.
جامع AtraceRunMetric	يجمع التتبع من كل دليل الاختبار ضمن الدليل المحدد من جهاز الاختبار ، ويسجل دليل الاختبار ويعالج ملفات التتبع تحت دليل الاختبار ويجمع المقاييس.
متوسط المعالج	تنفيذ معالج ما بعد الذي يحسب متوسط قائمة المقاييس.
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" لتحديد المقاييس التي تحتوي على حالات اتصال bluetooth في مصفوفة رقمية مثال [0 ، 1 ، 2 ، 3 ، 0 ، 1 ، 2 ، 3].
جامع BluetoothHciSnoopLogCollector	أداة التجميع لتمكين تسجيل التطفل عبر Bluetooth HCI على DUT وتجميع السجل لكل اختبار.
جامع الأخطاء	برنامج `ITestInvocationListener` المار الذي يجمع تقارير الأخطاء عند حدوث أحداث قابلة للتكوين ثم يستدعي `ITestInvocationListener#testLog` على عناصره الفرعية بعد جمع كل تقرير خطأ.
جامع BugreportzOnFailure	اجمع تقرير الأخطاء عند فشل حالة الاختبار.
BugreportzOnTestCaseFailureCollector	اجمع تقرير bugreportz عند فشل حالة الاختبار في التشغيل.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيسحب قياسات تغطية Clang من الجهاز ويسجلها كعناصر اختبار.
CollectingTestListener	برنامج `ITestInvocationListener` الذي سيجمع جميع نتائج الاختبار.
CommandStatusHandler	معالج يساعد في مراقبة حالة الاستدعاء وتحديثها.
حالة الفشل مراقب	مراقبة أي فشل من الاحتجاج.
ConsoleResultReporter	نتيجة مراسل لطباعة نتائج الاختبار على وحدة التحكم.
CountTestCasesCollector	قم بحساب عدد حالات الاختبار الخاصة باختبار `IRemoteTest` المحدد والإبلاغ عنها.
DebugHostLogOnFailureCollector	المُجمع الذي سيقوم بجمع وتسجيل سجلات جانب المضيف عند حدوث فشل في حالة الاختبار.
DeviceReleaseReporter	يقوم مراسل إصدار الجهاز الذي يتعامل مع التواصل مع الوالد بمعالجة الجهاز (الأجهزة) الذي سيتم إصداره.
DeviceTraceCollector	المُجمع الذي سيبدأ تتبع perfetto عند بدء تشغيل اختباري وتسجيل ملف التتبع في النهاية.
DeviceUnavailableMonitor	يحاول هذا المستمع التقاط مستوى حالة الاختبار DNAE فقط.
الأحداث	مستمع يقوم بتسجيل جميع الأحداث التي يتلقاها في ملف
FileProtoResultReporter	مراسل أولي يقوم بتفريغ `TestRecord` في ملف.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` الذي يستمع لمفتاح المقاييس القادم من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	مسجل الملف المبلغ عنه من جانب الجهاز.
FilteredResultForwarder	متغير `ResultForwarder` الذي يسمح فقط بالإبلاغ عن قائمة المسموح بها من `TestDescription` .
FormattedGeneratorReporter	المراسل الذي يسمح بإنشاء التقارير بتنسيق معين.
جامع GcovCodeCoverage	`BaseDeviceMetricCollector` الذي سيسحب قياسات تغطية gcov من الجهاز ويسجلها كعناصر اختبار.
جامع GcovKernelCodeCodeCoverage	`BaseDeviceMetricCollector` الذي سيسحب قياسات تغطية gcov kernel من debugfs وإخراجها من الجهاز ثم يسجلها أخيرًا كعناصر اختبار.
محبب قابل للاسترداد	مساعد الفصل للقبض على البداية والنهاية المفقودة.
HostStatsdMetricCollector	`IMetricCollector` يجمع مقاييس statsd من جانب المضيف باستخدام أوامر الأداة المساعدة statsd.
ICommandScheduler.IScheduledInvocationListener	مستمع لأحداث الاحتجاج عند اكتمال الاستدعاء.
ILogSaverListener	يسمح لـ `ITestInvocationListener` بالاستماع إليه عند حفظ ملفات السجل.
جامع متري	ستتم إضافة هذه الواجهة كديكور عند الإبلاغ عن نتائج الاختبارات من أجل جمع المقاييس المتطابقة.
معالج IPost	المعالجات اللاحقة هي أحد عناصر الاتحاد التجاري التي تهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل الإبلاغ عن النتائج.
قابل للاستماع	برنامج `ITestInvocationListener` الذي يمكن تقسيمه.
ISupportGranular النتائج	واجهة تحدد ما إذا كان `ITestInvocationListener` يدعم تلقي النتائج الدقيقة أم لا.
ITestSummaryListener	واجهة تسمح لـ `ITestInvocationListener` بتبادل بعض المعلومات المحدودة عبر الملخصات.
InvocationToJUnitResultForwarder	فئة تستمع إلى أحداث `ITestInvocationListener` وتقوم بإعادة توجيهها إلى `TestListener` .
JarHostTest.HostTestListener	مستمع الغلاف الذي يعيد توجيه جميع الأحداث باستثناء testRunStarted () و testRunEnded () إلى المستمع المضمن.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيسحب قياسات تغطية Java من الجهاز ويسجلها كعناصر اختبار.
JsonHttpTestResultReporter	مراسل النتائج الذي يقوم بترميز نتائج مقاييس الاختبار والفرع ومعلومات الجهاز في JSON و POST في نقطة نهاية خدمة HTTP
LastShardDetector	عند تشغيل التجزئة المحلية ، في بعض الأحيان نريد فقط تنفيذ بعض الإجراءات عندما يصل الجزء الأخير إلى `invocationEnded(long)` .
LegacySubprocessResultsReporter	تنفيذ مجمّد لمراسل نتائج العملية الفرعية والذي يجب أن يظل متوافقًا مع الإصدارات السابقة من TF / CTS (على سبيل المثال 8+) ، على الرغم من التغييرات في فئته الفائقة.
LogSaverResultForwarder	A `ResultForwarder` لحفظ السجلات مع ملف التوقف العام.
LogcatCrashResultForwarder	مستمع خاص: عند الإخفاقات (تعطل عملية الأجهزة) ، سيحاول استخراج العطل من logcat وإضافته إلى رسالة الفشل المرتبطة بالاختبار.
جامع LogcatOnFailure	المُجمع الذي سيقوم بالتقاط وتسجيل logcat عند فشل حالة الاختبار.
LogcatTimingMetricCollector	أداة تجميع المقاييس التي تجمع معلومات التوقيت (مثل وقت تبديل المستخدم) من logcat أثناء اختبار واحد أو عدة اختبارات متكررة باستخدام أنماط regex معينة لتحليل إشارات البداية والنهاية لحدث ما من خطوط logcat.
MetricFilePostProcessor	يستخدم لتحميل ملف سجل المقاييس الذي تم جمعه أثناء الاختبار والتشغيل.
MetricsXMLResultReporter	يكتب MetricsXMLResultReporter مقاييس الاختبار وتشغيل المقاييس إلى ملف XML في مجلد محدد بواسطة معلمة مجلد المقاييس في مرحلة الاستدعاء المنتهية من الاختبار.
وحدة الاستماع	يتم إرفاق المستمع بكل `IRemoteTest` لكل وحدة من أجل تجميع قائمة النتائج.
الوحدة النمطية LogcatCollector	إصدار جامع logcat لكن للوحدة النمطية.
NameMangleListener	مستمع وكيل لترجمة طريقة الاختبار والفئة وأسماء الحزم عند الإبلاغ عن النتائج.
PassingTestFileReporter	برنامج `ITestInvocationListener` الذي يحفظ قائمة حالات اجتياز الاختبار في ملف اختبار
PerfettoGenericPostProcessor	معالج لاحق يقوم بمعالجة ملف نصي / ثنائي متري perfetto proto إلى أزواج ذات قيمة رئيسية عن طريق توسيع متكرر للرسائل الأولية والحقول بقيم سلسلة حتى يتم العثور على الحقل ذي القيمة الرقمية.
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات perfetto من الجهاز وجمع المقاييس منه.
PrettyTestEventLogger	يقوم المسجل بمطابقة الأحداث وتسجيلها لتسهيل تصحيح الأخطاء.
ProtoResultReporter	بناء المراسل نتيجة اختبار `TestRecord` protobuf مع جميع النتائج في الداخل.
PythonBinaryHostTest.PythonForwarder	يؤدي معيد التوجيه إلى استبدال اسم التشغيل بالاسم الثنائي.
RebootReasonCollector	أداة التجميع التي تجمع إعادة تشغيل الجهاز أثناء التشغيل التجريبي والإبلاغ عنها حسب السبب والأهم.
RemoteTestTimeOutEnforcer	المستمعون الذين يسمحون بالتحقق من وقت تنفيذ اختبار معين وفشل في ذلك إذا تجاوزت مهلة معينة.
ReportPassedTests	قم بالإبلاغ في ملف عن عوامل التصفية الممكنة لاستبعاد الاختبار الذي تم اجتيازه.
النتيجة المجمّع	معيد توجيه خاص يقوم بتجميع النتائج عند الحاجة ، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها.
ResultAndLogForwarder	معيد التوجيه للنتائج وسجلات الأحداث.
النتيجة	برنامج `ITestInvocationListener` الذي يعيد توجيه نتائج الاستدعاء إلى قائمة المستمعين الآخرين.
RetryLogSaverResultForwarder	معيد التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن عليها.
RetryResultForwarder	امتداد `ResultForwarder` الذي يدفع دائمًا إلى رقم محاولة معين.
وقت التشغيل	المُجمع الذي يجمع الطوابع الزمنية لإعادة تشغيل وقت التشغيل (تعطل خادم النظام) أثناء التشغيل التجريبي ، إن وجد.
لقطة شاشة OnFailureCollector	المُجمع الذي سيقوم بالتقاط وتسجيل لقطة شاشة عند فشل حالة الاختبار.
مستمع شارد	برنامج `ITestInvocationListener` الذي يجمع النتائج من جزء الاستدعاء (ويعرف أيضًا باسم تقسيم الاستدعاء ليتم تشغيله على موارد متعددة بشكل متوازٍ) ، ويعيد توجيهها إلى مستمع آخر.
ShardMainResultForwarder	A `ResultForwarder` الذي يجمع نتائج استدعاءات اختبار مجزأة.
ShowmapPullerMetricCollector. العرض	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب ملفات showmap من الجهاز وجمع المقاييس منه.
StatsdBeforeAfterGaugeMetricPostProcessor	معالج ما بعد الذي يعالج مقاييس القياس التي تم جمعها في نهج "قبل / بعد" ، على سبيل المثال
StatsdEventMetricPostProcessor	معالج ما بعد الذي يعالج مقاييس الأحداث في تقارير الإحصائيات إلى أزواج ذات قيمة رئيسية ، باستخدام المُنسِّقات المحددة في المعالج.
StatsdGenericPostProcessor	معالج ما بعد الذي يعالج تقارير statsd الثنائية الأولية إلى أزواج ذات قيمة رئيسية من خلال توسيع التقرير كهيكل شجرة.
StreamProtoResultReporter	تنفيذ `ProtoResultReporter`
نتائج العملية الفرعية	يتم تحديد تطبيق `ITestInvocationListener` باعتباره result_reporter وإعادة توجيه نتائج الاختبارات وتشغيل الاختبار واستدعاءات الاختبار من العملية الفرعية.
SuiteResultReporter	جمع نتائج الاختبار لاستدعاء مجموعة كاملة وإخراج النتائج النهائية.
TestFailureListener	يستخدم المستمع لاتخاذ إجراءات مثل لقطة الشاشة ، وتقرير الأخطاء ، وجمع logcat عند فشل الاختبار عند الطلب.
TestTimeoutEnforcer	المستمعون الذين يسمحون بالتحقق من وقت تنفيذ حالة اختبار معينة وفشلها إذا تجاوزت مهلة معينة.
TextResultReporter	مراسل نتائج الاختبار الذي يعيد توجيه النتائج إلى طابعة نتائج النص JUnit.
TraceCmdCollector	`IMetricCollector` يقوم بتجميع التتبع أثناء الاختبار باستخدام trace-cmd ، ويسجلها في الاستدعاء.
TradefedSandboxRunner.StubScheduledInvocationListener	كعب `IScheduledInvocationListener` لا يفعل شيئًا.
XmlFormattedGeneratorReporter	ينتج عن تنفيذ `FormattedGeneratorReporter` الذي يقوم بتنسيق المجموعة تنسيق xml.
XmlResultReporter	يكتب نتائج JUnit إلى ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter الخاص بـ Ant.

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

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

بدء الاحتجاج (BuildInfo)
testRunStarted
اختبار
[فشل الاختبار]
انتهى الاختبار
...
انتهى الاختبار
...
testRunStarted
...
انتهى الاختبار
[فشل الاحتجاج]
[testLog +]
انتهى الدعاء
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`	A `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` : سبب `ERROR(/Throwable)` للفشل

دعاء منقطع

public void invocationInterrupted ()

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

بدأ الاحتجاج

public void invocationStarted (IInvocationContext context)

يُبلغ عن بدء استدعاء الاختبار.

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

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

انتهى الاختبار

public void testModuleEnded ()

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

testModule بدأ

public void testModuleStarted (IInvocationContext moduleContext)

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

حدود
`moduleContext`	`IInvocationContext` : `IInvocationContext` للوحدة النمطية.