أداة ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

الفئات الفرعية المعروفة غير المباشرة 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 سترسل أداة التجميع إلى الأجهزة إعدادات مقياس المدة المحدّدة مسبقًا للإحصاءات وستجمع هذه الإعدادات. مدة اتصال البلوتوث لكل ملف شخصي.  BluetoothConnectionStateCollector ستجمع أداة التجميع هذه مقاييس BluetoothConnectionStateChanged وستسجّل حالة الاتصال رقم لكل ملف شخصي.  BluetoothConnectionSuccessRatePostProcessor تنفيذ معالج ما بعد المعالجة الذي يحتسب معدّل نجاح ملف شخصي يتضمّن بلوتوث استخدام ميزة "مطابقة مفتاح المقياس" لتحديد المقاييس التي تحتوي على حالات اتصال البلوتوث بتنسيق رقمي مثال على المصفوفة [0, 1, 2, 3, 0, 1, 2, 3].  BluetoothHciSnoopLogCollector أداة جمع البيانات لتفعيل تسجيل التطفل عبر وحدة تحكم المضيف في بلوتوث (DUT) وجمع السجلّ لكل اختبار.  BugreportCollector هو ITestInvocationListener قابل للضبط ويجمع تقارير الأخطاء عند ضبط الأحداث. ثم يتم استدعاء ITestInvocationListener#testLog على عناصره الثانوية بعد كل جمع تقرير الأخطاء.  BugreportzOnFailureCollector جمع تقرير بالأخطاء عند تعذُّر تقديم حالة اختبار.  BugreportzOnTestCaseFailureCollector جمع تقرير الأخطاء عند تعذُّر إجراء اختبار أثناء إجراء عملية تشغيل.  ClangCodeCoverageCollector مفتاح BaseDeviceMetricCollector الذي يسحب الاختصار قياسات التغطية خارج الجهاز وتسجيلها كعناصر اختبار.  CollectingTestListener ITestInvocationListener التي ستجمع كل نتائج الاختبارات.  CommandStatusHandler المعالِج الذي يساعد في مراقبة حالة الاستدعاء وتعديلها  ConditionFailureMonitor راقِب أي أخطاء بسبب الاستدعاء.  ConsoleResultReporter أداة الإبلاغ عن النتائج لطباعة نتائج الاختبار في وحدة التحكّم.  CountTestCasesCollector احتساب عدد حالات الاختبار لـ "IRemoteTest" والإبلاغ عنه  DebugHostLogOnFailureCollector المجمِّع الذي سيجمع السجلات من جهة المضيف ويسجِّلها عند حدوث فشل في حالة الاختبار.  DeviceReleaseReporter هو تقرير إصدار الجهاز الذي يتعامل مع عملية التواصل الرئيسية مع الجهاز(الأجهزة) المطلوب صدرت.  DeviceTraceCollector المجمِّع الذي سيبدأ تتبع الأداء عند بدء تشغيل الاختبار وملف تتبع السجل في النهاية.  DeviceUnavailableMonitor يحاول هذا المستمع تسجيل اسم DNAE على مستوى حالة الاختبار فقط.  eventsLoggerListener أداة معالجة الحدث التي تسجّل جميع الأحداث التي تتلقّاها في ملف FileProtoResultReporter مُبلِّغ Proto الذي يملأ TestRecord في ملف.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector يرصد مفتاح المقاييس الواردة من الجهاز ويسحب كملف من الجهاز.  FilePullerLogCollector سجلّ الملف الذي تم الإبلاغ عنه من جانب الجهاز.  FilteredResultforwarder خيار ResultForwarder الذي يسمح فقط بقائمة مسموح بها يبلغ TestDescription تم الإبلاغ عنها.  FormattedGeneratorReporter جهة الإبلاغ التي تسمح بإنشاء التقارير بتنسيق معيّن.  GcovCodeCoverageCollector دالة BaseDeviceMetricCollector التي ستسحب gcov قياسات التغطية خارج الجهاز وتسجيلها كعناصر اختبار.  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector الذي سيسحب نواة gcov قياسات التغطية من برامج تصحيح الأخطاء وخارجها، ثم تسجِّلها في النهاية كاختبار والأدوات.  GranularRetriableTestWrapper.StartEndCollector مساعد الصف لرصد بداية الجري ونهايته المفقودة  HostStatsdMetricCollector IMetricCollector الذي يجمع المقاييس الإحصائية من جهة المضيف باستخدام أداة الإحصاءات الأوامر.  ICommandscheduler.IscheduleInvocationListener أداة معالجة أحداث الاستدعاء عند اكتمال الاستدعاء  ILogSaverListener تسمح هذه السياسة لـ "ITestInvocationListener" بالانتظار عند حفظ ملفات السجلّ.  IMetricCollector ستتم إضافة هذه الواجهة كمصمم عند إعداد تقارير عن نتائج الاختبارات بهدف جمع ومقاييس المطابقة.  IPostProcessor معالِجات المهام اللاحقة هي كائن خاص بالاتحاد التجاري يهدف إلى السماح بمعالجة المقاييس والسجلات. "بعد" الاختبارات و"قبل" تقرير النتائج.  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 يشير ذلك المصطلح إلى نسخة من أداة جمع السجلّات ولوحدة القياس.  NameMangleListener أداة استماع خادم وكيل لترجمة أسماء طرق الاختبار والفئة والحِزم عند الإبلاغ عن النتائج  PassingTestFileReporter تمثّل هذه السمة ITestInvocationListener تحفظ قائمة حالات الاختبار التي تم اجتيازها في ملف اختبار. PerfettoGenericPostProcessor يشير هذا المصطلح إلى معالج ما بعد المعالجة يعالج ملف نموذجي نصي/مقياس ثنائي إلى أزواج المفتاح/القيمة عن طريق توسيع رسائل وحقول Proto بشكل متكرر بقيم سلسلة حتى يكون الحقل القيمة الرقمية.  PerfettoPullerMetricCollector التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح سحب ملفات الأداء من الجهاز وجمع المقاييس منه.  PrettyTestEventLogger أداة تسجيل تطابق الأحداث وتسجيلها لتسهيل تصحيح الأخطاء  ProtoResultReporter أنشأ الشخص الذي أبلغ عن النتائج نموذجًا أوّليًا لـ TestRecord يحتوي على جميع النتائج بداخلها.  PythonBinaryHostTest.Pythonforwarder تعمل أداة إعادة توجيه النتائج على استبدال اسم عملية التشغيل بالاسم الثنائي.  RewreasonCollector يجمع هذا المجمِّع عمليات إعادة تشغيل الجهاز أثناء إجراء الاختبار ويبلِّغ عنها حسب السبب والعدد.  RemoteTestTimeOutSpendr أدوات معالجة الموسيقى التي تسمح بالتحقق من وقت تنفيذ تهيئة اختبار معينة وتفشل في حال استمرارها خلال مهلة محددة  الإبلاغ عن الاختبارات التي تم اجتيازها إعداد تقرير في ملف الفلاتر المحتملة لاستبعاد الاختبار الذي تم اجتيازه.  أداة تجميع النتائج إعادة توجيه خاصة تجمع النتائج عند الحاجة، استنادًا إلى استراتيجية إعادة المحاولة التي تم التقاطها.  ResultAndLogforwarder أداة إعادة توجيه أحداث النتائج والسجلات  أداة إعادة توجيه النتائج نوع ITestInvocationListener يعيد توجيه نتائج الاستدعاء إلى قائمة بالمستمعين الآخرين  verifyLogSaverResultforwarder مسؤول إعادة التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن بصددها.  إعادة توجيه النتيجة يشير ذلك المصطلح إلى إضافة للسمة ResultForwarder يتم إرسالها دائمًا إلى رقم محاولة معيّن.  RuntimeRedirectCollector أداة التجميع التي تجمع الطوابع الزمنية لعمليات إعادة التشغيل في وقت التشغيل (أعطال خادم النظام) أثناء الاختبار التشغيل، إن وجدت.  لقطة الشاشة OnFailureCollector المجمِّع الذي سيلتقط لقطة شاشة ويسجلها عند إخفاق حالة اختبار.  ShardListener إنّ ITestInvocationListener الذي يجمع النتائج من جزء الاستدعاء (المعروف أيضًا باسم تقسيم الاستدعاء ليتم تشغيله على عدة موارد بالتوازي) وإعادة توجيهها إلى موارد أخرى المستمع.  ShardMainResultforwarder تمثّل هذه السمة ResultForwarder يجمع بين نتائج استدعاءات الاختبار المقسّمة.  ShowmapPullerMetricCollector التنفيذ الأساسي لـ FilePullerDeviceMetricCollector الذي يسمح بسحب خريطة العرض من الجهاز وجمع المقاييس منه.  StatsdBeforeafterGaugeMetricPostProcessor يشير هذا المصطلح إلى معالج بيانات يقيس المقاييس التي يتم جمعها في مرحلة "قبل وبعد". أي نهج StatsdEventMetricPostProcessor يشير هذا المصطلح إلى معالج ما بعد المعالجة يعالج مقاييس الأحداث في التقارير الإحصائية إلى أزواج المفتاح/القيمة، باستخدام أدوات التنسيق المحددة في المعالج.  StatsdGenericPostProcessor يشير هذا المصطلح إلى معالج ما بعد المعالجة يعالج تقارير إحصاءات النموذج الأوّلي الثنائية إلى أزواج مفاتيح/قيم من خلال توسيع تقريرها كبنية الشجرة.  StreamProtoResultReporter تنفيذ ProtoResultReporter SubprocessResultsReporter تنفيذ ITestInvocationListener الذي سيتم تحديده على هيئة results_reporter وإعادة التوجيه من والمعالجة الفرعية لنتائج الاختبارات وعمليات الاختبار والاستدعاءات التجريبية.  SuiteResultReporter يمكنك جمع نتائج الاختبار لاستدعاء الحزمة بالكامل والحصول على النتائج النهائية.  أداة تنفيذ مهلة الاختبار أدوات معالجة الموسيقى التي تسمح بالتحقق من وقت تنفيذ حالة اختبار معينة وتفشل في حال استمرارها خلال مهلة محددة  TextResultReporter مراسلة لنتائج الاختبار تعيد توجيه النتائج إلى طابعة النتائج النصية من JUnit.  TraceCmdCollector IMetricCollector الذي يجمع بيانات آثار الأنشطة أثناء الاختبار باستخدام trace-cmd، ويسجِّلها الاستدعاء.  TradefedSandboxRunner.StubscheduleInvocationListener رمز بديل IScheduledInvocationListener لا يفعل أي شيء.  XmlFormattedGeneratorReporter يؤدي تنفيذ سياسة FormattedGeneratorReporter التي تنسّق الحزمة إلى إنشاء ملف xml. .  XmlResultReporter كتابة نتائج JUnit إلى ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter إلى أنت.

---

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

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

• invocationStarted(BuildInfo)
• أمر testRunStarted
• تم بدء الاختبار
• [تعذّر الاختبار]
• انتهى الاختبار
• ...
• اختبار 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) تبلغ عن بداية وحدة قيد التشغيل.

الطرق العامة

الحصول على الملخص

public TestSummary getSummary ()

يسمح هذا الإذن لـ InvocationListener بعرض ملخص.

المرتجعات
TestSummary	علامة TestSummary تلخّص تمرين الجري أو قيمة خالية

تم إنهاء الاستدعاء

public void invocationEnded (long elapsedTime)

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

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

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

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

public void invocationFailed (FailureDescription failure)

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

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

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

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

public void invocationFailed (Throwable cause)

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

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

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

انقطع الاستدعاء

public void invocationInterrupted ()

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

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

public void invocationSkipped (SkipReason reason)

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

المعلمات
reason	SkipReason

تم بدء الاستدعاء

public void invocationStarted (IInvocationContext context)

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

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

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

وحدة اختبار انتهت

public void testModuleEnded ()

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

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

public void testModuleStarted (IInvocationContext moduleContext)

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

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