جمع‌کننده‌ی متریک دستگاه پایه

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver , IMetricCollector

شیء جاوا
↳ com.android.tradefed.device.metric.BaseDeviceMetricCollector

پیاده‌سازی پایه IMetricCollector که امکان شروع و توقف جمع‌آوری داده‌ها را در onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) و ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) می‌کند.

خلاصه

ثابت‌ها

String TEST_CASE_EXCLUDE_GROUP_OPTION

String TEST_CASE_INCLUDE_GROUP_OPTION

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

BaseDeviceMetricCollector ()

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

void extraInit ( IInvocationContext context, ITestInvocationListener listener)
final getBuildInfos ()

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

final getDevices ()

لیست دستگاه‌های موجود در فراخوانی را برمی‌گرداند.

File getFileFromTestArtifacts (String fileName)

فایل را از مصنوعات آزمایشی یا مصنوعات ماژول بازیابی کنید و آن را در یک نقشه برای فراخوانی‌های بعدی ذخیره کنید.

final ITestInvocationListener getInvocationListener ()

ITestInvocationListener اصلی را که نتایج را به آن ارسال می‌کنیم، برمی‌گرداند.

String getModuleName ()
final getRealDevices ()

تمام دستگاه‌های غیر stub را از لیست getDevices() برمی‌گرداند.

String getRunName ()

نام اجرای آزمایشی mRunName که جمع‌کننده را فعال می‌کند، برمی‌گرداند.

String getTestName ()

نام آزمون mTestName که جمع‌کننده را فعال می‌کند، برمی‌گرداند.

final ITestInvocationListener init ( IInvocationContext context, ITestInvocationListener listener)

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

final void invocationEnded (long elapsedTime)

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

final void invocationFailed ( FailureDescription failure)

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

final void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

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

final void invocationStarted ( IInvocationContext context)

شنوندگان فراخوانی برای ارسال

final boolean isDisabled ()

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

boolean isDisabledReceiver ()

اینکه آیا IDeviceActionReceiver غیرفعال است یا خیر.

final void logAssociation (String dataName, LogFile logFile)

از پیاده‌سازی کلکتور متریک درون برنامه‌ای استفاده نکنید.

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

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

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)

فراخوانی مجدد (callback) پس از پایان یک مورد آزمایشی (test case).

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

فراخوانی مجدد (callback) پس از پایان یک مورد آزمایشی (test case).

void onTestFail ( DeviceMetricData testData, TestDescription test)

فراخوانی مجدد در صورت عدم موفقیت یک مورد آزمایشی.

void onTestModuleEnded ()

امکان ثبت رویداد پایان ماژول را فراهم می‌کند.

void onTestModuleStarted ()

امکان ثبت رویداد آغاز شده ماژول را فراهم می‌کند.

void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)

فراخوانی مجدد پس از پایان اجرای آزمایشی.

void onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)

فراخوانی برای رویدادهای testRunFailed

void onTestRunStart ( DeviceMetricData runData)

فراخوانی مجدد هنگام شروع اجرای آزمایشی.

void onTestStart ( DeviceMetricData testData)

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

void rebootEnded ( ITestDevice device)

هنگام پایان راه‌اندازی مجدد در دستگاه، اعلان دریافت می‌کند.

void rebootStarted ( ITestDevice device)

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

final void setDisable (boolean isDisabled)

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

void setDisableReceiver (boolean isDisabled)

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

final void setLogSaver ( ILogSaver logSaver)

از پیاده‌سازی کلکتور متریک درون برنامه‌ای استفاده نکنید.

final void testAssumptionFailure ( TestDescription test, String trace)

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

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

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

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

final void testEnded ( TestDescription test, testMetrics)

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

final void testFailed ( TestDescription test, FailureDescription failure)

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

final void testFailed ( TestDescription test, String trace)

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

final void testIgnored ( TestDescription test)

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

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

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

final void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

از پیاده‌سازی کلکتور متریک درون برنامه‌ای استفاده نکنید.

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

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

final void testRunEnded (long elapsedTime, runMetrics)

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

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

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

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

final void testRunStarted (String runName, int testCount)

فراخوانی‌های مجدد اجرای آزمایشی

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

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

final void testRunStopped (long elapsedTime)

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

final void testSkipped ( TestDescription test, SkipReason reason)

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

final void testStarted ( TestDescription test, long startTime)

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

final void testStarted ( TestDescription test)

فراخوانی‌های مجدد موارد آزمایشی

ثابت‌ها

گزینه گروه آزمون 

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

مقدار ثابت: "گروه مستثنی از مورد آزمایشی"

گزینه گروه شامل کردن در آزمون 

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

مقدار ثابت: "گروه شامل موارد آزمایشی"

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

جمع‌کننده‌ی متریک دستگاه پایه 

public BaseDeviceMetricCollector ()

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

extraInit 

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

public final  getBuildInfos ()

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

بازگشت‌ها

دریافت دستگاه‌ها 

public final  getDevices ()

لیست دستگاه‌های موجود در فراخوانی را برمی‌گرداند.

بازگشت‌ها

دریافت فایل از تست مصنوعات 

public File getFileFromTestArtifacts (String fileName)

فایل را از مصنوعات آزمایشی یا مصنوعات ماژول بازیابی کنید و آن را در یک نقشه برای فراخوانی‌های بعدی ذخیره کنید.

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

بازگشت‌ها
File فایلی از مصنوع آزمایشی یا مصنوع ماژول. اگر فایل پیدا نشود، مقدار null را برمی‌گرداند.

getInvocationListener 

public final ITestInvocationListener getInvocationListener ()

ITestInvocationListener اصلی را که نتایج را به آن ارسال می‌کنیم، برمی‌گرداند.

بازگشت‌ها
ITestInvocationListener

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

public String getModuleName ()

بازگشت‌ها
String

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

public final  getRealDevices ()

تمام دستگاه‌های غیر stub را از لیست getDevices() برمی‌گرداند.

بازگشت‌ها

نام اجرا را دریافت کنید 

public String getRunName ()

نام اجرای آزمایشی mRunName که جمع‌کننده را فعال می‌کند، برمی‌گرداند.

بازگشت‌ها
String mRunName، نام اجرای آزمایشی فعلی.

نام آزمون را دریافت کنید 

public String getTestName ()

نام آزمون mTestName که جمع‌کننده را فعال می‌کند، برمی‌گرداند.

بازگشت‌ها
String mTestName، نام آزمون فعلی.

اولیه 

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

مگر اینکه بدانید چه می‌کنید، آن را لغو نکنید.

پارامترها
context IInvocationContext : IInvocationContext برای فراخوانی که در حال انجام است.

listener ITestInvocationListener : این ITestInvocationListener محل قرار دادن نتایج است.

بازگشت‌ها
ITestInvocationListener شنونده‌ی جدید، شنونده‌ی اصلی را در بر می‌گیرد.

پرتاب‌ها
DeviceNotAvailableException

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

public final void invocationEnded (long elapsedTime)

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

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

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

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

public final void invocationFailed (FailureDescription failure)

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

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

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

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

public final void invocationFailed (Throwable cause)

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

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

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

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

public void invocationSkipped (SkipReason reason)

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

پارامترها
reason SkipReason

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

public final void invocationStarted (IInvocationContext context)

شنوندگان فراخوانی برای ارسال

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

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

public final boolean isDisabled ()

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

بازگشت‌ها
boolean

گیرنده غیرفعال شده 

public boolean isDisabledReceiver ()

اینکه آیا IDeviceActionReceiver غیرفعال است یا خیر.

بازگشت‌ها
boolean اگر غیرفعال باشد مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.

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

public final void logAssociation (String dataName, 
                LogFile logFile)

از پیاده‌سازی کلکتور متریک داخلی استفاده نکنید. این صرفاً ارسال است.

پارامترها
dataName String : نام داده

logFile LogFile : LogFile که قبلاً لاگ شده و باید با مورد آزمایشی مرتبط باشد.

خطای onTestAssumption 

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد.

test TestDescription : TestDescription موردِ آزمایشیِ در حال انجام.

پرتاب‌ها
DeviceNotAvailableException

پایان آزمون 

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

فراخوانی مجدد زمانی که یک مورد آزمایشی به پایان رسید. این باید زمان پاکسازی باشد.

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد. این شیء همان شیء‌ای خواهد بود که در طول onTestStart(com.android.tradefed.device.metric.DeviceMetricData) وجود داشت.

currentTestCaseMetrics : نقشه فعلی معیارهای ارسال شده به ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

test TestDescription : TestDescription موردِ آزمایشیِ در حال انجام.

پرتاب‌ها
DeviceNotAvailableException

پایان آزمون 

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

فراخوانی مجدد زمانی که یک مورد آزمایشی به پایان رسید. این باید زمان پاکسازی باشد.

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد. این شیء همان شیء‌ای خواهد بود که در طول onTestStart(com.android.tradefed.device.metric.DeviceMetricData) وجود داشت.

currentTestCaseMetrics : نقشه فعلی معیارهای ارسال شده به ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

پرتاب‌ها
DeviceNotAvailableException

onTestFail 

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

فراخوانی مجدد در صورت عدم موفقیت یک مورد آزمایشی.

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد.

test TestDescription : TestDescription موردِ آزمایشیِ در حال انجام.

پرتاب‌ها
DeviceNotAvailableException

onTestModuleEnd شده 

public void onTestModuleEnded ()

امکان ثبت رویداد پایان ماژول را فراهم می‌کند.

پرتاب‌ها
DeviceNotAvailableException

onTestModuleStarted 

public void onTestModuleStarted ()

امکان ثبت رویداد آغاز شده ماژول را فراهم می‌کند.

پرتاب‌ها
DeviceNotAvailableException

onTestRunEnd 

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

فراخوانی مجدد پس از پایان اجرای آزمایشی. این زمان باید زمان پاکسازی باشد.

پارامترها
runData DeviceMetricData : DeviceMetricData که داده‌ها را برای اجرا نگه می‌دارد. همان شیء‌ای خواهد بود که در طول onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) وجود داشت.

currentRunMetrics : نقشه فعلی معیارهای ارسال شده به ERROR(/#testRunEnded(long,Map)) .

پرتاب‌ها
DeviceNotAvailableException

onTestRunFailed 

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

فراخوانی برای رویدادهای testRunFailed

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart 

public void onTestRunStart (DeviceMetricData runData)

فراخوانی مجدد هنگام شروع اجرای آزمایشی.

پارامترها
runData DeviceMetricData : DeviceMetricData داده‌ها را برای اجرا نگه می‌دارد.

پرتاب‌ها
DeviceNotAvailableException

شروع آزمون 

public void onTestStart (DeviceMetricData testData)

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

پارامترها
testData DeviceMetricData : DeviceMetricData که داده‌های مربوط به مورد آزمایشی را در خود نگه می‌دارد.

پرتاب‌ها
DeviceNotAvailableException

راه اندازی مجددپایان یافت 

public void rebootEnded (ITestDevice device)

هنگام پایان راه‌اندازی مجدد در دستگاه، اعلان دریافت می‌کند.

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

پارامترها
device ITestDevice : ITestDevice که ریبوت در آن پایان یافت.

پرتاب‌ها
DeviceNotAvailableException

راه اندازی مجدد شروع شد 

public void rebootStarted (ITestDevice device)

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

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

پارامترها
device ITestDevice : ITestDevice که ریبوت از آنجا شروع شده است.

پرتاب‌ها
DeviceNotAvailableException

غیرفعال کردن 

public final void setDisable (boolean isDisabled)

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

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

گیرنده را غیرفعال کنید 

public void setDisableReceiver (boolean isDisabled)

تنظیم می‌کند که آیا IDeviceActionReceiver باید غیرفعال شود یا خیر. غیرفعال کردن به این معنی است که برای دریافت رویدادهای عملکرد دستگاه، در دستگاه ثبت نمی‌شود.

پارامترها
isDisabled boolean

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

public final void setLogSaver (ILogSaver logSaver)

از پیاده‌سازی کلکتور متریک داخلی استفاده نکنید. این صرفاً ارسال است.

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

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

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

trace String : ردپای پشته از خرابی

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

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

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

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

public final 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 final void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testMetrics : یک ERROR(/Map) از معیارهای منتشر شده

تست ناموفق 

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

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

تست ناموفق 

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String : ردپای پشته از خرابی

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

public final void testIgnored (TestDescription test)

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

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

تست لاگ 

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

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

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

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

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat". توجه داشته باشید که dataName ممکن است در هر فراخوانی منحصر به فرد نباشد. یعنی پیاده‌سازی‌کنندگان باید بتوانند چندین فراخوانی را با همان dataName مدیریت کنند.

dataType LogDataType : نوع داده‌ی LogDataType

dataStream InputStreamSource : InputStreamSource داده‌ها. پیاده‌سازی‌کنندگان باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و اطمینان حاصل کنند که InputStream حاصل را پس از اتمام ببندند. فراخوانی‌کنندگان باید اطمینان حاصل کنند که منبع داده‌ها تا زمان تکمیل متد testLog موجود و در دسترس باقی می‌ماند.

testLogذخیره شده 

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

از پیاده‌سازی کلکتور متریک داخلی استفاده نکنید. این صرفاً ارسال است.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat". توجه داشته باشید که dataName ممکن است در هر فراخوانی منحصر به فرد نباشد. یعنی پیاده‌سازی‌کنندگان باید بتوانند چندین فراخوانی را با همان dataName مدیریت کنند.

dataType LogDataType : نوع داده‌ی LogDataType

dataStream InputStreamSource : InputStreamSource داده‌ها. پیاده‌سازی‌کنندگان باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و مطمئن شوند که InputStream حاصل را پس از اتمام کار ببندند.

logFile LogFile : LogFile که شامل متا دیتای فایل ذخیره شده است.

testModuleEnd 

public final void testModuleEnded ()

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

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

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

تست اجرا شده 

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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

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

public final void testRunFailed (FailureDescription failure)

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

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

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

public final void testRunFailed (String errorMessage)

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

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

تست شروع شد 

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

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

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

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

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

تست شروع شد 

public final void testRunStarted (String runName, 
                int testCount)

فراخوانی‌های مجدد اجرای آزمایشی

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

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

تست شروع شد 

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

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

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

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

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

startTime long : زمان شروع اجرا، که از طریق System.currentTimeMillis() اندازه‌گیری می‌شود.

testRunStopped 

public final void testRunStopped (long elapsedTime)

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

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

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

آزمون رد شد 

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason : SkipReason

تست شروع شد 

public final 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 final void testStarted (TestDescription test)

فراخوانی‌های مجدد موارد آزمایشی

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