این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

تست ابزار دقیق

public class InstrumentationTest
extends Object implements IAbiReceiver , IConfigurationReceiver , IDeviceTest , IMetricCollectorReceiver , IRemoteTest , ITestCollector

java.lang.object
↳	com.android.tradefed.testtype.InstrumentationTest

زیر کلاس های مستقیم شناخته شده

AndroidJUnitTest ، CodeCoverageTest

AndroidJUnitTest	آزمایشی که یک بسته تست ابزار دقیق را با استفاده از android.support.test.runner.AndroidJUnitRunner روی دستگاه داده شده اجرا می کند.
CodeCoverageTest	تستی که یک بسته تست ابزار دقیق را روی یک دستگاه مشخص اجرا می کند و گزارش پوشش کد را ایجاد می کند.

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

خلاصه

فیلدها
`public static final String`	`RUN_TESTS_AS_USER_KEY`
`public static final String`	`RUN_TESTS_ON_SDK_SANDBOX`
`protected boolean`	`mDebug`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

سازندگان عمومی
`InstrumentationTest ()`

روش های عمومی
`void`	`addDeviceListeners ( extraListeners)` `addDeviceListeners ( extraListeners)` اجازه می دهد تا شنوندگان سفارشی بیشتری به رانر اضافه شود
`void`	`addInstrumentationArg (String key, String value)` هنگام اجرای تست های ابزار دقیق، یک آرگومان اضافه کنید.
`IAbi`	`getAbi ()`
`IConfiguration`	`getConfiguration ()` `IConfiguration` برای این تست دریافت می کند.
`String`	`getCoverageTarget ()` CoverageTarget را که قبلاً از طریق `setCoverageTarget(String)` تنظیم شده بود دریافت کنید.
`boolean`	`getDebug ()` تنظیمات اشکال زدایی ابزار دقیق را دریافت کنید.
`ITestDevice`	`getDevice ()` دستگاه را تحت آزمایش قرار دهید.
`String`	`getForceAbi ()`
`long`	`getMaxTimeout ()` حداکثر زمان تعیین شده برای ابزار دقیق را برمی گرداند.
`String`	`getPackageName ()` بسته مانیفست اندروید را برای اجرا دریافت کنید.
`String`	`getRunName ()` نام اجرای آزمایشی سفارشی را که برای شنونده ارائه می شود، دریافت کنید
`String`	`getRunnerName ()` دونده ابزار دقیق اندروید را برای استفاده دریافت می کند.
`boolean`	`isOrchestrator ()` مقدار `ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)` را برمی گرداند.
`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)` `IConfiguration` در حال استفاده را تزریق می کند.
`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)` لیست `IMetricCollector` های تعریف شده برای اجرای آزمایشی را تنظیم می کند.
`void`	`setOrchestrator (boolean useOrchestrator)` گزینه --orchestrator را تنظیم می کند
`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 ()` `ListInstrumentationParser` مورد استفاده برای تجزیه پرس و جوهای 'pm list instrumentation' را دریافت کنید.
`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

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

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

تست ابزار دقیق

public InstrumentationTest ()

روش های عمومی

افزودن DeviceListeners

public void addDeviceListeners ( extraListeners)

اجازه می دهد تا شنوندگان سفارشی بیشتری به رانر اضافه شود

پارامترها
`extraListeners`

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

هنگام اجرای تست های ابزار دقیق، یک آرگومان اضافه کنید.

پارامترها
`key`	`String` : نام آرگومان
`value`	`String` : مقدار آرگومان

getAbi

public IAbi getAbi ()

برمی گرداند
`IAbi`

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`

isOrchestrator

public boolean isOrchestrator ()

مقدار ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator) را برمی گرداند.

برمی گرداند
`boolean`

اجرا کنید

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

پارامترها
`testInfo`	`TestInformation` : شی `TestInformation` حاوی اطلاعات مفید برای اجرای تست ها.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` نتایج آزمون

پرتاب می کند
`DeviceNotAvailableException`

setAbi

public void setAbi (IAbi abi)

پارامترها
`abi`	`IAbi`

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`

مجموعه ارکستراتور

public void setOrchestrator (boolean useOrchestrator)

گزینه --orchestrator را تنظیم می کند

پارامترها
`useOrchestrator`	`boolean`

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 static  excludeNonExecuted (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`