IlogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

زیر کلاس های غیر مستقیم شناخته شده AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionStateCollector , BluetoothConnectionPostCollectorSuccessRate BugreportzOnFailureCollector ، BugreportzOnTestCaseFailureCollector ، ClangCodeCoverageCollector ، CodeCoverageCollector ، CollectingTestListener ، و 52 مورد دیگر. 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 و جمع‌آوری گزارش برای هر آزمایش. BugreportzOnFailureCollector هنگامی که یک مورد آزمایشی با شکست مواجه شد، یک bugreportz جمع آوری کنید. BugreportzOnTestCaseFailureCollector هنگامی که یک مورد آزمایشی در یک اجرا با شکست مواجه می شود، یک bugreportz جمع آوری کنید. ClangCodeCoverageCollector یک BaseDeviceMetricCollector که اندازه گیری های پوشش Clang را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. CodeCoverageCollector BaseDeviceMetricCollector که جاوا و اندازه گیری های پوشش بومی را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. CollectingTestListener یک ITestInvocationListener که تمام نتایج آزمایش را جمع آوری می کند. ConsoleResultReporter گزارشگر نتیجه برای چاپ نتایج آزمایش در کنسول. CountTestCasesCollector تعداد موارد آزمایش را برای یک IRemoteTest معین بشمارید و گزارش دهید. DebugHostLogOnFailureCollector جمع‌آوری که در صورت بروز خطای مورد آزمایش، گزارش‌های سمت میزبان را جمع‌آوری و ثبت می‌کند. DeviceTraceCollector گردآوری که با شروع اجرای آزمایشی ردیابی پرفتو را شروع می کند و در پایان فایل ردیابی را ثبت می کند. EventsLoggerListener شنونده ای که تمام رویدادهایی را که دریافت می کند در یک فایل ثبت می کند FileProtoResultReporter گزارشگر اولیه که TestRecord را در یک فایل تخلیه می کند. FilePullerDeviceMetricCollector یک BaseDeviceMetricCollector که به کلیدهای متریک که از دستگاه می آید گوش می دهد و آنها را به عنوان فایل از دستگاه می کشد. FilePullerLogCollector گزارشگر فایل گزارش شده توسط دستگاه سمت. FormattedGeneratorReporter گزارشگری که امکان تولید گزارش در یک فرمت خاص را فراهم می کند. GcovCodeCoverageCollector BaseDeviceMetricCollector که اندازه گیری های پوشش gcov را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. GcovKernelCodeCoverageCollector یک BaseDeviceMetricCollector که اندازه‌گیری‌های پوشش هسته gcov را از دیباگ‌ها خارج می‌کند و از دستگاه خارج می‌کند و در نهایت آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند. GranularRetriableTestWrapper.StartEndCollector کمک کننده کلاس برای گرفتن شروع و پایان اجرا از دست رفته. HostStatsdMetricCollector یک IMetricCollector که معیارهای statsd را از سمت میزبان با استفاده از دستورات ابزار statsd جمع آوری می کند. IMetric Collector این رابط به عنوان یک تزئین کننده هنگام گزارش نتایج آزمایش ها به منظور جمع آوری معیارهای منطبق اضافه می شود. پردازنده IPost Post processors یک شیء فدراسیون تجارت است که به منظور امکان پردازش معیارها و گزارش‌ها پس از آزمایش‌ها و قبل از گزارش نتایج است. InvocationProtoResultReporter گزارشگران برای ذخیره اطلاعات حافظه پنهان سطح فراخوان و لیست ماژول های آن JavaCodeCoverageCollector BaseDeviceMetricCollector که اندازه گیری های پوشش جاوا را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند. JsonHttpTestResultReporter یک گزارشگر نتیجه که نتایج معیارهای تست و شاخه، اطلاعات دستگاه را در JSON و POST را در یک نقطه پایانی سرویس HTTP رمزگذاری می‌کند. LUCIResultReporter گزارشگر نتیجه ای که نتایج آزمایش مورد نیاز ResultDB و LUCI را در قالب JSON (go/result-sink) ذخیره می کند و مکان فایل را در کنسول ثبت می کند. LegacySubprocess ResultsReporter اجرای منجمد گزارشگر نتایج فرعی که باید با نسخه‌های قبلی TF/CTS (به عنوان مثال 8+) سازگار باقی بماند، علی‌رغم تغییرات در سوپرکلاس آن. LogSaverResultForwarder ResultForwarder برای ذخیره گزارش‌ها با ذخیره‌کننده فایل سراسری. LogcatOnFailureCollector مجموعه‌ای که در صورت شکست یک مورد آزمایشی، یک logcat را ضبط و ثبت می‌کند. LogcatTimingMetricCollector جمع‌آوری متریک که اطلاعات زمان‌بندی (مثلاً زمان سوئیچ کاربر) را از logcat در طول یک یا چند آزمایش مکرر با استفاده از الگوهای regex داده‌شده برای تجزیه سیگنال‌های شروع و پایان یک رویداد از خطوط logcat جمع‌آوری می‌کند. MetricFilePostProcessor برای آپلود فایل گزارش معیارهای جمع آوری شده در طول تست و سطح اجرا استفاده می شود. MetricsXMLResultReporter MetricsXMLResultReporter معیارهای آزمایشی را می نویسد و معیارهای اجرا را در یک فایل XML در پوشه ای که توسط پارامتر metrics-folder در مرحله invocationEnded تست مشخص شده است، می نویسد. ModuleListener شنونده به هر IRemoteTest هر ماژول به منظور جمع آوری لیست نتایج متصل شده است. ModuleLogcatCollector نسخه کلکتور logcat اما برای ماژول. ModuleProtoResultReporter منظور از گزارشگر نتیجه این است که فقط نتایج سطح ماژول را گزارش کند. PerfettoGenericPostProcessor یک پردازشگر پست که فایل متنی/دودویی متریک perfetto proto را با گسترش بازگشتی پیام‌ها و فیلدهای اولیه با مقادیر رشته‌ای تا زمانی که با فیلد با مقدار عددی مواجه شود، به جفت‌های کلید-مقدار پردازش می‌کند. PerfettoPullerMetricCollector اجرای پایه FilePullerDeviceMetricCollector که اجازه می دهد فایل های perfetto را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید. ProtoResultReporter گزارشگر نتیجه یک پروتوباف TestRecord با تمام نتایج داخل آن می‌سازد. RebootReasonCollector مجموعه‌ای که راه‌اندازی مجدد دستگاه را در طول اجرای آزمایشی جمع‌آوری می‌کند و آنها را با دلیل و شمارش گزارش می‌دهد. ReportPassedTests فیلترهای احتمالی را در فایلی گزارش کنید تا آزمون قبولی را حذف کنید. ResultAggregator فوروارد ویژه ای که نتایج را در صورت نیاز جمع آوری می کند، بر اساس استراتژی تلاش مجدد که اتخاذ شده است. ResultAndLogForwarder فوروارد کننده برای نتایج و گزارش رویدادها. ResultDBRreporter گزارشگر نتیجه که نتایج آزمایش را در ResultDB آپلود می کند. RetryLogSaverResultForwarder فورواردری که عبور از تلاش فعلی ما را نیز کنترل می کند. RuntimeRestartCollector جمع‌آوری که در صورت وجود، مُهرهای زمانی راه‌اندازی مجدد زمان اجرا (از کار افتادن سرور سیستم) را در طول اجرای آزمایشی جمع‌آوری می‌کند. ScreenshotOnFailureCollector مجموعه‌ای که در صورت شکست یک مورد آزمایشی، اسکرین‌شات می‌گیرد و ثبت می‌کند. ShardListener یک ITestInvocationListener که نتایج را از یک فراخوان جمع‌آوری می‌کند (معروف به تقسیم فراخوانی برای اجرای موازی منابع متعدد)، و آنها را به شنونده دیگری ارسال می‌کند. ShardMainResultForwarder یک ResultForwarder که نتایج یک فراخوانی تست خرد شده را ترکیب می کند. ShowmapPullerMetricCollector پیاده سازی پایه FilePullerDeviceMetricCollector که اجازه می دهد فایل های نمایش نقشه را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید. StatsdBeforeAfterGaugeMetricPostProcessor یک پردازشگر پستی که معیارهای اندازه گیری جمع آوری شده با رویکرد "قبل/بعد" را پردازش می کند. StatsdEventMetricPostProcessor یک پردازشگر پست که معیارهای رویداد در گزارش‌های statsd را با استفاده از قالب‌کننده‌های مشخص‌شده روی پردازنده به جفت‌های کلید-مقدار پردازش می‌کند. StatsdGenericPostProcessor یک پردازشگر پست که با گسترش گزارش به عنوان یک ساختار درختی، گزارش های statsd پروتو باینری را به جفت های کلید-مقدار پردازش می کند. StreamProtoResultReporter اجرای ProtoResultReporter گزارشگر نتایج فرعی ITestInvocationListener پیاده می‌کند تا به‌عنوان یک result_reporter مشخص شود و نتایج آزمایش‌ها، اجراهای آزمایشی، فراخوان‌های آزمایشی را از فرآیند فرعی ارسال کند. SuiteResultReporter نتایج آزمون را برای کل فراخوانی مجموعه جمع آوری کنید و نتایج نهایی را ارائه دهید. TextResultReporter گزارشگر نتیجه آزمایش که نتایج را به چاپگر نتیجه متنی JUnit ارسال می کند. TraceCmdCollector یک IMetricCollector که ردیابی ها را در طول آزمایش با استفاده از trace-cmd جمع آوری می کند و آنها را در فراخوان ثبت می کند. XmlFormattedGeneratorReporter پیاده سازی FormattedGeneratorReporter که مجموعه را فرمت می کند در قالب xml. XmlResultReporter نتایج JUnit را در یک فایل XML در قالبی مطابق با XMLJUnitResultFormatter Ant می‌نویسد.

---

به ITestInvocationListener اجازه می دهد به هنگام ذخیره فایل های گزارش گوش دهد.

این به چندین ITestInvocationListener اجازه می دهد تا از یک فایل گزارش ذخیره شده یکسان در هنگام تولید گزارش استفاده کند و از ذخیره هر شنونده به صورت جداگانه در هنگام ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) جلوگیری می کند. ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) نامیده می شود.

کلاس‌هایی که این رابط را پیاده‌سازی می‌کنند باید بدانند که testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) هر زمان که ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) نامیده می شود.

این کلاس نمونه جهانی ILogSaver را نیز پاس می کند تا ITestInvocationListener بتواند فایل های اضافی را در همان مکان ذخیره کند.

خلاصه

روش های عمومی
default void	logAssociation (String dataName, LogFile logFile) در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان پذیر نیست.
default void	setLogSaver ( ILogSaver logSaver) ILogSaver را طوری تنظیم کنید که به پیاده‌کننده اجازه دهد فایل‌ها را ذخیره کند.
default void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) هنگامی که گزارش تست ذخیره می شود، فراخوانی می شود.

روش های عمومی

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان پذیر نیست. بنابراین، این تماس برگشتی اجازه می دهد تا یک ارتباط قوی را به صراحت ارائه دهد.

پارامترها
dataName	String : نام داده ها
logFile	LogFile : LogFile که قبلاً ثبت شده است و باید با پرونده آزمایشی مرتبط شود.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

ILogSaver را طوری تنظیم کنید که به پیاده‌کننده اجازه دهد فایل‌ها را ذخیره کند.

پارامترها
logSaver	ILogSaver : ILogSaver

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

هنگامی که گزارش تست ذخیره می شود، فراخوانی می شود.

باید به جای ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) استفاده شود.

پارامترها
dataName	String : نام توصیفی String از داده ها. به عنوان مثال "device_logcat". توجه داشته باشید dataName ممکن است در هر فراخوان منحصر به فرد نباشد. به عنوان مثال، پیاده‌کننده‌ها باید بتوانند چندین تماس را با یک dataName مدیریت کنند
dataType	LogDataType : LogDataType داده ها
dataStream	InputStreamSource : InputStreamSource داده ها. پیاده‌کننده‌ها باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و از بسته شدن InputStream حاصل پس از تکمیل اطمینان حاصل کنند.
logFile	LogFile : LogFile حاوی متا داده های فایل ذخیره شده است.