تمت ترجمة هذه الصفحة بواسطة 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 وCollectingTestListener و74 عنصرًا آخر

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	سيُرسِل المجمِّع إعدادات مقياس مدّة 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 من الجهاز وتُسجّلها كعناصر اختبار
CollectingTestListener	تمثّل هذه السمة `ITestInvocationListener` الذي سيجمع كل نتائج الاختبارات.
CommandStatusHandler	معالِج يساعد في مراقبة حالة طلب الاستدعاء وتعديلها
ConditionFailureMonitor	راقِب أي أخطاء بسبب الاستدعاء.
ConsoleResultReporter	أداة الإبلاغ عن النتائج لطباعة نتائج الاختبار في وحدة التحكّم.
CountTestCasesCollector	احتساب عدد حالات الاختبار وإعداد تقارير عنها لـ `IRemoteTest` معيّن
DebugHostLogOnFailureCollector	المجمِّع الذي سيجمع السجلات من جهة المضيف ويسجِّلها عند حدوث فشل في حالة الاختبار.
DeviceReleaseReporter	مُرسِل إصدارات الأجهزة الذي يتعامل مع عملية التواصل مع الوالدَين بشأن الأجهزة التي سيتم طرحها
DeviceTraceCollector	أداة جمع ستُطلق عملية تتبُّع perfetto عند بدء عملية تشغيل الاختبار وستسجِّل ملف تتبُّع في النهاية.
DeviceUnavailableMonitor	يحاول هذا المستمع تسجيل اسم DNAE على مستوى حالة الاختبار فقط.
eventsLoggerListener	أداة معالجة الحدث التي تسجّل جميع الأحداث التي تتلقّاها في ملف
FileProtoResultReporter	مُبلِّغ Proto الذي يملأ `TestRecord` في ملف.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` يستمع إلى مفتاح المقاييس الواردة من الجهاز ويسحبها كملف من الجهاز.
FilePullerLogCollector	سجلّ الملف الذي تم الإبلاغ عنه من جانب الجهاز.
FilteredResultForwarder	نوع من `ResultForwarder` يسمح فقط بتسجيل قائمة مسموح بها من `TestDescription`.
FormattedGeneratorReporter	جهة الإبلاغ التي تسمح بإنشاء التقارير بتنسيق معيّن.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` الذي يسحب gcov قياسات التغطية خارج الجهاز وتسجيلها كعناصر اختبار.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` الذي سيسحب نواة gcov قياسات التغطية من برامج تصحيح الأخطاء وخارجها، ثم تسجِّلها في النهاية كاختبار والأدوات.
GranularRetriableTestWrapper.StartEndCollector	مساعد فئة لرصد بداية ونهاية التشغيل غير المتوفّرة
HostStatsdMetricCollector	`IMetricCollector` تجمع مقاييس statsd من جهة المضيف باستخدام أوامر أداة statsd.
ICommandscheduler.IscheduleInvocationListener	أداة الاستماع لأحداث الاستدعاء عند اكتمال الاستدعاء
ILogSaverListener	السماح لتطبيقات `ITestInvocationListener` بالاستماع إلى وقت حفظ ملفات السجلّ
IMetricCollector	ستتم إضافة هذه الواجهة كمصمم عند إعداد تقارير عن نتائج الاختبارات بهدف جمع ومقاييس المطابقة.
IPostProcessor	معالجات ما بعد المعالجة هي عناصر في Trade Federation تهدف إلى السماح بمعالجة المقاييس والسجلات بعد الاختبارات وقبل إعداد تقارير النتائج.
IShardableListener	`ITestInvocationListener` يمكن تجزئةه.
ISupportGranularResults	واجهة تحدِّد ما إذا كان `ITestInvocationListener` يتيح تلقّي البيانات الدقيقة نتائج البحث أم لا.
ITestSummaryListener	واجهة تسمح `ITestInvocationListener` بتبادل بعض المعلومات المحدودة من خلال ملفّات المشروعات الملخّصة
InvocationToJUnitResultResulter	فئة تستمع إلى أحداث `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-مجلد في مرحلة الاستدعاء "منتهية" من الاختبار.
ModuleListener	مستمع مرفق بكل `IRemoteTest` من كل وحدة من أجل جمع قائمة النتائج
ModuleLogcatCollector	إصدار أداة جمع سجلّات logcat ولكن للوحدة.
ModuleProtoResultReporter	أداة إعداد تقارير النتائج مخصّصة لإعداد تقارير عن النتائج على مستوى الوحدة فقط.
NameMangleListener	أداة استماع خادم وكيل لترجمة أسماء طرق الاختبار والفئة والحِزم عند الإبلاغ عن النتائج
PassingTestFileReporter	`ITestInvocationListener` لحفظ قائمة حالات الاختبار التي اجتازت الاختبار في ملف اختبار
PerfettoGenericPostProcessor	وحدة معالجة لاحقة تعالج ملف proto لقياسات النص/الثنائية في perfetto إلى أزواج مفتاح/قيمة من خلال توسيع رسائل proto والحقول التي تحتوي على قيم سلاسل بشكل متكرر إلى أن يتم العثور على الحقل الذي يحتوي على قيمة رقمية.
PerfettoPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح سحب ملفات الأداء من الجهاز وجمع المقاييس منه.
PrettyTestEventLogger	أداة تسجيل تطابق الأحداث وتسجيلها لتسهيل تصحيح الأخطاء
ProtoResultReporter	أنشأ الشخص الذي أبلغ عن النتائج نموذجًا أوّليًا لـ `TestRecord` يحتوي على جميع النتائج بداخلها.
PythonBinaryHostTest.Pythonforwarder	أداة إعادة توجيه النتائج لاستبدال اسم التشغيل باسم ثنائي
RewreasonCollector	يجمع هذا المجمِّع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار ويبلِّغ عنها حسب السبب والعدد.
RemoteTestTimeOutSpendr	أدوات معالجة الموسيقى التي تسمح بالتحقق من وقت تنفيذ تهيئة اختبار معينة وتفشل في حال استمرارها خلال مهلة محددة
ReportPassedTests	إعداد تقرير في ملف الفلاتر المحتملة لاستبعاد الاختبار الذي تم اجتيازه.
أداة تجميع النتائج	إعادة توجيه خاصة تجمع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم التقاطها.
ResultAndLogforwarder	أداة إعادة توجيه للنتائج وأحداث السجلّ
أداة إعادة توجيه النتائج	نوع `ITestInvocationListener` يعيد توجيه نتائج الاستدعاء إلى قائمة بالمستمعين الآخرين
verifyLogSaverResultforwarder	مسؤول إعادة التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن بصددها.
RetryResultForwarder	إضافة للسمة `ResultForwarder` والتي يتم إرسالها دائمًا إلى رقم محاولة معيّن.
RuntimeRestartCollector	أداة التجميع التي تجمع الطوابع الزمنية لعمليات إعادة التشغيل في وقت التشغيل (أعطال خادم النظام) أثناء الاختبار التشغيل، إن وجدت.
ScreenshotOnFailureCollector	أداة جمع ستلتقط لقطة شاشة وتسجّلها عند تعذُّر تنفيذ حالة اختبار.
ShardListener	إنّ `ITestInvocationListener` الذي يجمع النتائج من جزء الاستدعاء (المعروف أيضًا باسم تقسيم الاستدعاء ليتم تشغيله على عدة موارد بالتوازي) وإعادة توجيهها إلى موارد أخرى المستمع.
ShardMainResultForwarder	تمثّل هذه السمة `ResultForwarder` يجمع بين نتائج استدعاءات الاختبار المقسّمة.
ShowmapPullerMetricCollector	التنفيذ الأساسي لـ `FilePullerDeviceMetricCollector` الذي يسمح بسحب خريطة العرض من الجهاز وجمع المقاييس منه.
StatsdBeforeafterGaugeMetricPostProcessor	معالج لاحق يعالج مقاييس القياس التي يتم جمعها باستخدام أسلوب "قبل/بعد"، أي
StatsdEventMetricPostProcessor	وحدة معالجة لاحقة تعالج مقاييس الأحداث في تقارير statsd إلى أزواج مفتاح/قيمة، باستخدام تنسيقات المحدّدة في وحدة المعالجة
StatsdGenericPostProcessor	وحدة معالجة لاحقة تعالج تقارير statsd الثنائية إلى أزواج مفتاح/قيمة من خلال توسيع التقرير كبنية شجرة
StreamProtoResultReporter	تنفيذ `ProtoResultReporter`
SubprocessResultsReporter	تنفيذ `ITestInvocationListener` الذي سيتم تحديده على هيئة results_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]
انتهى الاختبار
...
اختبار RunEnded
...
testRunStarted
...
اختبار RunEnded
[فشل الاستدعاء]
[testLog+]
تم إنهاء الاستدعاء
الحصول على الملخص

ملخّص

الطرق العامة
`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`: الوقت المنقضي للاستدعاء بالملي ثانية

تعذّر الاستدعاء

public void invocationFailed (FailureDescription failure)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

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

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

invocationFailed

public void invocationFailed (Throwable cause)

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

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

المعلمات
`cause`	`Throwable`: السبب `Throwable` للتعذُّر

invocationInterrupted

public void invocationInterrupted ()

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

تم تخطّي الاستدعاء

public void invocationSkipped (SkipReason reason)

يتم الإبلاغ عن استدعاء على أنّه تم تخطّيه.

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

testModuleEnded

public void testModuleEnded ()

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

تم بدء الاختبار

public void testModuleStarted (IInvocationContext moduleContext)

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

المعلمات
`moduleContext`	`IInvocationContext`: السمة `IInvocationContext` في الوحدة