IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testunner.IRemoteAndroidTestRunner

رابطی برای اجرای یک دستور تست اندروید از راه دور و گزارش نتیجه به یک شنونده.

خلاصه

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

abstract void addBooleanArg (String name, boolean value)

یک آرگومان بولی برای قرار دادن در دستور instrumentation اضافه می‌کند.

abstract void addInstrumentationArg (String name, String value)

یک آرگومان برای گنجاندن در دستور instrumentation اضافه می‌کند.

abstract void cancel ()

درخواست لغو این اجرای آزمایشی را دارد.

abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

abstract String getPackageName ()

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

abstract String getRunnerName ()

نام دونده را برمی‌گرداند.

abstract void removeInstrumentationArg (String name)

آرگومانی که قبلاً اضافه شده را حذف می‌کند.

abstract void run ( ITestRunListener... listeners)

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

abstract void run ( listeners)

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

abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

abstract void setClassName (String className)

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

abstract void setClassNames (String[] classNames)

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

abstract void setCoverage (boolean coverage)

این حالت پوشش کد را برای این اجرای آزمایشی تنظیم می‌کند.

abstract void setCoverageReportLocation (String reportPath)

محل گزارش‌های پوشش تولید شده را تنظیم می‌کند.

abstract void setDebug (boolean debug)

حالت اشکال‌زدایی این اجرای آزمایشی را تنظیم می‌کند.

abstract void setLogOnly (boolean logOnly)

این اجرای آزمایشی را روی حالت فقط ثبت وقایع تنظیم می‌کند - از اجرای آزمایش صرف نظر می‌کند.

abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

حداکثر زمان مجاز بین خروجی دستور shell که تست‌ها را روی دستگاه‌ها اجرا می‌کند، تنظیم می‌کند.

abstract void setMaxTimeout (long maxTimeout, TimeUnit maxTimeUnits)

حداکثر زمان مجاز برای اتمام ابزار دقیق را تعیین می‌کند.

abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

این روش منسوخ شده است. از ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)) استفاده کنید.

abstract void setMethodName (String className, String testName)

فقط متد تست مشخص شده را برای اجرا تنظیم می‌کند. باید قبل از 'run' فراخوانی شود.

abstract void setRunName (String runName)

یک نام اجرای سفارشی تنظیم کنید تا در هنگام اجرا به ITestRunListener گزارش شود run( )

اگر مشخص نشده باشد، از نام بسته استفاده خواهد شد

abstract void setTestCollection (boolean collection)

این اجرای آزمایشی را در حالت جمع‌آوری آزمایشی تنظیم می‌کند.

abstract void setTestPackageName (String packageName)

برای اجرای تمام تست‌ها در بسته‌ی مشخص شده تنظیم می‌شود. باید قبل از 'run' فراخوانی شود.

abstract void setTestSize ( IRemoteAndroidTestRunner.TestSize size)

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

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

addBooleanArg 

public abstract void addBooleanArg (String name, 
                boolean value)

یک آرگومان بولی برای قرار دادن در دستور instrumentation اضافه می‌کند.

پارامترها
name String : نام آرگومان بسته ابزار دقیق

value boolean : مقدار آرگومان

addInstrumentationArg 

public abstract void addInstrumentationArg (String name, 
                String value)

یک آرگومان برای گنجاندن در دستور instrumentation اضافه می‌کند.

باید قبل از 'run' فراخوانی شود. اگر آرگومانی با نام داده شده قبلاً ارائه شده باشد، مقدار آن لغو می‌شود.

پارامترها
name String : نام آرگومان بسته ابزار دقیق

value String : مقدار آرگومان

لغو 

public abstract void cancel ()

درخواست لغو این اجرای آزمایشی را دارد.

دریافتپوششخروجینوع 

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

بازگشت‌ها
IRemoteAndroidTestRunner.CoverageOutput

دریافت نام بسته 

public abstract String getPackageName ()

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

بازگشت‌ها
String

نام دونده را دریافت کنید 

public abstract String getRunnerName ()

نام دونده را برمی‌گرداند.

بازگشت‌ها
String

حذف ابزار دقیق Arg 

public abstract void removeInstrumentationArg (String name)

آرگومانی که قبلاً اضافه شده را حذف می‌کند.

پارامترها
name String : نام آرگومان بسته ابزار دقیق که باید حذف شود

دویدن 

public abstract void run (ITestRunListener... listeners)

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

روش راحتی برای ERROR(/#run(Collection)) .

پارامترها
listeners ITestRunListener : به نتایج تست گوش می‌دهد.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
ShellCommandUnresponsiveException اگر دستگاه برای مدت زمانی طولانی‌تر از حداکثر زمان مجاز برای خروجی، هیچ نتیجه آزمایشی را ارائه نداد.
اگر اتصال به دستگاه قطع شده باشد.

همچنین ببینید:

دویدن 

public abstract void run ( listeners)

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

پارامترها
listeners : جمع‌آوری شنوندگان برای نتایج آزمون

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
ShellCommandUnresponsiveException اگر دستگاه برای مدت زمانی طولانی‌تر از حداکثر زمان مجاز برای خروجی، هیچ نتیجه آزمایشی را ارائه نداد.
اگر اتصال به دستگاه قطع شده باشد.

همچنین ببینید:

setAdditionalTestOutputLocation 

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

محل کپی شدن خروجی تست اضافی در میزبان را قبل از حذف نصب برنامه تست تعیین می‌کند. مثلاً گزارش‌های بنچمارک تولید شده.

پارامترها
additionalTestDataPath String

نام کلاس را تنظیم کنید 

public abstract void setClassName (String className)

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

پارامترها
className String : نام کلاس کاملاً واجد شرایط (مثلاً xyz)

نام‌های کلاس را تنظیم کنید 

public abstract void setClassNames (String[] classNames)

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

در صورت ارائه بیش از یک کلاس، به یک InstrumentationTestRunner نیاز است که از سینتکس آرگومان کلاس چندگانه پشتیبانی کند.

پارامترها
classNames String : آرایه‌ای از نام‌های کلاس کاملاً واجد شرایط (مثلاً xyz)

پوشش مجموعه 

public abstract void setCoverage (boolean coverage)

این حالت پوشش کد را برای این اجرای آزمایشی تنظیم می‌کند.

پارامترها
coverage boolean

تنظیم پوشش گزارش موقعیت مکانی 

public abstract void setCoverageReportLocation (String reportPath)

محل گزارش‌های پوشش تولید شده را تنظیم می‌کند.

پارامترها
reportPath String

اشکال‌زدایی تنظیم‌شده 

public abstract void setDebug (boolean debug)

این حالت اشکال‌زدایی (debug mode) را برای این اجرای آزمایشی تنظیم می‌کند. اگر مقدار آن درست باشد، اجراکننده‌ی آزمایشی اندروید قبل از ادامه‌ی اجرای آزمایشی، منتظر اتصال یک اشکال‌زدا (debugger) خواهد ماند.

پارامترها
debug boolean

فقط تنظیم ورود 

public abstract void setLogOnly (boolean logOnly)

این اجرای آزمایشی را روی حالت فقط ثبت وقایع تنظیم می‌کند - از اجرای آزمایش صرف نظر می‌کند.

پارامترها
logOnly boolean

setMaxTimeToOutputResponse 

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

حداکثر زمان مجاز بین خروجی دستور shell که تست‌ها را روی دستگاه‌ها اجرا می‌کند، تنظیم می‌کند.

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

به طور پیش‌فرض هیچ مهلت زمانی مشخص نخواهد شد.

پارامترها
maxTimeToOutputResponse long : حداکثر زمانی که دستور مجاز است هیچ پاسخی ارائه ندهد. مقدار 0 به این معنی است که متد برای همیشه (تا زمانی که receiver اجرا را لغو کند) منتظر خروجی دستور می‌ماند و هرگز ارسال نمی‌شود.

maxTimeUnits TimeUnit : واحد برای مقادیر غیر صفر maxTimeToOutputResponse و maxTimeout .

setMaxTimeout 

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

حداکثر زمان مجاز برای اتمام ابزار دقیق را تعیین می‌کند.

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

به طور پیش‌فرض هیچ مهلت زمانی مشخص نخواهد شد.

پارامترها
maxTimeout long : حداکثر زمانی که دستور مجاز است هیچ پاسخی ارائه ندهد. مقدار 0 به این معنی است که متد برای همیشه (تا زمانی که receiver اجرا را لغو کند) منتظر خروجی دستور می‌ماند و هرگز ارسال نمی‌شود.

maxTimeUnits TimeUnit : واحد برای مقادیر غیر صفر maxTimeToOutputResponse و maxTimeout .

setMaxtimeToOutputResponse 

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

این روش منسوخ شده است.
از ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)) ‎ استفاده کنید.

پارامترها
maxTimeToOutputResponse int

نام متد را تنظیم کنید 

public abstract void setMethodName (String className, 
                String testName)

فقط متد تست مشخص شده را برای اجرا تنظیم می‌کند. باید قبل از 'run' فراخوانی شود.

پارامترها
className String : نام کلاس کاملاً واجد شرایط (مثلاً xyz)

testName String : نام متد

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

public abstract void setRunName (String runName)

یک نام اجرای سفارشی تنظیم کنید تا در هنگام اجرا به ITestRunListener گزارش شود run( )

اگر مشخص نشده باشد، از نام بسته استفاده خواهد شد

مجموعه تست مجموعه 

public abstract void setTestCollection (boolean collection)

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

پارامترها
collection boolean

نام بسته‌ی آزمایشی را تنظیم کنید 

public abstract void setTestPackageName (String packageName)

برای اجرای تمام تست‌ها در بسته‌ی مشخص شده تنظیم می‌شود. باید قبل از 'run' فراخوانی شود.

پارامترها
packageName String : نام کامل بسته (مثلاً xyz)

تنظیم اندازه تست 

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

تنظیم می‌کند که فقط تست‌هایی با اندازه داده شده اجرا شوند. باید قبل از 'run' فراخوانی شود.

پارامترها
size IRemoteAndroidTestRunner.TestSize : TestSize برای اجرا.