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

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

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