تست رانر اندروید از راه دور

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

شیء جاوا
↳ com.android.ddmlib.testunner.RemoteAndroidTestRunner

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

خلاصه

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

RemoteAndroidTestRunner (String packageName, IShellEnabledDevice remoteDevice)

سازنده جایگزین.

RemoteAndroidTestRunner (String packageName, String runnerName, IShellEnabledDevice remoteDevice)

سازنده جایگزین.

RemoteAndroidTestRunner (String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

یک اجراکننده تست اندروید از راه دور ایجاد می‌کند.

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

void addBooleanArg (String name, boolean value)

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

void addInstrumentationArg (String name, String value)

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

void cancel ()

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

IInstrumentationResultParser createParser (String runName, listeners)

InstrumentationResultParser را ایجاد کنید که برای تجزیه خروجی instrumentation استفاده خواهد شد.

String getAmInstrumentCommand ()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

String getPackageName ()

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

String getRunOptions ()

گزینه‌های مربوط به دستور am instrument را برمی‌گرداند.

String getRunnerName ()

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

void removeInstrumentationArg (String name)

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

void run ( ITestRunListener... listeners)

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

void run ( listeners)

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

void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

void setClassName (String className)

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

void setClassNames (String[] classNames)

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

void setCoverage (boolean coverage)

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

void setCoverageReportLocation (String reportPath)

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

void setDebug (boolean debug)

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

void setLogOnly (boolean logOnly)

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

void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout (long maxTimeout, TimeUnit maxTimeUnits)

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

void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)
void setMethodName (String className, String testName)

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

void setRunName (String runName)

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

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

void setRunOptions (String options)

گزینه‌های مربوط به فرمان am instrument را تنظیم می‌کند.

void setTestCollection (boolean collect)

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

void setTestPackageName (String packageName)

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

void setTestSize ( IRemoteAndroidTestRunner.TestSize size)

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

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

String getArgsCommand ()

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

String getRunnerPath ()

مسیر کامل قطعه ابزار دقیق را برمی‌گرداند.

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

تست رانر اندروید از راه دور 

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

سازنده جایگزین. از دونده پیش‌فرض ابزار دقیق استفاده می‌کند.

پارامترها
packageName String : بسته برنامه اندروید که شامل تست‌هایی برای اجرا است

remoteDevice IShellEnabledDevice : دستگاه اندرویدی که قرار است تست‌ها روی آن اجرا شوند

تست رانر اندروید از راه دور 

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

سازنده جایگزین. از statusReporterMode پیش‌فرض استفاده می‌کند.

پارامترها
packageName String : بسته برنامه اندروید که شامل تست‌هایی برای اجرا است

runnerName String : اجراکننده‌ی تست ابزار دقیق برای اجرا. اگر null باشد، از اجراکننده‌ی پیش‌فرض استفاده خواهد شد.

remoteDevice IShellEnabledDevice : دستگاه اندرویدی که قرار است تست‌ها روی آن اجرا شوند

تست رانر اندروید از راه دور 

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

یک اجراکننده تست اندروید از راه دور ایجاد می‌کند.

پارامترها
packageName String : بسته برنامه اندروید که شامل تست‌هایی برای اجرا است

runnerName String : اجراکننده‌ی تست ابزار دقیق برای اجرا. اگر null باشد، از اجراکننده‌ی پیش‌فرض استفاده خواهد شد.

remoteDevice IShellEnabledDevice : دستگاه اندرویدی که قرار است تست‌ها روی آن اجرا شوند

statusReporterMode RemoteAndroidTestRunner.StatusReporterMode : حالت گزارشگر وضعیت که برای دستور am instrument استفاده می‌شود.

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

addBooleanArg 

public void addBooleanArg (String name, 
                boolean value)

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

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

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

addInstrumentationArg 

public void addInstrumentationArg (String name, 
                String value)

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

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

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

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

لغو 

public void cancel ()

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

ایجاد پارسر 

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

InstrumentationResultParser را ایجاد کنید که برای تجزیه خروجی instrumentation استفاده خواهد شد.

پارامترها
runName String : نام دستوری که قرار است استفاده شود.

listeners : شنوندگانی که نتایج را گزارش می‌دهند.

بازگشت‌ها
IInstrumentationResultParser یک نمونه از InstrumentationResultParser .

دستور getAmInstrument 

public String getAmInstrumentCommand ()

بازگشت‌ها
String

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

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

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

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

public String getPackageName ()

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

بازگشت‌ها
String

گزینه‌های اجرای دریافت 

public String getRunOptions ()

گزینه‌های مربوط به دستور am instrument را برمی‌گرداند.

بازگشت‌ها
String

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

public String getRunnerName ()

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

بازگشت‌ها
String

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

public void removeInstrumentationArg (String name)

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

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

دویدن 

public void run (ITestRunListener... listeners)

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

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

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

پرتاب‌ها
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

دویدن 

public void run ( listeners)

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

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

پرتاب‌ها
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation 

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

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

پارامترها
additionalTestDataPath String

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

public void setClassName (String className)

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

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

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

public void setClassNames (String[] classNames)

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

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

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

پوشش مجموعه 

public void setCoverage (boolean coverage)

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

پارامترها
coverage boolean

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

public void setCoverageReportLocation (String reportPath)

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

پارامترها
reportPath String

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

public void setDebug (boolean debug)

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

پارامترها
debug boolean

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

public void setLogOnly (boolean logOnly)

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

پارامترها
logOnly boolean

setMaxTimeToOutputResponse 

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

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

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

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

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

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

setMaxTimeout 

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

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

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

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

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

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

setMaxtimeToOutputResponse 

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

پارامترها
maxTimeToOutputResponse int

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

public void setMethodName (String className, 
                String testName)

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

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

testName String : نام متد

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

public void setRunName (String runName)

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

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

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

public void setRunOptions (String options)

گزینه‌های مربوط به دستور am instrument را تنظیم می‌کند. برای لیست کامل گزینه‌ها به com/android/commands/am/Am.java مراجعه کنید.

پارامترها
options String

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

public void setTestCollection (boolean collect)

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

پارامترها
collect boolean

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

public void setTestPackageName (String packageName)

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

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

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

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

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

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

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

دستور getArgs 

protected String getArgsCommand ()

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

بازگشت‌ها
String

دریافت مسیر اجرا 

protected String getRunnerPath ()

مسیر کامل قطعه ابزار دقیق را برمی‌گرداند.

بازگشت‌ها
String