CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable , ILogSaverListener , ITestInvocationListener

شیء جاوا
↳ com.android.tradefed.result.CollectingTestListener

یک ITestInvocationListener که تمام نتایج تست را جمع‌آوری می‌کند.

اگرچه ساختارهای داده مورد استفاده در این شیء thread-safe هستند، فراخوانی‌های ITestInvocationListener باید به ترتیب صحیح فراخوانی شوند.

خلاصه

سازندگان عمومی

CollectingTestListener ()

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

IBuildInfo getBuildInfo ()

این متد منسوخ شده است. به IBuildInfo از getInvocationContext() تکیه کنید.

TestRunResult getCurrentRunResults ()

نتایج مربوط به اجرای آزمایشی فعلی را دریافت می‌کند.

int getExpectedTests ()

تعداد تست‌های مورد انتظار را برمی‌گرداند.

IInvocationContext getInvocationContext ()

زمینه فراخوانی که از طریق invocationStarted(com.android.tradefed.invoker.IInvocationContext) گزارش شده است را برمی‌گرداند.

getMergedTestRunResults ()

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

IInvocationContext getModuleContextForRunResult (String testRunName)

IInvocationContext ماژول مرتبط با نتایج را برمی‌گرداند.

MultiMap <String, LogFile > getModuleLogFiles ()

یک کپی از نقشه حاوی تمام فایل‌های ثبت‌شده مرتبط با ماژول را برمی‌گرداند.

MultiMap <String, LogFile > getNonAssociatedLogFiles ()

یک کپی از نقشه حاوی تمام فایل‌های ثبت‌شده‌ای که با اجرای آزمایشی یا ماژول مرتبط نیستند را برمی‌گرداند.

int getNumAllFailedTestRuns ()

تعداد کل تست‌های اجرا شده در حالت شکست را برمی‌گرداند

int getNumAllFailedTests ()

تعداد کل تست‌ها را در حالت شکست برمی‌گرداند (فقط تست‌های شکست‌خورده، شکست‌های فرضی در آن محاسبه نمی‌شوند).

int getNumTestsInState ( TestStatus status)

تعداد تست‌های انجام شده در حالت داده شده برای این اجرا را برمی‌گرداند.

int getNumTestsInState ( TestResult.TestStatus ddmlibStatus)

برای سازگاری با نوع وضعیت قدیمی‌تر

int getNumTotalTests ()

تعداد کل تست‌های کامل را برای همه اجراها برمی‌گرداند.

IBuildInfo getPrimaryBuildInfo ()

اطلاعات ساخت اولیه که از طریق invocationStarted(com.android.tradefed.invoker.IInvocationContext) گزارش شده است را برمی‌گرداند.

getRunResults ()

این متد منسوخ شده است. getMergedTestRunResults() استفاده کنید.

TestRunResult getTestRunAtAttempt (String testRunName, int attempt)

برای یک تلاش، TestRunResult را برمی‌گرداند.

int getTestRunAttemptCount (String testRunName)

تعداد تلاش‌ها برای یک نام اجرای آزمایشی مشخص را برمی‌گرداند.

getTestRunAttempts (String testRunName)

تمام تلاش‌ها برای یک TestRunResult از یک اجرای آزمایشی مشخص را دریافت می‌کند.

getTestRunForAttempts (int attempt)

تمام نتایج مربوط به یک تلاش مشخص را دریافت می‌کند.

getTestRunNames ()

تمام نام‌های مربوط به تمام اجراهای آزمایشی را برمی‌گرداند.

boolean hasFailedTests ()

اگر فراخوانی، تست‌های ناموفق یا تست‌های فرض ناموفق داشته باشد، آن را برمی‌گرداند.

boolean hasTestRunResultsForName (String testRunName)

برمی‌گرداند که آیا نام اجرای آزمایشی داده شده، نتیجه‌ای دارد یا خیر.

void invocationEnded (long elapsedTime)

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

void invocationFailed (Throwable cause)

به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.

void invocationSkipped ( SkipReason reason)

یک فراخوانی را به عنوان رد شده گزارش می‌دهد

void invocationStarted ( IInvocationContext context)

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

boolean isDisabled ()

اگر کل شیء غیرفعال باشد (از هر دو مرحله راه‌اندازی و جداسازی صرف نظر شود)، مقدار True برمی‌گرداند.

void logAssociation (String dataName, LogFile logFile)

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

void setBuildInfo ( IBuildInfo buildInfo)

این روش منسوخ شده است. دیگر برای آزمایش لازم نیست.

void setDisable (boolean isDisabled)

تعیین می‌کند که آیا شیء باید غیرفعال شود یا خیر.

void setMergeStrategy ( MergeStrategy strategy)

MergeStrategy را برای استفاده هنگام ادغام نتایج تنظیم می‌کند.

void testAssumptionFailure ( TestDescription test, String trace)

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

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

void testEnded ( TestDescription test, long endTime, testMetrics)

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

void testEnded ( TestDescription test, testMetrics)

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

void testFailed ( TestDescription test, FailureDescription failure)

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

void testFailed ( TestDescription test, String trace)

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

void testIgnored ( TestDescription test)

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

void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می‌دهد.

void testModuleStarted ( IInvocationContext moduleContext)

شروع اجرای یک ماژول را گزارش می‌دهد.

void testRunEnded (long elapsedTime, runMetrics)

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

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String errorMessage)

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

void testRunStarted (String name, int numTests, int attemptNumber)

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

void testRunStarted (String name, int numTests)

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

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

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

void testRunStopped (long elapsedTime)

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

void testSkipped ( TestDescription test, SkipReason reason)

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

void testStarted ( TestDescription test, long startTime)

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

void testStarted ( TestDescription test)

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

روش‌های محافظت‌شده

final void clearModuleLogFiles ()

امکان تمیز کردن فایل ماژول را فراهم می‌کند تا از حمل طولانی مدت آنها جلوگیری کنیم.

final void clearResultsForName (String testRunName)

اجازه می‌دهد نتایج را برای یک نام اجرای مشخص پاک کنید.

final void clearTestRunResults ()

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

void setIsAggregrateMetrics (boolean aggregate)

گزینه «معیارهای تجمیع‌شده» را فعال یا غیرفعال کنید

سازندگان عمومی

CollectingTestListener 

public CollectingTestListener ()

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

اطلاعات ساخت را دریافت کنید 

public IBuildInfo getBuildInfo ()

این روش منسوخ شده است.
به IBuildInfo از getInvocationContext() تکیه کنید.

اطلاعات ساخت را برمی‌گرداند.

بازگشت‌ها
IBuildInfo

نتایج اجرای فعلی را دریافت کنید 

public TestRunResult getCurrentRunResults ()

نتایج مربوط به اجرای آزمایشی فعلی را دریافت می‌کند.

توجه داشته باشید که نتایج ممکن است کامل نباشند. توصیه می‌شود قبل از پردازش نتایج، مقدار TestRunResult.isRunComplete() و/یا (@link TestRunResult#isRunFailure()} را به طور مناسب آزمایش کنید.

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

دریافت تست‌های مورد انتظار 

public int getExpectedTests ()

تعداد تست‌های مورد انتظار را برمی‌گرداند. اگر برخی از تست‌ها اجرا نشوند، می‌تواند با getNumTotalTests() متفاوت باشد.

بازگشت‌ها
int

دریافتInvocationContext 

public IInvocationContext getInvocationContext ()

زمینه فراخوانی که از طریق invocationStarted(com.android.tradefed.invoker.IInvocationContext) گزارش شده است را برمی‌گرداند.

بازگشت‌ها
IInvocationContext

نتایج GetMergedTestRun 

public  getMergedTestRunResults ()

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

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

معیارهای مربوط به یک تلاش مشابه بر اساس اولویت تعیین شده توسط aggregate-metrics ادغام خواهند شد. معیارهای نهایی، معیارهای آخرین تلاش خواهند بود.

بازگشت‌ها

دریافت ماژولContextForRunResult 

public IInvocationContext getModuleContextForRunResult (String testRunName)

IInvocationContext ماژول مرتبط با نتایج را برمی‌گرداند.

پارامترها
testRunName String : نامی که توسط { testRunStarted(String, int) داده شده است.

بازگشت‌ها
IInvocationContext IInvocationContext ماژول برای یک نام اجرای آزمایشی مشخص، در صورتی که هیچ نتیجه‌ای برای آن نام وجود نداشته باشد، null .

دریافت فایل‌های لاگ ماژول 

public MultiMap<String, LogFile> getModuleLogFiles ()

یک کپی از نقشه حاوی تمام فایل‌های ثبت‌شده مرتبط با ماژول را برمی‌گرداند.

بازگشت‌ها
MultiMap <String, LogFile >

دریافت فایل‌های لاگ غیر مرتبط 

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

یک کپی از نقشه حاوی تمام فایل‌های ثبت‌شده‌ای که با اجرای آزمایشی یا ماژول مرتبط نیستند را برمی‌گرداند.

بازگشت‌ها
MultiMap <String, LogFile >

دریافت تعداد همه تست‌های ناموفق 

public int getNumAllFailedTestRuns ()

تعداد کل تست‌های اجرا شده در حالت شکست را برمی‌گرداند

بازگشت‌ها
int

دریافت تعداد همه تست‌های ناموفق 

public int getNumAllFailedTests ()

تعداد کل تست‌ها را در حالت شکست برمی‌گرداند (فقط تست‌های شکست‌خورده، شکست‌های فرضی در آن محاسبه نمی‌شوند).

بازگشت‌ها
int

دریافتNumTestsInState 

public int getNumTestsInState (TestStatus status)

تعداد تست‌های انجام شده در حالت داده شده برای این اجرا را برمی‌گرداند.

پارامترها
status TestStatus

بازگشت‌ها
int

دریافتNumTestsInState 

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

برای سازگاری با نوع وضعیت قدیمی‌تر

پارامترها
ddmlibStatus TestResult.TestStatus

بازگشت‌ها
int

getNumTotalTests 

public int getNumTotalTests ()

تعداد کل تست‌های کامل را برای همه اجراها برمی‌گرداند.

بازگشت‌ها
int

دریافت اطلاعات اولیه ساخت 

public IBuildInfo getPrimaryBuildInfo ()

اطلاعات ساخت اولیه که از طریق invocationStarted(com.android.tradefed.invoker.IInvocationContext) گزارش شده است را برمی‌گرداند. ساخت اولیه، ساختی است که توسط اولین ارائه‌دهنده ساخت پیکربندی در حال اجرا برگردانده می‌شود. در صورت عدم وجود زمینه (عدم ساخت برای مورد آزمایشی)، مقدار null را برمی‌گرداند.

بازگشت‌ها
IBuildInfo

نتایج اجرای دریافت‌شده 

public  getRunResults ()

این روش منسوخ شده است.
از getMergedTestRunResults() استفاده کنید.

نتایج مربوط به تمام تست‌های اجرا شده را برمی‌گرداند.

بازگشت‌ها

دریافت تلاش برای اجرای تست 

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

برای یک تلاش، TestRunResult را برمی‌گرداند.

پارامترها
testRunName String : نامی که توسط { testRunStarted(String, int) داده شده است.

attempt int : شناسه‌ی تلاش.

بازگشت‌ها
TestRunResult TestRunResult برای نام داده شده و شناسه تلاش یا در صورت عدم وجود null .

تعداد دفعات تلاش برای اجرای تست (getTestRunAttemptCount) 

public int getTestRunAttemptCount (String testRunName)

تعداد تلاش‌ها برای یک نام اجرای آزمایشی مشخص را برمی‌گرداند.

پارامترها
testRunName String : نامی که توسط { testRunStarted(String, int) داده شده است.

بازگشت‌ها
int

دریافت تلاش برای اجرای تست 

public  getTestRunAttempts (String testRunName)

تمام تلاش‌ها برای یک TestRunResult از یک اجرای آزمایشی مشخص را دریافت می‌کند.

پارامترها
testRunName String : نامی که توسط { testRunStarted(String, int) داده شده است.

بازگشت‌ها
تمام TestRunResult برای یک اجرای آزمایشی مشخص، که بر اساس تعداد دفعات انجام آن مرتب شده‌اند.

دریافت تست اجرای تلاش‌ها 

public  getTestRunForAttempts (int attempt)

تمام نتایج مربوط به یک تلاش مشخص را دریافت می‌کند.

پارامترها
attempt int : تلاشی که نتایج آن را می‌خواهیم.

بازگشت‌ها
تمام TestRunResult برای یک تلاش معین.

نام‌های اجرای تست را دریافت کنید 

public  getTestRunNames ()

تمام نام‌های مربوط به تمام اجراهای آزمایشی را برمی‌گرداند.

این آزمایش‌ها ممکن است چندین بار با تلاش‌های مختلف اجرا شده باشند.

بازگشت‌ها

تست‌های ناموفق 

public boolean hasFailedTests ()

اگر فراخوانی، تست‌های ناموفق یا تست‌های فرض ناموفق داشته باشد، آن را برمی‌گرداند.

بازگشت‌ها
boolean

hasTestRunResultsForName 

public boolean hasTestRunResultsForName (String testRunName)

برمی‌گرداند که آیا نام اجرای آزمایشی داده شده، نتیجه‌ای دارد یا خیر.

پارامترها
testRunName String : نامی که توسط { testRunStarted(String, int) داده شده است.

بازگشت‌ها
boolean

فراخوان پایان یافت 

public void invocationEnded (long elapsedTime)

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

به طور خودکار توسط چارچوب TradeFederation فراخوانی خواهد شد.

پارامترها
elapsedTime long : زمان سپری شده از فراخوانی بر حسب میلی‌ثانیه

فراخوانی ناموفق 

public void invocationFailed (Throwable cause)

به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی خواهد شد.

پارامترها
cause Throwable : علت Throwable خرابی

فراخوانی رد شد 

public void invocationSkipped (SkipReason reason)

یک فراخوانی را به عنوان رد شده گزارش می‌دهد

پارامترها
reason SkipReason

فراخوان شروع شد 

public void invocationStarted (IInvocationContext context)

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

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

پارامترها
context IInvocationContext : اطلاعاتی درباره فراخوانی

غیرفعال شده است 

public boolean isDisabled ()

اگر کل شیء غیرفعال باشد (از هر دو مرحله راه‌اندازی و جداسازی صرف نظر شود)، مقدار True برمی‌گرداند. در غیر این صورت، مقدار False برمی‌گرداند.

بازگشت‌ها
boolean

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

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 setBuildInfo (IBuildInfo buildInfo)

این روش منسوخ شده است.
دیگه برای آزمایش لازم نیست.

اطلاعات ساخت را تنظیم کنید. فقط باید برای آزمایش استفاده شود.

پارامترها
buildInfo IBuildInfo

غیرفعال کردن 

public void setDisable (boolean isDisabled)

تعیین می‌کند که آیا شیء باید غیرفعال شود یا خیر. غیرفعال به این معنی است که هر دو مرحله راه‌اندازی و جداسازی باید نادیده گرفته شوند. می‌توان از آن برای غیرفعال کردن پیش‌فرض یک شیء در سازنده پیش‌فرض استفاده کرد.

پارامترها
isDisabled boolean : حالتی که شیء باید در آن قرار گیرد.

استراتژی setMerge 

public void setMergeStrategy (MergeStrategy strategy)

MergeStrategy را برای استفاده هنگام ادغام نتایج تنظیم می‌کند.

پارامترها
strategy MergeStrategy

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

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 : تست را مشخص می‌کند.

testModuleEnd 

public void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می‌دهد.

ماژول تست شروع شد 

public void testModuleStarted (IInvocationContext moduleContext)

شروع اجرای یک ماژول را گزارش می‌دهد. این فراخوانی با testModuleEnded() مرتبط است و در دنباله اختیاری است. فقط در طول اجرایی که از اجراکننده‌های مبتنی بر modules: suite استفاده می‌کند، استفاده می‌شود.

پارامترها
moduleContext IInvocationContext : همان IInvocationContext مربوط به ماژول است.

تست اجرا شده 

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics جفت‌های کلید-مقدار که در پایان اجرای تست گزارش می‌شوند

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

public void testRunFailed (FailureDescription failure)

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

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

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

public void testRunFailed (String errorMessage)

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

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

تست شروع شد 

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

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

پارامترها
name String : نام اجرای آزمایشی

numTests int : تعداد کل تست‌ها در اجرای تست

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

تست شروع شد 

public void testRunStarted (String name, 
                int numTests)

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

پارامترها
name String : نام اجرای آزمایشی

numTests int : تعداد کل تست‌ها در اجرای تست

تست شروع شد 

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

پارامترها
name String : نام اجرای آزمایشی

numTests 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 : تست را مشخص می‌کند.

روش‌های محافظت‌شده

clearModuleLogFiles 

protected final void clearModuleLogFiles ()

امکان تمیز کردن فایل ماژول را فراهم می‌کند تا از حمل طولانی مدت آنها جلوگیری کنیم.

clearResultsForName 

protected final void clearResultsForName (String testRunName)

اجازه می‌دهد نتایج مربوط به یک نام اجرای مشخص را پاک کنید. فقط باید در برخی موارد مانند تجمیع‌کننده نتایج استفاده شود.

پارامترها
testRunName String

نتایج اجرای تست پاک‌شده 

protected final void clearTestRunResults ()

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

setIsAggregateMetrics 

protected void setIsAggregrateMetrics (boolean aggregate)

گزینه «معیارهای تجمیع‌شده» را فعال یا غیرفعال کنید

پارامترها
aggregate boolean