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

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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver , ITestLogger

com.android.tradefed.result.ITestInvocationListener

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

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

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