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

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

گیرنده چرخه عمر ITest

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

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

AggregatePostProcessor ، AtraceCollector ، AtraceRunMetricCollector ، AveragePostProcessor ، BaseDeviceMetricCollector ، BasePostProcessor ، BluetoothConnectionLatencyCollector ، BluetoothConnectionStateCollector ، BluetoothConnectionSuccessRatePostProcessor ، BluetoothHciSnoopLogCollector ، BugreportCollector ، BugreportzOnFailureCollector ، BugreportzOnTestCaseFailureCollector ، ClangCodeCoverageCollector ، CodeCoverageCollector و ۸۴ مورد دیگر.

پس‌پردازنده تجمیعی	یک تجمیع‌کننده معیار که حداقل، حداکثر، میانگین، واریانس، انحراف معیار، کل، تعداد و در صورت تمایل، صدک‌ها را برای معیارهای عددی جمع‌آوری‌شده در طول اجرای تست‌های چندتکرار ارائه می‌دهد و با آنها به عنوان مقادیر مضاعف رفتار می‌کند.
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 و جمع‌آوری گزارش برای هر آزمایش.
گردآورنده گزارش‌های باگر	یک `ITestInvocationListener` عبوری که گزارش‌های اشکال را هنگام وقوع رویدادهای قابل تنظیم جمع‌آوری می‌کند و سپس پس از جمع‌آوری هر گزارش اشکال `ITestInvocationListener.testLog` را روی فرزندان خود فراخوانی می‌کند.
BugreportzOnFailureCollector	وقتی یک مورد آزمایشی با شکست مواجه می‌شود، یک گزارش اشکال (bugreportz) جمع‌آوری کنید.
BugreportzOnTestCaseFailureCollector	وقتی یک مورد آزمایشی در یک اجرا با شکست مواجه می‌شود، یک گزارش اشکال (bugreportz) جمع‌آوری کنید.
گردآورنده پوشش ClangCode	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش Clang را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
جمع‌کننده کدپوشش	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش جاوا و بومی را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
CollectingTestListener	یک `ITestInvocationListener` که تمام نتایج تست را جمع‌آوری می‌کند.
کنترل‌کننده وضعیت فرمان	هندلری که به نظارت و به‌روزرسانی وضعیت یک فراخوانی کمک می‌کند.
مانیتور وضعیت خرابی	هرگونه خرابی ناشی از فراخوانی را رصد کنید.
ConsoleResultReporter	گزارشگر نتیجه برای چاپ نتایج آزمایش در کنسول.
CountTestCasesCollector	تعداد موارد آزمون را برای یک `IRemoteTest` داده شده بشمارید و گزارش دهید.
CountingTestResultListener	یک `TestResultListener` که تعداد کل تست‌ها را بر اساس `TestStatus` ردیابی می‌کند.
DebugHostLogOnFailureCollector	گردآورنده‌ای که در صورت بروز خطا در یک مورد آزمایشی، گزارش‌های سمت میزبان را جمع‌آوری و ثبت می‌کند.
گزارشگر انتشار دستگاه	گزارشگر آزادسازی دستگاه که ارتباط با فرآیند والدِ دستگاه(هایی) که قرار است آزادسازی شوند را مدیریت می‌کند.
جمع‌کننده‌ی ردیابی دستگاه	گردآورنده‌ای که با شروع یک اجرای آزمایشی، ردیابی بی‌نقص را آغاز می‌کند و در پایان، فایل ردیابی لاگ را ثبت می‌کند.
دستگاه در دسترس نیستمانیتور	این شنونده تلاش می‌کند تا فقط DNAE سطح مورد آزمایشی را ضبط کند.
EventLoggerListener	شنونده‌ای که تمام رویدادهای دریافتی را در یک فایل ثبت می‌کند
FileProtoResultReporter	گزارشگر Proto که `TestRecord` در یک فایل ذخیره می‌کند.
FilePullerDeviceMetricCollector	یک `BaseDeviceMetricCollector` که به کلیدهای معیار دریافتی از دستگاه گوش می‌دهد و آنها را به عنوان یک فایل از دستگاه دریافت می‌کند.
جمع‌کننده‌ی لاگ فایل‌پِلر	ثبت‌کننده‌ی فایل گزارش‌شده توسط دستگاه.
FilteredResultForwarder	گونه‌ای از `ResultForwarder` که فقط اجازه می‌دهد فهرست مجاز `TestDescription` گزارش شود.
FormattedGeneratorReporter	گزارشگری که امکان تولید گزارش‌ها را در قالبی خاص فراهم می‌کند.
GcovCodeCoverageCollector	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش gcov را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
GcovKernelCodeCoverageCollector	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش هسته gcov را از debugfs و خارج از دستگاه استخراج کرده و در نهایت آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
GranularRetriableTestWrapper.StartEndCollector	کمک‌کننده‌ی کلاس برای پیدا کردن شروع و پایان اجرای از دست رفته.
HostStatsdMetricCollector	یک `IMetricCollector` که معیارهای statsd را از سمت میزبان با استفاده از دستورات کاربردی statsd جمع‌آوری می‌کند.
ICommandScheduler.IScheduledInvocationListener	شنونده‌ای برای رویدادهای فراخوانی هنگام اتمام فراخوانی.
ILogSaverListener	به `ITestInvocationListener` اجازه می‌دهد تا به زمان ذخیره شدن فایل‌های لاگ گوش دهند.
جمع‌کننده IMetric	این رابط به عنوان یک دکوراتور هنگام گزارش نتایج آزمایش‌ها اضافه می‌شود تا معیارهای منطبق را جمع‌آوری کند.
IPostProcessor	پردازنده‌های پس از آزمایش (Post processors) یک شیء از فدراسیون تجاری (Trade Federation) است که برای پردازش معیارها و گزارش‌ها پس از آزمایش‌ها و قبل از گزارش نتایج در نظر گرفته شده است.
IShardableListener	یک `ITestInvocationListener` که می‌تواند تقسیم‌بندی شود.
نتایج پشتیبانی‌شده با گرانول	رابطی که مشخص می‌کند آیا یک `ITestInvocationListener` از دریافت نتایج جزئی پشتیبانی می‌کند یا خیر.
ITestInvocationListener	شنونده نتایج آزمایش از فراخوانی تست.
ITestSummaryListener	رابطی که به `ITestInvocationListener` اجازه می‌دهد تا برخی اطلاعات محدود را از طریق خلاصه‌ها رد و بدل کند.
InvocationProtoResultReporter	گزارشگران برای ذخیره اطلاعات ذخیره‌سازی سطح فراخوانی و لیست ماژول‌های آن
فراخوانی به واحد نتیجه (InvocationToJUnitResultForwarder)	کلاسی که به رویدادهای `ITestInvocationListener` گوش می‌دهد و آنها را به `TestListener` ارسال می‌کند.
JarHostTest.HostTestListener	شنونده‌ی پوششی که تمام رویدادها به جز testRunStarted() و testRunEnded() را به شنونده‌ی تعبیه‌شده ارسال می‌کند.
جمع‌کننده‌ی پوشش جاواکد	یک `BaseDeviceMetricCollector` که اندازه‌گیری‌های پوشش جاوا را از دستگاه استخراج کرده و آنها را به عنوان مصنوعات آزمایشی ثبت می‌کند.
JsonHttpTestResultReporter	یک گزارشگر نتیجه که نتایج معیارهای تست و شاخه، اطلاعات دستگاه را به JSON و POST به یک نقطه پایانی سرویس HTTP رمزگذاری می‌کند.
گزارشگر نتیجه لوسیفر	یک گزارشگر نتیجه که نتایج تست مورد نیاز ResultDB و LUCI را در قالب JSON (go/result-sink) ذخیره می‌کند و محل فایل را در کنسول ثبت می‌کند.
آشکارساز آخرین‌شارد	هنگام اجرای شاردینگ محلی، گاهی اوقات می‌خواهیم فقط زمانی که آخرین شارد به `invocationEnded(long)` می‌رسد، برخی اقدامات را اجرا کنیم.
LegacySubprocessResultsReporter	یک پیاده‌سازی متوقف‌شده از گزارشگر نتایج زیرفرآیند که باید با وجود تغییرات در سوپرکلاس خود، با نسخه‌های قبلی TF/CTS (مثلاً ۸+) سازگار باقی بماند.
لاگ سیور ریسل فورواردر	یک `ResultForwarder` برای ذخیره لاگ‌ها با استفاده از ذخیره‌کننده فایل سراسری.
LogcatCrashResultForwarder	شنونده ویژه: در صورت بروز خطا (خرابی فرآیند ابزار دقیق)، سعی می‌کند خطای رخ داده را از لاگ‌کت استخراج کرده و آن را به پیام خطای مرتبط با تست اضافه کند.
گردآورنده لاگ‌کت‌آن‌فایلور	گردآورنده‌ای که در صورت عدم موفقیت یک مورد آزمایشی، یک logcat را ضبط و ثبت می‌کند.
LogcatTimingMetricCollector	یک جمع‌کننده‌ی متریک که اطلاعات زمان‌بندی (مثلاً زمان سوئیچ کاربر) را از logcat در طول یک یا چند تست تکراری با استفاده از الگوهای regex داده شده برای تجزیه سیگنال‌های شروع و پایان یک رویداد از خطوط logcat جمع‌آوری می‌کند.
پس‌پردازنده‌ی فایل متریک	برای آپلود فایل گزارش معیارهای جمع‌آوری‌شده در طول تست و سطح اجرا استفاده می‌شود.
گزارش‌دهنده نتایج متریک‌هاXML	MetricsXMLResultReporter معیارهای تست را می‌نویسد و معیارها را در یک فایل XML در پوشه‌ای که توسط پارامتر metrics-folder در مرحله invocationEnded تست مشخص شده است، اجرا می‌کند.
ماژول‌شنو	شنونده‌ای به هر `IRemoteTest` از هر ماژول متصل می‌شود تا فهرست نتایج را جمع‌آوری کند.
ماژول‌لاگ‌کت‌کلکتور	نسخه‌ای از جمع‌کننده‌ی logcat اما برای ماژول.
ماژولProtoResultReporter	یک گزارشگر نتیجه قرار بود فقط نتایج سطح ماژول را گزارش دهد.
ماژول نتایج و معیارها	افزونه‌ای از `ResultAndLogForwarder` که معیارهای مرتبط با ماژول اضافی را به نتایج آزمون اضافه می‌کند.
نامMangleListener	یک شنونده پروکسی برای ترجمه نام متد تست، کلاس و بسته به عنوان نتایج گزارش شده.
عبور از TestFileReporter	یک `ITestInvocationListener` که لیست موارد تست پذیرفته شده را در یک فایل تست ذخیره می‌کند.
گردآورنده فایل کامل	یک جمع‌کننده که فایل‌های ردیابی بی‌نقص را از دستگاه می‌گیرد، به صورت اختیاری آنها را فشرده می‌کند و به گزارش‌های آزمایشی اضافه می‌کند.
PerfettoGenericPostProcessor	یک پس‌پردازنده که فایل پروتوی متنی/باینری perfetto را با بسط بازگشتی پیام‌ها و فیلدهای پروتو با مقادیر رشته‌ای تا رسیدن به فیلد با مقدار عددی، به جفت‌های کلید-مقدار پردازش می‌کند.
PerfettoPullerMetricCollector	این کلاس منسوخ شده است. به جای آن از `PerfettoFilePullerCollector` و `ERROR(/PerfettoTracePostProcessor)` استفاده کنید.
پردازنده‌ی PerfettoTrace	یک پس‌پردازنده که فایل‌های ردیابی کامل را از گزارش‌های تست بازیابی می‌کند و پردازنده ردیابی را روی آنها اجرا می‌کند تا یک نمونه اولیه متریک کامل تولید کند.
PrettyTestEventLogger	ثبت وقایع و ثبت آنها توسط یک logger به منظور آسان‌تر کردن اشکال‌زدایی.
پروتو-ریپورتر	گزارشگر نتایج، یک نمونه `TestRecord` با تمام نتایج درون آن می‌سازد.
پایتونBinaryHostTest.PythonForwarder	فرستنده‌ی نتیجه، نام اجرا را با نام دودویی جایگزین می‌کند.
RebootReasonCollector	گردآورنده‌ای که ریبوت دستگاه را در طول اجرای آزمایشی جمع‌آوری می‌کند و آنها را با دلیل و تعداد گزارش می‌دهد.
RemoteTestTimeOutEnforcer	شنونده‌هایی که امکان بررسی زمان اجرای یک پیکربندی آزمایشی مشخص را فراهم می‌کنند و در صورت عبور از زمان انقضای مشخص، آن را با شکست مواجه می‌کنند.
گزارش آزمون‌های گذرانده‌شده	فیلترهای ممکن برای حذف تست‌های پذیرفته‌شده را در یک فایل گزارش دهید.
تجمیع‌کننده نتایج	فرستنده ویژه‌ای که نتایج را در صورت نیاز، بر اساس استراتژی تلاش مجدد اتخاذ شده، تجمیع می‌کند.
ResultAndLogForwarder	فوروارد برای نتایج و ثبت رویدادها.
گزارش‌گر نتیجه	گزارشگر نتیجه که نتایج آزمایش را در ResultDB بارگذاری می‌کند.
نتیجه‌فرستنده	یک `ITestInvocationListener` که نتایج فراخوانی را به لیستی از شنوندگان دیگر ارسال می‌کند.
گزارشگر نتایج
RetryLogSaverResultForwarder	فورواردی که عبور از تلاش فعلی که در آن هستیم را نیز مدیریت می‌کند.
RetryResultForwarder	افزونه‌ای از `ResultForwarder` که همیشه به تعداد تلاش مشخصی ارسال می‌کند.
جمع کننده زمان اجراRestart	گردآورنده‌ای که در صورت وجود، مهرهای زمانی راه‌اندازی مجدد زمان اجرا (از کار افتادن سرور سیستم) را در طول اجرای آزمایشی جمع‌آوری می‌کند.
جمع‌کننده‌ی تصویر در هنگام خرابی	گردآورنده‌ای که در صورت عدم موفقیت یک مورد آزمایشی، از آن اسکرین‌شات می‌گیرد و آن را ثبت می‌کند.
ShardListener	یک `ITestInvocationListener` که نتایج را از یک بخش فراخوانی (معروف به یک فراخوانی که برای اجرا روی چندین منبع به صورت موازی تقسیم می‌شود) جمع‌آوری می‌کند و آنها را به شنونده دیگری ارسال می‌کند.
ShardMainResultForwarder	یک `ResultForwarder` که نتایج فراخوانی‌های تست sharded را ترکیب می‌کند.
نمایش نقشهPullerMetricCollector	پیاده‌سازی پایه `FilePullerDeviceMetricCollector` که امکان دریافت فایل‌های showmap از دستگاه و جمع‌آوری معیارها از آن را فراهم می‌کند.
StatsdBeforeAfterGaugeMetricPostProcessor	یک پس‌پردازنده که معیارهای اندازه‌گیری جمع‌آوری‌شده را با رویکرد «قبل/بعد» پردازش می‌کند، یعنی
StatsdEventMetricPostProcessor	یک پس‌پردازنده که معیارهای رویداد را در گزارش‌های statsd به جفت‌های کلید-مقدار، با استفاده از قالب‌بندی‌های مشخص‌شده در پردازنده، پردازش می‌کند.
StatsdGenericPostProcessor	یک پس‌پردازنده که گزارش‌های دودویی proto statsd را با گسترش گزارش به صورت یک ساختار درختی، به جفت‌های کلید-مقدار پردازش می‌کند.
StreamProtoResultReporter	پیاده‌سازی `ProtoResultReporter`
گزارشگر نتایج زیرفرآیند	`ITestInvocationListener` پیاده‌سازی می‌کند تا به عنوان یک result_reporter مشخص شود و نتایج تست‌ها، اجرای تست‌ها و فراخوانی‌های تست را از زیرفرآیند ارسال کند.
سوئیت‌ریستال‌ریپورتر	نتایج آزمایش را برای فراخوانی کل مجموعه جمع‌آوری کرده و نتایج نهایی را ارائه دهید.
شنونده‌ی نتیجه‌ی آزمون (TestResultListener)	ساده‌سازی ITestLifecycleListener برای پیاده‌سازی‌هایی که فقط به نتایج تست‌های فردی اهمیت می‌دهند.
TestRunResultListener	شنونده‌ای که امکان خواندن وضعیت نهایی اجرای تست را فراهم می‌کند.
TestTimeoutEnforcer	شنونده‌هایی که امکان بررسی زمان اجرای یک مورد آزمایشی مشخص را فراهم می‌کنند و در صورت عبور از زمان انقضای مشخص، آن را با شکست مواجه می‌کنند.
گزارشگر نتیجه متن	یک گزارشگر نتایج آزمایش که نتایج را به چاپگر متن نتیجه JUnit ارسال می‌کند.
TraceCmdCollector	یک `IMetricCollector` که با استفاده از trace-cmd در طول تست، ردیابی‌ها را جمع‌آوری کرده و آن‌ها را در فراخوانی ثبت می‌کند.
TradefedSandboxRunner.StubScheduledInvocationListener	یک `IScheduledInvocationListener` که هیچ کاری انجام نمی‌دهد.
XmlFormattedGeneratorReporter	پیاده‌سازی `FormattedGeneratorReporter` که نتایج مجموعه را در قالب xml قالب‌بندی می‌کند.
گزارشگر XmlResult	نتایج JUnit را در فایل‌های XML با فرمتی سازگار با XMLJUnitResultFormatter مربوط به Ant می‌نویسد.

در طول اجرای تست‌های ابزار دقیق، اعلان‌های رویداد را دریافت می‌کند.

الگوبرداری شده از org.junit.runner.notification.RunListener

توالی تماس‌ها به این صورت خواهد بود:

تست شروع شد
تست شروع شد
[آزمون ناموفق]
[testAssumptionFailure]
[آزمون نادیده گرفته شد]
آزمون پایان یافت
....
[testRunFailed]
تست اجرا شده

خلاصه

روش‌های عمومی
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` جایگزینی برای `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` که در آن می‌توانیم زمان پایان را مستقیماً مشخص کنیم.
`default void`	`testEnded ( TestDescription test, testMetrics)` پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.
`default void`	`testFailed ( TestDescription test, FailureDescription failure)` گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.
`default void`	`testFailed ( TestDescription test, String trace)` گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.
`default void`	`testIgnored ( TestDescription test)` زمانی فراخوانی می‌شود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیه‌نویسی شده است.
`default void`	`testRunEnded (long elapsedTimeMillis, runMetrics)` پایان اجرای آزمایش را گزارش می‌دهد.
`default void`	`testRunFailed ( FailureDescription failure)` گزارش می‌دهد که اجرای آزمایشی به دلیل خرابی شرح داده شده توسط `FailureDescription` ، با شکست مواجه شده است.
`default void`	`testRunFailed (String errorMessage)` گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber)` شروع یک آزمایش را گزارش می‌دهد.
`default void`	`testRunStarted (String runName, int testCount)` شروع یک آزمایش را گزارش می‌دهد.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` شروع یک آزمایش را گزارش می‌دهد.
`default void`	`testRunStopped (long elapsedTime)` گزارش می‌دهد که اجرای آزمایشی به دلیل درخواست کاربر قبل از تکمیل متوقف شده است.
`default void`	`testSkipped ( TestDescription test, SkipReason reason)` زمانی فراخوانی می‌شود که یک تست نادیده گرفته شده و به دلیلی که معمولاً انتظار نمی‌رود، اجرا نشده است.
`default void`	`testStarted ( TestDescription test, long startTime)` جایگزینی برای `testStarted(com.android.tradefed.result.TestDescription)` که در آن زمان شروع تست را نیز مشخص می‌کنیم، و برای اندازه‌گیری دقیق‌تر با `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` ترکیب می‌شود.
`default void`	`testStarted ( TestDescription test)` شروع یک مورد آزمایشی (test case) منفرد را گزارش می‌دهد.

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

آزمون فرض شکست

public void testAssumptionFailure (TestDescription test, 
                String trace)

زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`trace`	`String` : ردپای پشته از خرابی

آزمون فرض شکست

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`failure`	`FailureDescription` : `FailureDescription` خرابی و زمینه آن را توصیف می‌کند.

آزمون پایان یافت

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

جایگزینی برای ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) که در آن می‌توانیم زمان پایان را مستقیماً مشخص کنیم. برای اندازه‌گیری دقیق‌تر، با testStarted(com.android.tradefed.result.TestDescription, long) ترکیب کنید.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`endTime`	`long` : زمان پایان تست، که از طریق `System.currentTimeMillis()` اندازه‌گیری می‌شود.
`testMetrics`	: یک `ERROR(/Map)` از معیارهای منتشر شده

آزمون پایان یافت

public void testEnded (TestDescription test, 
                 testMetrics)

پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.

اگر testFailed(TestDescription, FailureDescription) فراخوانی نشده باشد، این تست با موفقیت انجام شده است. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد تست منتشر شده باشد، برمی‌گرداند.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`testMetrics`	: یک `ERROR(/Map)` از معیارهای منتشر شده

تست ناموفق

public void testFailed (TestDescription test, 
                FailureDescription failure)

گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.

بین testStarted و testEnded فراخوانی خواهد شد.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`failure`	`FailureDescription` : `FailureDescription` خرابی و زمینه آن را توصیف می‌کند.

تست ناموفق

public void testFailed (TestDescription test, 
                String trace)

گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.

بین testStarted و testEnded فراخوانی خواهد شد.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`trace`	`String` : ردپای پشته از خرابی

آزمون نادیده گرفته شد

public void testIgnored (TestDescription test)

زمانی فراخوانی می‌شود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیه‌نویسی شده است.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.

تست اجرا شده

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

پایان اجرای آزمایش را گزارش می‌دهد.

پارامترها
`elapsedTimeMillis`	`long` : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه
`runMetrics`	جفت‌های کلید-مقدار که در پایان اجرای تست گزارش می‌شوند

تست اجرا ناموفق

public void testRunFailed (FailureDescription failure)

گزارش می‌دهد که اجرای آزمایشی به دلیل خرابی شرح داده شده توسط FailureDescription ، با شکست مواجه شده است.

پارامترها
`failure`	`FailureDescription` : `FailureDescription` خرابی و زمینه آن را توصیف می‌کند.

تست اجرا ناموفق

public void testRunFailed (String errorMessage)

گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.

پارامترها
`errorMessage`	`String` : `String` دلیل عدم موفقیت در اجرا را توصیف می‌کند.

تست شروع شد

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
`runName`	`String` : نام اجرای آزمایشی
`testCount`	`int` : تعداد کل تست‌ها در اجرای تست
`attemptNumber`	`int` : شماره ترتیب، که تلاش‌های مختلف یک runName را که چندین بار اجرا شده‌اند، مشخص می‌کند. شماره تلاش با اندیس ۰ اندیس‌گذاری شده است و باید هر بار که یک اجرای جدید اتفاق می‌افتد، افزایش یابد. به عنوان مثال، یک تست ۳ بار به صورت جزئی تکرار می‌شود، باید ۴ بار در کل تحت یک runName اجرا شود و شماره تلاش از ۰ تا ۳ است.

تست شروع شد

public void testRunStarted (String runName, 
                int testCount)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
`runName`	`String` : نام اجرای آزمایشی
`testCount`	`int` : تعداد کل تست‌ها در اجرای تست

تست شروع شد

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
`runName`	`String` : نام اجرای آزمایشی
`testCount`	`int` : تعداد کل تست‌ها در اجرای تست
`attemptNumber`	`int` : شماره ترتیب، که تلاش‌های مختلف یک runName را که چندین بار اجرا شده‌اند، مشخص می‌کند. شماره تلاش با اندیس ۰ اندیس‌گذاری شده است و باید هر بار که یک اجرای جدید اتفاق می‌افتد، افزایش یابد. به عنوان مثال، یک تست ۳ بار به صورت جزئی تکرار می‌شود، باید ۴ بار در کل تحت یک runName اجرا شود و شماره تلاش از ۰ تا ۳ است.
`startTime`	`long` : زمان شروع اجرا، که از طریق `System.currentTimeMillis()` اندازه‌گیری می‌شود.

testRunStopped

public void testRunStopped (long elapsedTime)

گزارش می‌دهد که اجرای آزمایشی به دلیل درخواست کاربر قبل از تکمیل متوقف شده است.

TODO: در حال حاضر استفاده نشده، حذف را در نظر بگیرید

پارامترها
`elapsedTime`	`long` : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه

آزمون رد شد

public void testSkipped (TestDescription test, 
                SkipReason reason)

زمانی فراخوانی می‌شود که یک تست نادیده گرفته شده و به دلیلی که معمولاً انتظار نمی‌رود، اجرا نشده باشد. این تست‌ها برای اجرای مجدد تلاش خواهند کرد تا به طور صحیح اجرا شوند.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`reason`	`SkipReason` : `SkipReason`

تست شروع شد

public void testStarted (TestDescription test, 
                long startTime)

جایگزینی برای testStarted(com.android.tradefed.result.TestDescription) که در آن زمان شروع تست را نیز مشخص می‌کنیم، و برای اندازه‌گیری دقیق‌تر با ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) ترکیب می‌شود.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.
`startTime`	`long` : زمان شروع تست، که از طریق `System.currentTimeMillis()` اندازه‌گیری می‌شود.

تست شروع شد

public void testStarted (TestDescription test)

شروع یک مورد آزمایشی (test case) را گزارش می‌دهد. رابط قدیمی‌تر، باید در صورت امکان testStarted(com.android.tradefed.result.TestDescription) استفاده کند.

پارامترها
`test`	`TestDescription` : تست را مشخص می‌کند.