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 و81 غيرها 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 إلى الأجهزة، وسيجمع مدة اتصال البلوتوث لكل ملف شخصي.  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 معيّن وإعداد تقرير عنه  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 ومن الجهاز، ثم يسجّلها أخيرًا كعناصر اختبار.  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 أثناء إجراء اختبار واحد أو أكثر من الاختبارات المتكرّرة باستخدام أنماط regex المحدّدة لتحليل إشارات البدء والانتهاء لحدث من أسطر logcat.  MetricFilePostProcessor يُستخدَم لتحميل ملف سجلّ المقاييس الذي تمّ جمعه أثناء الاختبار وعلى مستوى التشغيل.  MetricsXMLResultReporter تكتب أداة MetricsXMLResultReporter مقاييس الاختبار ومقاييس التشغيل في ملف XML في مجلد محدّد بواسطة المَعلمة metrics-folder في مرحلة invocationEnded من الاختبار.  ModuleListener يتم ربط أداة معالجة الأحداث بكل IRemoteTest في كل وحدة من أجل جمع قائمة النتائج.  ModuleLogcatCollector إصدار أداة جمع logcat ولكن للوحدة.  ModuleProtoResultReporter أداة إعداد تقارير النتائج التي تهدف إلى إعداد تقارير عن النتائج على مستوى الوحدة فقط.  ModuleResultsAndMetricsForwarder هي امتداد لـ ResultAndLogForwarder يضيف مقاييس إضافية ذات صلة بالوحدة إلى نتائج الاختبار.  NameMangleListener أداة معالجة وكيل لترجمة أسماء طرق الاختبار والفئات والحِزم عند الإبلاغ عن النتائج.  PassingTestFileReporter ITestInvocationListener يحفظ قائمة بحالات الاختبار الناجحة في ملف اختبار  PerfettoFilePullerCollector أداة تجميع تسحب ملفات تتبُّع Perfetto من الجهاز، وتضغطها اختياريًا، وتضيفها إلى سجلّات الاختبار.  PerfettoGenericPostProcessor معالج لاحق يعالج ملف perfetto 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 أداة تجميع تجمع الطوابع الزمنية لعمليات إعادة التشغيل أثناء وقت التشغيل (تعطُّل خادم النظام) أثناء تنفيذ الاختبار، إن وُجدت.  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 الوحدة.