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

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

شیء جاوا
↳ com.android.tradefed.testtype.InstrumentationTest

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

خلاصه

ثابت‌ها

String RUN_TESTS_AS_USER_KEY

String RUN_TESTS_ON_SDK_SANDBOX

فیلدها

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

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

InstrumentationTest ()

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

void addDeviceListeners ( extraListeners)

امکان اضافه کردن شنونده‌های سفارشی بیشتر به runner را فراهم می‌کند.

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 ()

امکان استفاده از برنامه‌ی Android Instrumentation Runner را فراهم می‌کند.

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)

لیست 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)

به صورت اختیاری، می‌توانید برنامه‌ی Android Instrumentation Runner را برای استفاده تنظیم کنید.

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)

مجموعه تست‌هایی را که باید توسط این InstrumentationTest اجرا شوند، تنظیم کنید.

void setWindowAnimation (boolean windowAnimation)

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

static excludeNonExecuted ( TestRunResult results)

برای ردیابی مواردی که نیاز به اجرای مجدد دارند، «NOT_EXECUTED» و «Skipped» را فیلتر کنید.

String getClassName ()

نام کلاس را برای اجرا دریافت کنید.

ListInstrumentationParser getListInstrumentationParser ()

از ListInstrumentationParser برای تجزیه و تحلیل کوئری‌های 'pm list instrumentation' استفاده کنید.

String getMethodName ()

روش تست را برای اجرا دریافت کنید.

String getTestPackageName ()

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

String queryRunnerName ()

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

void setRunnerArgs ( IRemoteAndroidTestRunner runner)

ثابت‌ها

اجرای تست‌ها به عنوان کلید کاربر 

public static final String RUN_TESTS_AS_USER_KEY

مقدار ثابت: "RUN_TESTS_AS_USER"

اجرای تست‌ها روی SDK و جعبه شنی 

public static final String RUN_TESTS_ON_SDK_SANDBOX

مقدار ثابت: "RUN_TESTS_ON_SDK_SANDBOX"

فیلدها

اشکال‌زدایی m 

protected boolean mDebug

mInstrumentSdkInSandbox 

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox 

protected boolean mInstrumentSdkSandbox

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

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

public InstrumentationTest ()

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

addDeviceListeners 

public void addDeviceListeners ( extraListeners)

امکان اضافه کردن شنونده‌های سفارشی بیشتر به runner را فراهم می‌کند.

پارامترها
extraListeners

addInstrumentationArg 

public void addInstrumentationArg (String key, 
                String value)

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

پارامترها
key String : نام آرگومان

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

دریافت ابی 

public IAbi getAbi ()

بازگشت‌ها
IAbi

دریافت پیکربندی 

public IConfiguration getConfiguration ()

IConfiguration مربوط به این تست را دریافت می‌کند.

بازگشت‌ها
IConfiguration

پوشش هدف 

public String getCoverageTarget ()

coverageTarget که قبلاً از طریق setCoverageTarget(String) تنظیم شده است را دریافت کنید.

بازگشت‌ها
String

اشکال‌زدایی 

public boolean getDebug ()

تنظیمات اشکال‌زدایی ابزار دقیق را دریافت کنید.

بازگشت‌ها
boolean تنظیمات اشکال‌زدایی بولی.

دریافت دستگاه 

public ITestDevice getDevice ()

دستگاه را تحت آزمایش قرار دهید.

بازگشت‌ها
ITestDevice ITestDevice

دریافت نیرو 

public String getForceAbi ()

بازگشت‌ها
String

دریافت حداکثر زمان‌بندی 

public long getMaxTimeout ()

حداکثر زمان وقفه تعیین شده برای ابزار دقیق را برمی‌گرداند.

بازگشت‌ها
long

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

public String getPackageName ()

بسته مانیفست اندروید را برای اجرا دریافت کنید.

بازگشت‌ها
String

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

public String getRunName ()

نام آزمایشی سفارشی را که به شنونده ارائه می‌شود، دریافت کنید

بازگشت‌ها
String

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

public String getRunnerName ()

امکان استفاده از برنامه‌ی Android Instrumentation Runner را فراهم می‌کند.

بازگشت‌ها
String

ایس‌ارکستراتور 

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

ست ابی 

public void setAbi (IAbi abi)

پارامترها
abi IAbi

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

public void setClassName (String testClassName)

به صورت اختیاری، نام کلاس تست را برای اجرا تنظیم کنید.

پارامترها
testClassName String

فقط تست‌های جمع‌آوری‌شده 

public void setCollectTestsOnly (boolean shouldCollectTest)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

تابع setCollectsTests و ShellTimeout 

public void setCollectsTestsShellTimeout (int timeout)

این روش منسوخ شده است.
این روش بدون عمل جراحی است

حداکثر زمان را بر حسب میلی‌ثانیه تنظیم کنید تا هنگام جمع‌آوری تست‌ها، «حداکثر زمان برای پوسته‌بندی پاسخ خروجی» در نظر گرفته شود.

پارامترها
timeout int

پیکربندی set 

public void setConfiguration (IConfiguration config)

IConfiguration مورد استفاده را تزریق می‌کند.

پارامترها
config IConfiguration

پوشش هدف 

public void setCoverageTarget (String coverageTarget)

هدف پوشش این آزمون را تعیین کنید.

در حال حاضر استفاده نمی‌شود. این متد فقط برای این ارائه شده است که coverageTarget بتواند بعداً از طریق getCoverageTarget() بازیابی شود.

پارامترها
coverageTarget String

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

public void setDebug (boolean debug)

تنظیمات اشکال‌زدایی ابزار دقیق را تنظیم کنید.

پارامترها
debug boolean : مقدار بولی برای تنظیم تنظیمات اشکال‌زدایی ابزار دقیق.

دستگاه تنظیم‌شده 

public void setDevice (ITestDevice device)

دستگاه تحت آزمایش را تزریق کنید.

پارامترها
device ITestDevice : دستگاه ITestDevice مورد استفاده

قالب‌بندی تنظیم‌شده 

public void setEnforceFormat (boolean enforce)

اگر فرمت خروجی AJUR ابزار دقیق را اجباری کنیم، مقدار True را تنظیم می‌کنیم.

پارامترها
enforce boolean

setForceAbi 

public void setForceAbi (String abi)

گزینه force-abi را تنظیم می‌کند.

نصب فایل 

public void setInstallFile (File installFile)

فایل اختیاری حاوی تست‌ها را برای نصب تنظیم کنید.

پارامترها
installFile File : ERROR(/File)

setIsolatedStorage 

public void setIsolatedStorage (boolean isolatedStorage)

تنظیم کنید که از فضای ذخیره‌سازی ایزوله استفاده نشود یا آب و هوا مرطوب‌تر باشد.

پارامترها
isolatedStorage boolean

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

public void setMethodName (String testMethodName)

به صورت اختیاری، متد تست را برای اجرا تنظیم کنید.

پارامترها
testMethodName String

مجموعه‌جمع‌کننده‌های متریک 

public void setMetricCollectors ( collectors)

لیست IMetricCollector های تعریف شده برای اجرای تست را تنظیم می‌کند.

پارامترها
collectors

تنظیم‌کننده 

public void setOrchestrator (boolean useOrchestrator)

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

پارامترها
useOrchestrator boolean

نام بسته را تنظیم کنید 

public void setPackageName (String packageName)

بسته مانیفست اندروید را برای اجرا تنظیم کنید.

پارامترها
packageName String

تنظیم مجدد اجرای با استفاده از فایل تست 

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

گزینه --rerun-from-file را تنظیم می‌کند.

پارامترها
reRunUsingTestFile boolean

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

public void setRerunMode (boolean rerun)

به صورت اختیاری، حالت تکرار را تنظیم کنید.

پارامترها
rerun boolean

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

public void setRunName (String runName)

نام اجرای آزمایشی سفارشی را که به شنونده ارائه می‌شود، تنظیم کنید.

پارامترها
runName String

نام اجرایی setRunnerName 

public void setRunnerName (String runnerName)

به صورت اختیاری، می‌توانید برنامه‌ی Android Instrumentation Runner را برای استفاده تنظیم کنید.

پارامترها
runnerName String

تنظیم زمان‌بند 

public void setShellTimeout (long timeout)

به صورت اختیاری، حداکثر زمان (برحسب میلی‌ثانیه) مورد انتظار برای خروجی پوسته از دستگاه را تنظیم کنید.

پارامترها
timeout long

تنظیم مسیر فایل تست روی دستگاه 

public void setTestFilePathOnDevice (String testFilePathOnDevice)

به صورت اختیاری، مسیر فایلی را که در دستگاه قرار دارد و باید شامل لیستی از کلاس‌ها و متدهای تست جدا شده از خط (با فرمت: com.foo.Class#method) برای اجرا باشد، تنظیم کنید. در صورت تنظیم، به جای اجرای دستورات adb جداگانه برای هر تست باقی مانده از طریق اجرای مجدد، به طور خودکار سعی می‌کند تست‌ها را با استفاده از این فایل تست از طریق InstrumentationFileTest دوباره اجرا کند.

پارامترها
testFilePathOnDevice String

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

public void setTestPackageName (String testPackageName)

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

اگر null نباشد، فقط تست‌های درون بسته‌ی جاوای داده شده اجرا خواهند شد.

اگر مقداری غیر تهی به setClassName(String) ارائه شده باشد، نادیده گرفته می‌شود.

پارامترها
testPackageName String

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

public void setTestSize (String size)

به صورت اختیاری، اندازه تست را برای اجرا تنظیم کنید.

پارامترها
size String

تنظیم زمان آزمون 

public void setTestTimeout (long timeout)

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

پارامترها
timeout long

setTestsToRun 

public void setTestsToRun ( tests)

مجموعه تست‌هایی را که باید توسط این InstrumentationTest اجرا شوند، تنظیم کنید.

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

انیمیشن پنجره تنظیم‌شده 

public void setWindowAnimation (boolean windowAnimation)

پارامترها
windowAnimation boolean

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

حذف نشده اجرا نشده 

protected static  excludeNonExecuted (TestRunResult results)

برای ردیابی مواردی که نیاز به اجرای مجدد دارند، «NOT_EXECUTED» و «Skipped» را فیلتر کنید.

پارامترها
results TestRunResult

بازگشت‌ها

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

protected String getClassName ()

نام کلاس را برای اجرا دریافت کنید.

بازگشت‌ها
String

تجزیه‌گر ابزار دقیق getList 

protected ListInstrumentationParser getListInstrumentationParser ()

از ListInstrumentationParser برای تجزیه و تحلیل کوئری‌های 'pm list instrumentation' استفاده کنید.

بازگشت‌ها
ListInstrumentationParser

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

protected String getMethodName ()

روش تست را برای اجرا دریافت کنید.

بازگشت‌ها
String

دریافت نام بسته آزمایشی 

protected String getTestPackageName ()

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

بازگشت‌ها
String

نام درخواست‌کننده 

protected String queryRunnerName ()

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

بازگشت‌ها
String اولین نام اجراکننده آزمایشی که با بسته مطابقت دارد یا اگر هیچ موردی پیدا نکنیم، null.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs 

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

پارامترها
runner IRemoteAndroidTestRunner