از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

زیرکلاس‌های غیرمستقیم شناخته‌شده

AggregatePostProcessor ، AtraceCollector ، AtraceRunMetricCollector ، AveragePostProcessor ، BaseDeviceMetricCollector ، BasePostProcessor ، BluetoothConnectionLatencyCollector ، BluetoothConnectionStateCollector ، BluetoothConnectionSuccessRatePostProcessor ، BluetoothHciSnoopLogCollector ، BugreportzOnFailureCollector ، BugreportzOnTestCaseFailureCollector ، ClangCodeCoverageCollector ، CodeCoverageCollector ، CollectingTestListener و ۵۷ مورد دیگر.

پس‌پردازنده تجمیعی	یک تجمیع‌کننده معیار که حداقل، حداکثر، میانگین، واریانس، انحراف معیار، کل، تعداد و در صورت تمایل، صدک‌ها را برای معیارهای عددی جمع‌آوری‌شده در طول اجرای تست‌های چندتکرار ارائه می‌دهد و با آنها به عنوان مقادیر مضاعف رفتار می‌کند.
AtraceCollector	یک `IMetricCollector` که در طول تست atrace را اجرا می‌کند و نتایج را جمع‌آوری کرده و آنها را در فراخوانی ثبت می‌کند.
AtraceRunMetricCollector	ردیابی‌ها را از تمام دایرکتوری تست تحت دایرکتوری داده شده از دستگاه تست جمع‌آوری می‌کند، دایرکتوری تست را ثبت می‌کند و فایل‌های ردیابی تحت دایرکتوری تست را پس‌پردازش می‌کند و معیارها را تجمیع می‌کند.
پردازنده متوسط	پیاده‌سازی پس‌پردازشی که میانگین فهرست معیارها را محاسبه می‌کند.
جمع‌کننده‌ی متریک دستگاه پایه	پیاده‌سازی پایه `IMetricCollector` که امکان شروع و توقف جمع‌آوری داده‌ها را در `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` و `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` می‌کند.
پردازنده پایه	`IPostProcessor` پایه که هر پیاده‌سازی باید آن را توسعه دهد.
جمع‌کننده‌ی تأخیر اتصال بلوتوث	این گردآورنده، پیکربندی متریک مدت زمان statsd از پیش تعریف‌شده را به دستگاه‌ها ارسال می‌کند و مدت زمان اتصال بلوتوث را برای هر پروفایل جمع‌آوری می‌کند.
جمع‌کننده وضعیت اتصال بلوتوث	این گردآورنده، معیارهای BluetoothConnectionStateChanged را جمع‌آوری کرده و شماره وضعیت اتصال را برای هر پروفایل ثبت می‌کند.
اتصال بلوتوث، نرخ موفقیت، پردازنده	پیاده‌سازی پس‌پردازنده‌ای که نرخ موفقیت یک پروفایل بلوتوث را محاسبه می‌کند از "metric-key-match" برای مشخص کردن معیارهایی که شامل حالت‌های اتصال بلوتوث در آرایه عددی هستند، استفاده کنید. مثال [0، 1، 2، 3، 0، 1، 2، 3].
جمع‌کننده‌ی گزارش بلوتوث HciSnoop	گردآورنده برای فعال کردن ثبت وقایع Bluetooth HCI snoop روی DUT و جمع‌آوری گزارش برای هر آزمایش.
BugreportzOnFailureCollector	وقتی یک مورد آزمایشی با شکست مواجه می‌شود، یک گزارش اشکال (bugreportz) جمع‌آوری کنید.
BugreportzOnTestCaseFailureCollector	وقتی یک مورد آزمایشی در یک اجرا با شکست مواجه می‌شود، یک گزارش اشکال (bugreportz) جمع‌آوری کنید.
گردآورنده پوشش ClangCode	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش Clang را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
جمع‌کننده کدپوشش	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش جاوا و بومی را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
CollectingTestListener	یک `ITestInvocationListener` که تمام نتایج تست را جمع‌آوری می‌کند.
ConsoleResultReporter	گزارشگر نتیجه برای چاپ نتایج آزمایش در کنسول.
CountTestCasesCollector	تعداد موارد آزمون را برای یک `IRemoteTest` داده شده بشمارید و گزارش دهید.
DebugHostLogOnFailureCollector	گردآورنده‌ای که در صورت بروز خطا در یک مورد آزمایشی، گزارش‌های سمت میزبان را جمع‌آوری و ثبت می‌کند.
جمع‌کننده‌ی ردیابی دستگاه	گردآورنده‌ای که با شروع یک اجرای آزمایشی، ردیابی بی‌نقص را آغاز می‌کند و در پایان، فایل ردیابی لاگ را ثبت می‌کند.
EventLoggerListener	شنونده‌ای که تمام رویدادهای دریافتی را در یک فایل ثبت می‌کند
FileProtoResultReporter	گزارشگر Proto که `TestRecord` در یک فایل ذخیره می‌کند.
FilePullerDeviceMetricCollector	یک `BaseDeviceMetricCollector` که به کلیدهای معیار دریافتی از دستگاه گوش می‌دهد و آنها را به عنوان یک فایل از دستگاه دریافت می‌کند.
جمع‌کننده‌ی لاگ فایل‌پِلر	ثبت‌کننده‌ی فایل گزارش‌شده توسط دستگاه.
FormattedGeneratorReporter	گزارشگری که امکان تولید گزارش‌ها را در قالبی خاص فراهم می‌کند.
GcovCodeCoverageCollector	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش gcov را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
GcovKernelCodeCoverageCollector	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش هسته gcov را از debugfs و خارج از دستگاه استخراج کرده و در نهایت آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
GranularRetriableTestWrapper.StartEndCollector	کمک‌کننده‌ی کلاس برای پیدا کردن شروع و پایان اجرای از دست رفته.
HostStatsdMetricCollector	یک `IMetricCollector` که معیارهای statsd را از سمت میزبان با استفاده از دستورات کاربردی statsd جمع‌آوری می‌کند.
جمع‌کننده IMetric	این رابط به عنوان یک دکوراتور هنگام گزارش نتایج آزمایش‌ها اضافه می‌شود تا معیارهای منطبق را جمع‌آوری کند.
IPostProcessor	پردازنده‌های پس از آزمایش (Post processors) یک شیء از فدراسیون تجاری (Trade Federation) است که برای پردازش معیارها و گزارش‌ها پس از آزمایش‌ها و قبل از گزارش نتایج در نظر گرفته شده است.
InvocationProtoResultReporter	گزارشگران برای ذخیره اطلاعات ذخیره‌سازی سطح فراخوانی و لیست ماژول‌های آن
جمع‌کننده‌ی پوشش جاواکد	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش جاوا را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
JsonHttpTestResultReporter	یک گزارشگر نتیجه که نتایج معیارهای تست و شاخه، اطلاعات دستگاه را به JSON و POST به یک نقطه پایانی سرویس HTTP رمزگذاری می‌کند.
گزارشگر نتیجه لوسیفر	یک گزارشگر نتیجه که نتایج تست مورد نیاز ResultDB و LUCI را در قالب JSON (go/result-sink) ذخیره می‌کند و محل فایل را در کنسول ثبت می‌کند.
LegacySubprocessResultsReporter	یک پیاده‌سازی متوقف‌شده از گزارشگر نتایج زیرفرآیند که باید با وجود تغییرات در سوپرکلاس خود، با نسخه‌های قبلی TF/CTS (مثلاً ۸+) سازگار باقی بماند.
لاگ سیور ریسل فورواردر	یک `ResultForwarder` برای ذخیره لاگ‌ها با استفاده از ذخیره‌کننده فایل سراسری.
گردآورنده لاگ‌کت‌آن‌فایلور	گردآورنده‌ای که در صورت عدم موفقیت یک مورد آزمایشی، یک logcat را ضبط و ثبت می‌کند.
LogcatTimingMetricCollector	یک جمع‌کننده‌ی متریک که اطلاعات زمان‌بندی (مثلاً زمان سوئیچ کاربر) را از logcat در طول یک یا چند تست تکراری با استفاده از الگوهای regex داده شده برای تجزیه سیگنال‌های شروع و پایان یک رویداد از خطوط logcat جمع‌آوری می‌کند.
پس‌پردازنده‌ی فایل متریک	برای آپلود فایل گزارش معیارهای جمع‌آوری‌شده در طول تست و سطح اجرا استفاده می‌شود.
گزارش‌دهنده نتایج متریک‌هاXML	MetricsXMLResultReporter معیارهای تست را می‌نویسد و معیارها را در یک فایل XML در پوشه‌ای که توسط پارامتر metrics-folder در مرحله invocationEnded تست مشخص شده است، اجرا می‌کند.
ماژول‌شنو	شنونده‌ای به هر `IRemoteTest` از هر ماژول متصل می‌شود تا فهرست نتایج را جمع‌آوری کند.
ماژول‌لاگ‌کت‌کلکتور	نسخه‌ای از جمع‌کننده‌ی logcat اما برای ماژول.
ماژولProtoResultReporter	یک گزارشگر نتیجه قرار بود فقط نتایج سطح ماژول را گزارش دهد.
ماژول نتایج و معیارها	افزونه‌ای از `ResultAndLogForwarder` که معیارهای مرتبط با ماژول اضافی را به نتایج آزمون اضافه می‌کند.
گردآورنده فایل کامل	یک جمع‌کننده که فایل‌های ردیابی بی‌نقص را از دستگاه می‌گیرد، به صورت اختیاری آنها را فشرده می‌کند و به گزارش‌های آزمایشی اضافه می‌کند.
PerfettoGenericPostProcessor	یک پس‌پردازنده که فایل پروتوی متنی/باینری perfetto را با بسط بازگشتی پیام‌ها و فیلدهای پروتو با مقادیر رشته‌ای تا رسیدن به فیلد با مقدار عددی، به جفت‌های کلید-مقدار پردازش می‌کند.
PerfettoPullerMetricCollector	این کلاس منسوخ شده است. به جای آن از `PerfettoFilePullerCollector` و `ERROR(/PerfettoTracePostProcessor)` استفاده کنید.
پردازنده‌ی PerfettoTrace	یک پس‌پردازنده که فایل‌های ردیابی کامل را از گزارش‌های تست بازیابی می‌کند و پردازنده ردیابی را روی آنها اجرا می‌کند تا یک نمونه اولیه متریک کامل تولید کند.
پروتو-ریپورتر	گزارشگر نتایج، یک نمونه `TestRecord` با تمام نتایج درون آن می‌سازد.
RebootReasonCollector	گردآورنده‌ای که ریبوت دستگاه را در طول اجرای آزمایشی جمع‌آوری می‌کند و آنها را با دلیل و تعداد گزارش می‌دهد.
RemoteTestTimeOutEnforcer	شنونده‌هایی که امکان بررسی زمان اجرای یک پیکربندی آزمایشی مشخص را فراهم می‌کنند و در صورت عبور از زمان انقضای مشخص، آن را با شکست مواجه می‌کنند.
گزارش آزمون‌های گذرانده‌شده	فیلترهای ممکن برای حذف تست‌های پذیرفته‌شده را در یک فایل گزارش دهید.
تجمیع‌کننده نتایج	فرستنده ویژه‌ای که نتایج را در صورت نیاز، بر اساس استراتژی تلاش مجدد اتخاذ شده، تجمیع می‌کند.
ResultAndLogForwarder	فوروارد برای نتایج و ثبت رویدادها.
گزارش‌گر نتیجه	گزارشگر نتیجه که نتایج آزمایش را در ResultDB بارگذاری می‌کند.
گزارشگر نتایج
RetryLogSaverResultForwarder	فورواردی که عبور از تلاش فعلی که در آن هستیم را نیز مدیریت می‌کند.
جمع کننده زمان اجراRestart	گردآورنده‌ای که در صورت وجود، مهرهای زمانی راه‌اندازی مجدد زمان اجرا (از کار افتادن سرور سیستم) را در طول اجرای آزمایشی جمع‌آوری می‌کند.
جمع‌کننده‌ی تصویر در هنگام خرابی	گردآورنده‌ای که در صورت عدم موفقیت یک مورد آزمایشی، از آن اسکرین‌شات می‌گیرد و آن را ثبت می‌کند.
ShardListener	یک `ITestInvocationListener` که نتایج را از یک بخش فراخوانی (معروف به یک فراخوانی که برای اجرا روی چندین منبع به صورت موازی تقسیم می‌شود) جمع‌آوری می‌کند و آنها را به شنونده دیگری ارسال می‌کند.
ShardMainResultForwarder	یک `ResultForwarder` که نتایج فراخوانی‌های تست sharded را ترکیب می‌کند.
نمایش نقشهPullerMetricCollector	پیاده‌سازی پایه `FilePullerDeviceMetricCollector` که امکان دریافت فایل‌های showmap از دستگاه و جمع‌آوری معیارها از آن را فراهم می‌کند.
StatsdBeforeAfterGaugeMetricPostProcessor	یک پس‌پردازنده که معیارهای اندازه‌گیری جمع‌آوری‌شده را با رویکرد «قبل/بعد» پردازش می‌کند، یعنی
StatsdEventMetricPostProcessor	یک پس‌پردازنده که معیارهای رویداد را در گزارش‌های statsd به جفت‌های کلید-مقدار، با استفاده از قالب‌بندی‌های مشخص‌شده در پردازنده، پردازش می‌کند.
StatsdGenericPostProcessor	یک پس‌پردازنده که گزارش‌های دودویی proto statsd را با گسترش گزارش به صورت یک ساختار درختی، به جفت‌های کلید-مقدار پردازش می‌کند.
StreamProtoResultReporter	پیاده‌سازی `ProtoResultReporter`
گزارشگر نتایج زیرفرآیند	`ITestInvocationListener` پیاده‌سازی می‌کند تا به عنوان یک result_reporter مشخص شود و نتایج تست‌ها، اجرای تست‌ها و فراخوانی‌های تست را از زیرفرآیند ارسال کند.
سوئیت‌ریستال‌ریپورتر	نتایج آزمایش را برای فراخوانی کل مجموعه جمع‌آوری کرده و نتایج نهایی را ارائه دهید.
گزارشگر نتیجه متن	یک گزارشگر نتایج آزمایش که نتایج را به چاپگر متن نتیجه JUnit ارسال می‌کند.
TraceCmdCollector	یک `IMetricCollector` که با استفاده از trace-cmd در طول تست، ردیابی‌ها را جمع‌آوری کرده و آن‌ها را در فراخوانی ثبت می‌کند.
XmlFormattedGeneratorReporter	پیاده‌سازی `FormattedGeneratorReporter` که نتایج مجموعه را در قالب xml قالب‌بندی می‌کند.
گزارشگر XmlResult	نتایج JUnit را در فایل‌های XML با فرمتی سازگار با XMLJUnitResultFormatter مربوط به Ant می‌نویسد.

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

این به چندین ITestInvocationListener اجازه می‌دهد تا هنگام تولید گزارش‌ها از یک فایل لاگ ذخیره شده استفاده کنند و از ذخیره فایل توسط هر شنونده به صورت جداگانه هنگام فراخوانی 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)` زمانی که گزارش آزمایش ذخیره می‌شود، فراخوانی می‌شود.

روش‌های عمومی

انجمن ورود به سیستم

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` که قبلاً لاگ شده و باید با مورد آزمایشی مرتبط باشد.

تنظیم لاگ سیور

public void setLogSaver (ILogSaver logSaver)

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

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

testLogذخیره شده

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` که شامل متا دیتای فایل ذخیره شده است.