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

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

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

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

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionStateCollector , BluetoothConnectionPostCollectorSuccessRate BugreportCollector ، BugreportzOnFailureCollector ، BugreportzOnTestCaseFailureCollector ، ClangCodeCoverageCollector ، CodeCoverageCollector ، و 80 مورد دیگر.

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 را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند.
CodeCoverageCollector	`BaseDeviceMetricCollector` که جاوا و اندازه گیری های پوشش بومی را از دستگاه خارج می کند و آنها را به عنوان مصنوعات آزمایشی ثبت می کند.
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` از دریافت نتایج گرانول پشتیبانی می کند یا خیر.
ITestInvocationListener	شنونده برای نتایج آزمون از فراخوانی آزمون.
ITestSummaryListener	رابطی که به `ITestInvocationListener` اجازه می دهد تا اطلاعات محدودی را از طریق خلاصه ها مبادله کند.
InvocationProtoResultReporter	گزارشگران برای ذخیره اطلاعات حافظه پنهان سطح فراخوان و لیست ماژول های آن
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	منظور از گزارشگر نتیجه این است که فقط نتایج سطح ماژول را گزارش کند.
Module ResultsAndMetricsForwarder	یک برنامه افزودنی `ResultAndLogForwarder` که معیارهای مرتبط با ماژول اضافی را به نتایج آزمایش اضافه می کند.
NameMangleListener	یک شنونده پروکسی برای ترجمه روش تست، کلاس و نام بسته به عنوان نتایج گزارش می شود.
PassingTestFileReporter	یک `ITestInvocationListener` که لیست موارد آزمایشی را در یک فایل آزمایشی ذخیره می کند
PerfettoGenericPostProcessor	یک پردازشگر پست که فایل متنی/دودویی متریک perfetto proto را با گسترش بازگشتی پیام‌ها و فیلدهای اولیه با مقادیر رشته‌ای تا زمانی که با فیلد با مقدار عددی مواجه شود، به جفت‌های کلید-مقدار پردازش می‌کند.
PerfettoPullerMetricCollector	اجرای پایه `FilePullerDeviceMetricCollector` که اجازه می دهد فایل های perfetto را از دستگاه بیرون بکشید و معیارها را از آن جمع آوری کنید.
PrettyTestEventLogger	Logger که رویدادها را مطابقت می دهد و آنها را ثبت می کند تا اشکال زدایی را آسانتر کند.
ProtoResultReporter	گزارشگر نتیجه یک پروتوباف `TestRecord` با تمام نتایج داخل آن می‌سازد.
PtsBotTest	تست های PTS-bot را اجرا کنید.
PythonBinaryHostTest.PythonForwarder	ارسال کننده نتیجه برای جایگزینی نام اجرا با نام باینری.
RebootReasonCollector	مجموعه‌ای که راه‌اندازی مجدد دستگاه را در طول اجرای آزمایشی جمع‌آوری می‌کند و آنها را با دلیل و شمارش گزارش می‌دهد.
RemoteTestTimeOutEnforcer	شنوندگانی که اجازه می‌دهد زمان اجرای یک پیکربندی آزمایشی معین را بررسی کنند و اگر از یک بازه زمانی معین گذشت، در آن شکست بخورند.
ReportPassedTests	فیلترهای احتمالی را در فایلی گزارش کنید تا آزمون قبولی را حذف کنید.
ResultAggregator	فوروارد ویژه ای که نتایج را در صورت نیاز جمع آوری می کند، بر اساس استراتژی تلاش مجدد که اتخاذ شده است.
ResultAndLogForwarder	فوروارد کننده برای نتایج و گزارش رویدادها.
ResultDBRreporter
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 می‌نویسد.

موجودی که می‌تواند گزارش‌گیری از جریان‌های داده در انواع مختلف را انجام دهد.

خلاصه

روش های عمومی
`default void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.

روش های عمومی

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

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

باید قبل از ERROR(/ITestInvocationListener#invocationFailed(Throwable)) یا ERROR(/ITestInvocationListener#invocationEnded(long)) فراخوانی شود

چارچوب TradeFederation به طور خودکار این روش را فراخوانی می‌کند و گزارش میزبان و در صورت وجود، logcat دستگاه را ارائه می‌کند.

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