ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver , ITestLogger

com.android.tradefed.result.ITestInvocationListener

زیر کلاس های غیر مستقیم شناخته شده AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionStateCollector ,BluetoothConnectionStateCollector, BluetoothConnectionHoportoGreeProcessor ، BugreportzOnFailureCollector ، BugreportzOnTestCaseFailureCollector ، ClangCodeCoverageCollector ، CollectingTestListener ، و 74 مورد دیگر. AggregatePostProcessor یک جمع‌کننده متریک که حداقل، حداکثر، میانگین، واریانس، انحراف استاندارد، کل، تعداد و صدک‌های اختیاری را برای معیارهای عددی جمع‌آوری‌شده در طول اجرای آزمایشی چند تکراری ارائه می‌کند و آنها را دو برابر می‌کند. AtraceCollector یک IMetricCollector که atrace را در طول تست اجرا می کند و نتیجه را جمع آوری می کند و آنها را در فراخوانی ثبت می کند. AtraceRunMetricCollector ردیابی‌ها را از تمام دایرکتوری آزمایشی زیر فهرست داده‌شده از دستگاه آزمایشی جمع‌آوری می‌کند، فهرست راهنمای آزمایش را ثبت می‌کند و فایل‌های ردیابی را در زیر فهرست راهنمای آزمایش پردازش می‌کند و معیارها را جمع می‌کند. AveragePostProcessor پیاده سازی پس پردازشگر که میانگین لیست معیارها را محاسبه می کند. BaseDeviceMetricCollector اجرای پایه IMetricCollector که امکان شروع و توقف مجموعه را در onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) و ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) . BasePostProcessor IPostProcessor پایه که هر پیاده سازی باید گسترش یابد. Bluetooth ConnectionLatency Collector گردآورنده یک پیکربندی متریک مدت زمان statsd از پیش تعریف شده را به دستگاه ها فشار می دهد و مدت زمان اتصال بلوتوث را برای هر نمایه جمع آوری می کند. BluetoothConnectionStateCollector این گردآورنده معیارهای BluetoothConnectionStateChanged را جمع آوری می کند و شماره وضعیت اتصال را برای هر نمایه ثبت می کند. BluetoothConnectionSuccessRatePostProcessor پیاده سازی پس پردازشگر که میزان موفقیت پروفایل بلوتوث را محاسبه می کند برای مشخص کردن معیارهایی که شامل حالات اتصال بلوتوث در آرایه عددی هستند، از "متریک-کلید-تطابق" استفاده کنید. مثال [0، 1، 2، 3، 0، 1، 2، 3]. بلوتوثHciSnoopLogCollector جمع‌آوری برای فعال کردن بلوتوث HCI Snoop Logging در DUT و جمع‌آوری گزارش برای هر آزمایش. BugreportCollector یک ITestInvocationListener که در صورت وقوع رویدادهای قابل تنظیم، گزارش‌های اشکال را جمع‌آوری می‌کند و پس از جمع‌آوری هر گزارش اشکال ITestInvocationListener#testLog روی فرزندان خود فراخوانی می‌کند. BugreportzOnFailureCollector هنگامی که یک مورد آزمایشی با شکست مواجه شد، یک bugreportz جمع آوری کنید. BugreportzOnTestCaseFailureCollector هنگامی که یک مورد آزمایشی در یک اجرا با شکست مواجه می شود، یک bugreportz جمع آوری کنید. ClangCodeCoverageCollector یک BaseDeviceMetricCollector که اندازه گیری های پوشش Clang را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. CollectingTestListener یک ITestInvocationListener که تمام نتایج آزمایش را جمع آوری می کند. CommandStatus Handler کنترل کننده به نظارت و به روز رسانی وضعیت فراخوان کمک می کند. ConditionFailureMonitor برای هر گونه شکست در فراخوانی نظارت کنید. ConsoleResultReporter گزارشگر نتیجه برای چاپ نتایج آزمایش در کنسول. CountTestCasesCollector تعداد موارد آزمایش را برای یک IRemoteTest معین بشمارید و گزارش دهید. DebugHostLogOnFailureCollector جمع‌آوری که در صورت بروز خطای مورد آزمایش، گزارش‌های سمت میزبان را جمع‌آوری و ثبت می‌کند. DeviceReleaseReporter گزارشگر انتشار دستگاه که ارتباط با والدین را پردازش می کند که دستگاه(های) منتشر می شود. DeviceTraceCollector گردآوری که با شروع اجرای آزمایشی ردیابی پرفتو را شروع می کند و در پایان فایل ردیابی را ثبت می کند. Device UnavailableMonitor این شنونده سعی می‌کند فقط یک DNAE در سطح مورد آزمایشی را ضبط کند. EventsLoggerListener شنونده ای که تمام رویدادهایی را که دریافت می کند در یک فایل ثبت می کند FileProtoResultReporter گزارشگر اولیه که TestRecord را در یک فایل تخلیه می کند. FilePullerDeviceMetricCollector یک BaseDeviceMetricCollector که به کلیدهای متریک که از دستگاه می آید گوش می دهد و آنها را به عنوان فایل از دستگاه می کشد. FilePullerLogCollector گزارشگر فایل گزارش شده توسط دستگاه سمت. FilteredResultForwarder گونه‌ای از ResultForwarder که فقط اجازه می‌دهد لیستی از TestDescription گزارش شود. FormattedGeneratorReporter گزارشگری که امکان تولید گزارش در یک فرمت خاص را فراهم می کند. GcovCodeCoverageCollector BaseDeviceMetricCollector که اندازه گیری های پوشش gcov را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. GcovKernelCodeCoverageCollector یک BaseDeviceMetricCollector که اندازه‌گیری‌های پوشش هسته gcov را از دیباگ‌ها خارج می‌کند و از دستگاه خارج می‌کند و در نهایت آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند. GranularRetriableTestWrapper.StartEndCollector کمک کننده کلاس برای گرفتن شروع و پایان اجرا از دست رفته. HostStatsdMetricCollector یک IMetricCollector که معیارهای statsd را از سمت میزبان با استفاده از دستورات ابزار statsd جمع آوری می کند. ICommandScheduler.IScheduledInvocationListener شنونده رویدادهای فراخوان پس از اتمام فراخوانی. IlogSaverListener به ITestInvocationListener اجازه می دهد به هنگام ذخیره فایل های گزارش گوش دهد. IMetric Collector این رابط به عنوان یک تزئین کننده هنگام گزارش نتایج آزمایش ها به منظور جمع آوری معیارهای منطبق اضافه می شود. پردازنده IPost Post processors یک شیء فدراسیون تجارت است که به منظور امکان پردازش معیارها و گزارش‌ها پس از آزمایش‌ها و قبل از گزارش نتایج است. IShardableListener یک ITestInvocationListener که می توان آن را به اشتراک گذاشت. ISupportGranular Results رابطی که مشخص می کند آیا ITestInvocationListener از دریافت نتایج گرانول پشتیبانی می کند یا خیر. ITestSummaryListener رابطی که به ITestInvocationListener اجازه می دهد تا اطلاعات محدودی را از طریق خلاصه ها مبادله کند. InvocationToJUnitResultForwarder کلاسی که به رویدادهای ITestInvocationListener گوش می دهد و آنها را به TestListener ارسال می کند. JarHostTest.HostTestListener شنونده Wrapper که همه رویدادها به جز testRunStarted() و testRunEnded() را به شنونده تعبیه شده ارسال می کند. JavaCodeCoverageCollector BaseDeviceMetricCollector که اندازه گیری های پوشش جاوا را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. JsonHttpTestResultReporter یک گزارشگر نتیجه که نتایج معیارهای تست و شاخه، اطلاعات دستگاه را در JSON و POST را در یک نقطه پایانی سرویس HTTP رمزگذاری می‌کند. LUCIResultReporter گزارشگر نتیجه ای که نتایج آزمایش مورد نیاز ResultDB و LUCI را در قالب JSON (go/result-sink) ذخیره می کند و مکان فایل را در کنسول ثبت می کند. LastShardDetector هنگام اجرای اشتراک‌گذاری محلی، گاهی اوقات می‌خواهیم تنها زمانی که آخرین قطعه به invocationEnded(long) می‌رسد، برخی از اقدامات را اجرا کنیم. LegacySubprocess ResultsReporter اجرای منجمد گزارشگر نتایج فرعی که باید با نسخه‌های قبلی TF/CTS (به عنوان مثال 8+) سازگار باقی بماند، علی‌رغم تغییرات در سوپرکلاس آن. LogSaverResultForwarder ResultForwarder برای ذخیره گزارش‌ها با ذخیره‌کننده فایل سراسری. LogcatCrashResultForwarder شنونده ویژه: در صورت خرابی (از کار افتادن فرآیند ابزار دقیق) سعی می کند خرابی را از لاگ کت استخراج کند و آن را به پیام شکست مرتبط با آزمایش اضافه کند. LogcatOnFailureCollector مجموعه‌ای که در صورت شکست یک مورد آزمایشی، یک logcat را ضبط و ثبت می‌کند. LogcatTimingMetricCollector جمع‌آوری متریک که اطلاعات زمان‌بندی (مثلاً زمان سوئیچ کاربر) را از logcat در طول یک یا چند آزمایش مکرر با استفاده از الگوهای regex داده‌شده برای تجزیه سیگنال‌های شروع و پایان یک رویداد از خطوط logcat جمع‌آوری می‌کند. MetricFilePostProcessor برای آپلود فایل گزارش معیارهای جمع آوری شده در طول تست و سطح اجرا استفاده می شود. MetricsXMLResultReporter MetricsXMLResultReporter معیارهای آزمایشی را می نویسد و معیارهای اجرا را در یک فایل XML در پوشه ای که توسط پارامتر metrics-folder در مرحله invocationEnded تست مشخص شده است، می نویسد. ModuleListener شنونده به هر IRemoteTest هر ماژول به منظور جمع آوری لیست نتایج متصل شده است. ModuleLogcatCollector نسخه کلکتور logcat اما برای ماژول. ModuleProtoResultReporter منظور از گزارشگر نتیجه این است که فقط نتایج سطح ماژول را گزارش کند. NameMangleListener یک شنونده پروکسی برای ترجمه روش تست، کلاس و نام بسته به عنوان نتایج گزارش می شود. PassingTestFileReporter یک ITestInvocationListener که لیست موارد آزمایشی را در یک فایل آزمایشی ذخیره می کند PerfettoGenericPostProcessor یک پردازشگر پست که فایل متنی/دودویی متریک perfetto proto را با گسترش بازگشتی پیام‌ها و فیلدهای اولیه با مقادیر رشته‌ای تا زمانی که با فیلد با مقدار عددی مواجه شود، به جفت‌های کلید-مقدار پردازش می‌کند. PerfettoPullerMetricCollector اجرای پایه FilePullerDeviceMetricCollector که اجازه می دهد فایل های perfetto را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید. PrettyTestEventLogger Logger که رویدادها را مطابقت می دهد و آنها را ثبت می کند تا اشکال زدایی را آسان تر کند. ProtoResultReporter گزارشگر نتیجه یک پروتوباف TestRecord با تمام نتایج داخل آن می‌سازد. PythonBinaryHostTest.PythonForwarder ارسال کننده نتیجه برای جایگزینی نام اجرا با نام باینری. RebootReasonCollector مجموعه‌ای که راه‌اندازی مجدد دستگاه را در طول اجرای آزمایشی جمع‌آوری می‌کند و آنها را با دلیل و شمارش گزارش می‌دهد. RemoteTestTimeOutEnforcer شنوندگانی که اجازه می‌دهد زمان اجرای یک پیکربندی آزمایشی معین را بررسی کنند و اگر از یک بازه زمانی معین گذشت، در آن شکست بخورند. ReportPassedTests فیلترهای احتمالی را در فایلی گزارش کنید تا آزمون قبولی را حذف کنید. ResultAggregator فوروارد ویژه ای که نتایج را در صورت نیاز جمع آوری می کند، بر اساس استراتژی تلاش مجدد که اتخاذ شده است. ResultAndLogForwarder فوروارد کننده برای نتایج و گزارش رویدادها. ResultForwarder یک ITestInvocationListener که نتایج فراخوانی را به لیستی از شنوندگان دیگر ارسال می کند. RetryLogSaverResultForwarder فورواردری که عبور از تلاش فعلی ما را نیز کنترل می کند. RetryResultForwarder یک برنامه افزودنی ResultForwarder که همیشه به یک عدد تلاش معین فشار می آورد. RuntimeRestartCollector جمع‌آوری که در صورت وجود، مُهرهای زمانی راه‌اندازی مجدد زمان اجرا (از کار افتادن سرور سیستم) را در طول اجرای آزمایشی جمع‌آوری می‌کند. ScreenshotOnFailureCollector مجموعه‌ای که در صورت شکست یک مورد آزمایشی، اسکرین‌شات می‌گیرد و ثبت می‌کند. ShardListener یک ITestInvocationListener که نتایج را از یک فراخوان جمع‌آوری می‌کند (معروف به تقسیم فراخوانی برای اجرای موازی منابع متعدد)، و آنها را به شنونده دیگری ارسال می‌کند. ShardMainResultForwarder یک ResultForwarder که نتایج یک فراخوانی تست خرد شده را ترکیب می کند. ShowmapPullerMetricCollector پیاده سازی پایه FilePullerDeviceMetricCollector که اجازه می دهد فایل های نمایش نقشه را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید. StatsdBeforeAfterGaugeMetricPostProcessor یک پردازشگر پستی که معیارهای اندازه گیری جمع آوری شده با رویکرد "قبل/پس" را پردازش می کند. StatsdEventMetricPostProcessor یک پردازشگر پست که معیارهای رویداد در گزارش‌های statsd را با استفاده از قالب‌کننده‌های مشخص‌شده روی پردازنده به جفت‌های کلید-مقدار پردازش می‌کند. StatsdGenericPostProcessor یک پردازشگر پست که گزارش های statsd پروتو باینری را با گسترش گزارش به عنوان یک ساختار درختی به جفت های کلید-مقدار پردازش می کند. StreamProtoResultReporter اجرای ProtoResultReporter گزارشگر نتایج فرعی 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
• تست شروع شد
• [تست ناموفق]
• تست پایان یافت
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [دعا نشد]
• [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 که اجرا یا null را خلاصه می کند

فراخوان پایان یافت

public void invocationEnded (long elapsedTime)

گزارش می دهد که فراخوانی، چه با موفقیت یا به دلیل برخی شرایط خطا، پایان یافته است.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.

پارامترها
elapsedTime	long : زمان سپری شده فراخوانی در ms

فراخوان ناموفق بود

public void invocationFailed (FailureDescription failure)

یک فراخوان ناقص را به دلیل برخی شرایط خطا گزارش می دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.

پارامترها
failure	FailureDescription : FailureDescription که علت خرابی را توصیف می کند

فراخوان ناموفق بود

public void invocationFailed (Throwable cause)

یک فراخوان ناقص را به دلیل برخی شرایط خطا گزارش می دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.

پارامترها
cause	Throwable : علت Throwable شکست

فراخوان قطع شد

public void invocationInterrupted ()

در حالت خاموش کردن زمان‌بندی فراخوانی می‌شود، به فراخوان این فرصت را می‌دهد تا قبل از خاتمه کاری انجام دهد.

فراخوان نادیده گرفته شد

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 ماژول.