تست ابزار دقیق
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
java.lang.object | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
تستی که بسته تست ابزار دقیق را روی دستگاه داده شده اجرا می کند.
خلاصه
زمینه های | |
---|---|
public static final String | RUN_TESTS_AS_USER_KEY |
public static final String | RUN_TESTS_ON_SDK_SANDBOX |
protected boolean | mDebug
|
سازندگان عمومی | |
---|---|
InstrumentationTest () |
روش های عمومی | |
---|---|
void | addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners) اجازه می دهد تا شنوندگان سفارشی بیشتری به رانر اضافه شود |
void | addInstrumentationArg (String key, String value) هنگام اجرای تست های ابزار دقیق، یک آرگومان اضافه کنید. |
IAbi | getAbi () |
IConfiguration | getConfiguration () |
String | getCoverageTarget () CoverageTarget را که قبلاً از طریق |
boolean | getDebug () تنظیمات اشکال زدایی ابزار دقیق را دریافت کنید. |
ITestDevice | getDevice () دستگاه را تحت آزمایش قرار دهید. |
String | getForceAbi () |
long | getMaxTimeout () حداکثر زمان تعیین شده برای ابزار دقیق را برمی گرداند. |
String | getPackageName () بسته مانیفست اندروید را برای اجرا دریافت کنید. |
String | getRunName () نام اجرای آزمایشی سفارشی را که برای شنونده ارائه می شود، دریافت کنید |
String | getRunnerName () دونده ابزار دقیق اندروید را برای استفاده دریافت می کند. |
void | run ( TestInformation testInfo, ITestInvocationListener listener) تست ها را اجرا می کند و نتیجه را به شنونده گزارش می دهد. |
void | setAbi ( IAbi abi) |
void | setClassName (String testClassName) در صورت تمایل، نام کلاس آزمایشی را برای اجرا تنظیم کنید. |
void | setCollectTestsOnly (boolean shouldCollectTest) حالت مجموعه آزمایشی را فعال یا غیرفعال می کند |
void | setCollectsTestsShellTimeout (int timeout) این روش منسوخ شده است. این روش بدون عملیات است |
void | setConfiguration ( IConfiguration config) |
void | setCoverageTarget (String coverageTarget) هدف پوشش این آزمون را تعیین کنید. |
void | setDebug (boolean debug) تنظیمات اشکال زدایی ابزار دقیق را تنظیم کنید. |
void | setDevice ( ITestDevice device) دستگاه تحت آزمایش را تزریق کنید. |
void | setEnforceFormat (boolean enforce) اگر فرمت خروجی AJUR ابزار دقیق را اعمال کنیم، True را تنظیم کنید. |
void | setForceAbi (String abi) گزینه force-abi را تنظیم می کند. |
void | setInstallFile (File installFile) فایل اختیاری را برای نصب که حاوی تست ها است تنظیم کنید. |
void | setIsolatedStorage (boolean isolatedStorage) تنظیم آب و هوا یا عدم استفاده از ذخیره سازی جدا شده. |
void | setMethodName (String testMethodName) به صورت اختیاری، روش تست را برای اجرا تنظیم کنید. |
void | setMetricCollectors ( collectors) setMetricCollectors ( collectors) لیست |
void | setPackageName (String packageName) بسته مانیفست اندروید را برای اجرا تنظیم کنید. |
void | setReRunUsingTestFile (boolean reRunUsingTestFile) گزینه --rerun-from-file را تنظیم می کند. |
void | setRerunMode (boolean rerun) به صورت اختیاری، حالت اجرای مجدد را تنظیم کنید. |
void | setRunName (String runName) نام اجرای آزمایشی سفارشی را که برای شنونده ارائه می شود تنظیم کنید |
void | setRunnerName (String runnerName) به صورت اختیاری، رانر ابزار دقیق اندروید را برای استفاده تنظیم کنید. |
void | setShellTimeout (long timeout) به صورت اختیاری، حداکثر زمان (بر حسب میلی ثانیه) مورد انتظار خروجی پوسته از دستگاه را تنظیم کنید. |
void | setTestFilePathOnDevice (String testFilePathOnDevice) به صورت اختیاری، مسیر فایلی را که در دستگاه قرار دارد قرار دهید که باید حاوی لیستی از کلاسها و روشهای آزمایشی جدا شده از خط باشد (فرمت: com.foo.Class#method) برای اجرا. |
void | setTestPackageName (String testPackageName) فیلتر بسته آزمایشی را تنظیم می کند. |
void | setTestSize (String size) به صورت اختیاری، اندازه آزمایش را برای اجرا تنظیم کنید. |
void | setTestTimeout (long timeout) به صورت اختیاری، حداکثر زمان (بر حسب میلی ثانیه) را برای هر آزمایش جداگانه تنظیم کنید. |
void | setTestsToRun ( tests) setTestsToRun ( tests) مجموعه تست هایی را که باید توسط این InstrumentationTest اجرا شوند را تنظیم کنید. |
void | setWindowAnimation (boolean windowAnimation) |
روش های محافظت شده | |
---|---|
static | excludeNonExecuted ( TestRunResult results) "NOT_EXECUTED" را برای ردیابی مواردی که باید دوباره اجرا شوند، فیلتر کنید. |
String | getClassName () نام کلاس را برای اجرا دریافت کنید. |
ListInstrumentationParser | getListInstrumentationParser () |
String | getMethodName () روش تست را برای اجرا دریافت کنید. |
String | getTestPackageName () بسته آزمایشی جاوا را برای اجرا دریافت کنید. |
String | queryRunnerName () دستگاه را برای استفاده از یک دونده آزمایشی جستجو کنید. |
void | setRunnerArgs (IRemoteAndroidTestRunner runner) |
زمینه های
RUN_TESTS_AS_USER_KEY
public static final String RUN_TESTS_AS_USER_KEY
RUN_TESTS_ON_SDK_SANDBOX
public static final String RUN_TESTS_ON_SDK_SANDBOX
mDebug
protected boolean mDebug
سازندگان عمومی
تست ابزار دقیق
public InstrumentationTest ()
روش های عمومی
افزودن DeviceListeners
public void addDeviceListeners (extraListeners)
اجازه می دهد تا شنوندگان سفارشی بیشتری به رانر اضافه شود
مولفه های | |
---|---|
extraListeners |
addInstrumentationArg
public void addInstrumentationArg (String key, String value)
هنگام اجرای تست های ابزار دقیق، یک آرگومان اضافه کنید.
مولفه های | |
---|---|
key | String : نام آرگومان |
value | String : مقدار آرگومان |
getConfiguration
public IConfiguration getConfiguration ()
IConfiguration
برای این تست دریافت می کند.
برمی گرداند | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
CoverageTarget را که قبلاً از طریق setCoverageTarget(String)
تنظیم شده بود دریافت کنید.
برمی گرداند | |
---|---|
String |
getDebug
public boolean getDebug ()
تنظیمات اشکال زدایی ابزار دقیق را دریافت کنید.
برمی گرداند | |
---|---|
boolean | تنظیمات اشکال زدایی بولی. |
getDevice
public ITestDevice getDevice ()
دستگاه را تحت آزمایش قرار دهید.
برمی گرداند | |
---|---|
ITestDevice | ITestDevice |
getForceAbi
public String getForceAbi ()
برمی گرداند | |
---|---|
String |
getMaxTimeout
public long getMaxTimeout ()
حداکثر زمان تعیین شده برای ابزار دقیق را برمی گرداند.
برمی گرداند | |
---|---|
long |
getPackageName
public String getPackageName ()
بسته مانیفست اندروید را برای اجرا دریافت کنید.
برمی گرداند | |
---|---|
String |
getRunName
public String getRunName ()
نام اجرای آزمایشی سفارشی را که برای شنونده ارائه می شود، دریافت کنید
برمی گرداند | |
---|---|
String |
getRunnerName
public String getRunnerName ()
دونده ابزار دقیق اندروید را برای استفاده دریافت می کند.
برمی گرداند | |
---|---|
String |
اجرا کن
public void run (TestInformation testInfo, ITestInvocationListener listener)
تست ها را اجرا می کند و نتیجه را به شنونده گزارش می دهد.
مولفه های | |
---|---|
testInfo | TestInformation : شی TestInformation حاوی اطلاعات مفید برای اجرای تست ها. |
listener | ITestInvocationListener : ITestInvocationListener نتایج آزمون |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setClassName
public void setClassName (String testClassName)
در صورت تمایل، نام کلاس آزمایشی را برای اجرا تنظیم کنید.
مولفه های | |
---|---|
testClassName | String |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
حالت مجموعه آزمایشی را فعال یا غیرفعال می کند
setCollectsTestsShellTimeout
public void setCollectsTestsShellTimeout (int timeout)
این روش منسوخ شده است.
این روش بدون عملیات است
حداکثر زمان را بر حسب میلیثانیه تنظیم کنید تا هنگام جمعآوری آزمایشها، «حداکثر زمان پاسخ خروجی پوسته» مجاز باشد.
مولفه های | |
---|---|
timeout | int |
پیکربندی set
public void setConfiguration (IConfiguration config)
IConfiguration
در حال استفاده را تزریق می کند.
مولفه های | |
---|---|
config | IConfiguration |
setCoverageTarget
public void setCoverageTarget (String coverageTarget)
هدف پوشش این آزمون را تعیین کنید.
فعلا استفاده نشده این روش به تازگی وجود دارد، بنابراین coverageTarget را می توان بعداً از طریق getCoverageTarget()
بازیابی کرد.
مولفه های | |
---|---|
coverageTarget | String |
setDebug
public void setDebug (boolean debug)
تنظیمات اشکال زدایی ابزار دقیق را تنظیم کنید.
مولفه های | |
---|---|
debug | boolean : مقدار بولی برای تنظیم تنظیمات اشکال زدایی ابزار دقیق. |
setDevice
public void setDevice (ITestDevice device)
دستگاه تحت آزمایش را تزریق کنید.
مولفه های | |
---|---|
device | ITestDevice : ITestDevice مورد استفاده |
setEnforceFormat
public void setEnforceFormat (boolean enforce)
اگر فرمت خروجی AJUR ابزار دقیق را اعمال کنیم، True را تنظیم کنید.
مولفه های | |
---|---|
enforce | boolean |
setForceAbi
public void setForceAbi (String abi)
گزینه force-abi را تنظیم می کند.
setInstallFile
public void setInstallFile (File installFile)
فایل اختیاری را برای نصب که حاوی تست ها است تنظیم کنید.
مولفه های | |
---|---|
installFile | File : ERROR(/File) قابل نصب |
setIsolatedStorage
public void setIsolatedStorage (boolean isolatedStorage)
تنظیم آب و هوا یا عدم استفاده از ذخیره سازی جدا شده.
مولفه های | |
---|---|
isolatedStorage | boolean |
setMethodName
public void setMethodName (String testMethodName)
به صورت اختیاری، روش تست را برای اجرا تنظیم کنید.
مولفه های | |
---|---|
testMethodName | String |
setMetricCollectors
public void setMetricCollectors (collectors)
لیست IMetricCollector
های تعریف شده برای اجرای آزمایشی را تنظیم می کند.
مولفه های | |
---|---|
collectors |
setPackageName
public void setPackageName (String packageName)
بسته مانیفست اندروید را برای اجرا تنظیم کنید.
مولفه های | |
---|---|
packageName | String |
setReRunUsingTestFile
public void setReRunUsingTestFile (boolean reRunUsingTestFile)
گزینه --rerun-from-file را تنظیم می کند.
مولفه های | |
---|---|
reRunUsingTestFile | boolean |
setRerunMode
public void setRerunMode (boolean rerun)
به صورت اختیاری، حالت اجرای مجدد را تنظیم کنید.
مولفه های | |
---|---|
rerun | boolean |
setRunName
public void setRunName (String runName)
نام اجرای آزمایشی سفارشی را که برای شنونده ارائه می شود تنظیم کنید
مولفه های | |
---|---|
runName | String |
setRunnerName
public void setRunnerName (String runnerName)
به صورت اختیاری، رانر ابزار دقیق اندروید را برای استفاده تنظیم کنید.
مولفه های | |
---|---|
runnerName | String |
setShellTimeout
public void setShellTimeout (long timeout)
به صورت اختیاری، حداکثر زمان (بر حسب میلی ثانیه) مورد انتظار خروجی پوسته از دستگاه را تنظیم کنید.
مولفه های | |
---|---|
timeout | long |
setTestFilePathOnDevice
public void setTestFilePathOnDevice (String testFilePathOnDevice)
به صورت اختیاری، مسیر فایلی را که در دستگاه قرار دارد قرار دهید که باید حاوی لیستی از کلاسها و روشهای آزمایشی جدا شده از خط باشد (فرمت: com.foo.Class#method) برای اجرا. اگر تنظیم شود، بهجای اجرای دستورات adb جداگانه برای هر آزمون باقیمانده از طریق اجرای مجدد، بهطور خودکار با استفاده از این فایل آزمایشی از طریق InstrumentationFileTest، آزمایشها را دوباره اجرا میکند.
مولفه های | |
---|---|
testFilePathOnDevice | String |
setTestPackageName
public void setTestPackageName (String testPackageName)
فیلتر بسته آزمایشی را تنظیم می کند.
اگر تهی نباشد، فقط تست های درون بسته جاوای داده شده اجرا می شوند.
اگر یک مقدار غیر تهی به setClassName(String)
ارائه شده باشد نادیده گرفته می شود
مولفه های | |
---|---|
testPackageName | String |
setTestSize
public void setTestSize (String size)
به صورت اختیاری، اندازه آزمایش را برای اجرا تنظیم کنید.
مولفه های | |
---|---|
size | String |
setTestTimeout
public void setTestTimeout (long timeout)
به صورت اختیاری، حداکثر زمان (بر حسب میلی ثانیه) را برای هر آزمایش جداگانه تنظیم کنید.
مولفه های | |
---|---|
timeout | long |
setTestsToRun
public void setTestsToRun (tests)
مجموعه تست هایی را که باید توسط این InstrumentationTest اجرا شوند را تنظیم کنید.
مولفه های | |
---|---|
tests |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
مولفه های | |
---|---|
windowAnimation | boolean |
روش های محافظت شده
excludeNonExecuted
protected staticexcludeNonExecuted (TestRunResult results)
"NOT_EXECUTED" را برای ردیابی مواردی که باید دوباره اجرا شوند، فیلتر کنید.
مولفه های | |
---|---|
results | TestRunResult |
برمی گرداند | |
---|---|
getClassName
protected String getClassName ()
نام کلاس را برای اجرا دریافت کنید.
برمی گرداند | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
ListInstrumentationParser
مورد استفاده برای تجزیه پرس و جوهای 'pm list instrumentation' را دریافت کنید.
برمی گرداند | |
---|---|
ListInstrumentationParser |
getMethodName
protected String getMethodName ()
روش تست را برای اجرا دریافت کنید.
برمی گرداند | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
بسته آزمایشی جاوا را برای اجرا دریافت کنید.
برمی گرداند | |
---|---|
String |
queryRunnerName
protected String queryRunnerName ()
از دستگاه پرس و جو کنید تا یک دونده آزمایشی از آن استفاده کند.
برمی گرداند | |
---|---|
String | اولین نام دونده آزمایشی که با بسته مطابقت دارد یا اگر هیچ کدام را پیدا نکردیم null است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
مولفه های | |
---|---|
runner | IRemoteAndroidTestRunner |