از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

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

تست UiAutomator

public class UiAutomatorTest
extends Object implements IDeviceTest , IRemoteTest , ITestFilterReceiver

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

خلاصه

فیلدها
`protected`	`mListeners`

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

روش های عمومی
`void`	`addAllExcludeFilters ( filters)` `addAllExcludeFilters ( filters)` `ERROR(/Set)` فیلترهایی را اضافه می‌کند که آزمایش‌هایی را حذف می‌کند.
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` `ERROR(/Set)` فیلترهایی را اضافه می‌کند که آزمایش‌هایی که باید شامل شوند.
`void`	`addClassName (String className)` یک نام کلاس آزمایشی برای اجرا اضافه کنید.
`void`	`addClassNames ( classNames)` `addClassNames ( classNames)` یک مجموعه نام کلاس آزمایشی را برای اجرا اضافه کنید.
`void`	`addExcludeFilter (String filter)` فیلتری را اضافه می کند که کدام آزمایش را حذف کنید.
`void`	`addIncludeFilter (String filter)` فیلتری را اضافه می کند که کدام آزمایش را شامل شود.
`void`	`addRunArg (String key, String value)` هنگام اجرای تست های UI Automator یک آرگومان اضافه کنید
`void`	`clearExcludeFilters ()` تمام فیلترهای حذفی که در حال حاضر ردیابی شده اند را حذف کنید.
`void`	`clearIncludeFilters ()` تمام فیلترهای شامل که در حال حاضر ردیابی شده اند را حذف کنید.
	`getClassNames ()` فهرستی از نام‌های کلاس آزمایشی را که هارنس برای اجرای آنها پیکربندی شده است دریافت می‌کند
`ITestDevice`	`getDevice ()` دستگاه را تحت آزمایش قرار دهید.
	`getExcludeFilters ()` `ERROR(/Set)` فعلی فیلترهای حذف را برمی‌گرداند.
	`getIncludeFilters ()` `ERROR(/Set)` فعلی فیلترهای شامل را برمی‌گرداند.
`long`	`getSyncTime ()`
	`getTestJarPaths ()`
	`getTestRunArgMap ()`
`IRemoteAndroidTestRunner`	`getTestRunner ()`
`boolean`	`isInstrumentationTest ()`
`void`	`run ( TestInformation testInfo, ITestInvocationListener listener)` تست ها را اجرا می کند و نتیجه را به شنونده گزارش می دهد.
`void`	`setCaptureLogs (boolean captureLogs)` این روش منسوخ شده است. به جای آن `setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)` استفاده کنید. برای سازگاری با cts-tradefed حفظ شده است
`void`	`setDevice ( ITestDevice device)` دستگاه تحت آزمایش را تزریق کنید.
`void`	`setLoggingOption ( UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName (String runName)`
`void`	`setRunnerName (String runnerName)`
`void`	`setSyncTime (long syncTime)`
`void`	`setTestJarPaths ( jarPaths)` `setTestJarPaths ( jarPaths)`
`void`	`setTestRunArgMap ( runArgMap)` `setTestRunArgMap ( runArgMap)`

روش های محافظت شده
`IRemoteAndroidTestRunner`	`createTestRunner ()`
`IRunUtil`	`getRunUtil ()`
`void`	`onScreenshotAndBugreport ( ITestDevice device, ITestInvocationListener listener, String prefix, UiAutomatorTest.TestFailureAction overrideAction)`
`void`	`onScreenshotAndBugreport ( ITestDevice device, ITestInvocationListener listener, String prefix)`
`void`	`preTestSetup ()` بررسی می کند که آیا اجزای UI Automator در دستگاه وجود دارد یا خیر

فیلدها

mListeners

protected  mListeners

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

تست UiAutomator

public UiAutomatorTest ()

روش های عمومی

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

ERROR(/Set) فیلترهایی را اضافه می‌کند که آزمایش‌هایی را حذف می‌کند.

پارامترها
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

ERROR(/Set) فیلترهایی را اضافه می‌کند که آزمایش‌هایی که باید شامل شوند.

پارامترها
`filters`

addClassName

public void addClassName (String className)

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

پارامترها
`className`	`String`

addClassNames

public void addClassNames ( classNames)

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

پارامترها
`classNames`

addExcludeFilter

public void addExcludeFilter (String filter)

فیلتری را اضافه می کند که کدام آزمایش را حذف کنید.

پارامترها
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

فیلتری را اضافه می کند که کدام آزمایش را شامل شود.

پارامترها
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

هنگام اجرای تست های UI Automator یک آرگومان اضافه کنید

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

clearExcludeFilters

public void clearExcludeFilters ()

تمام فیلترهای حذفی که در حال حاضر ردیابی شده اند را حذف کنید.

clearIncludeFilters

public void clearIncludeFilters ()

تمام فیلترهای شامل که در حال حاضر ردیابی شده اند را حذف کنید.

getClassNames

public  getClassNames ()

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

برمی گرداند
	لیست اسامی کلاس های آزمون

getDevice

public ITestDevice getDevice ()

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

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

getExcludeFilters

public  getExcludeFilters ()

ERROR(/Set) فعلی فیلترهای حذف را برمی‌گرداند.

برمی گرداند

getIncludeFilters

public  getIncludeFilters ()

ERROR(/Set) فعلی فیلترهای شامل را برمی‌گرداند.

برمی گرداند

getSyncTime

public long getSyncTime ()

برمی گرداند
`long`	زمان اختصاص داده شده برای همگام سازی تست ها

getTestJarPaths

public  getTestJarPaths ()

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

getTestRunArgMap

public  getTestRunArgMap ()

برمی گرداند
	آرگومان ها نقشه می شوند تا به UiAutomatorRunner منتقل شوند.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

برمی گرداند
`IRemoteAndroidTestRunner`	دونده آزمون

isInstrumentationTest

public boolean isInstrumentationTest ()

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

اجرا کنید

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

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

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

این روش منسوخ شده است.
به جای آن setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption) استفاده کنید.

برای سازگاری با cts-tradefed حفظ شده است

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

setDevice

public void setDevice (ITestDevice device)

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

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

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

پارامترها
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

پارامترها
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

پارامترها
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

پارامترها
`syncTime`	`long` : زمان همگام سازی فایل های آزمایشی.

setTestJarPaths

public void setTestJarPaths ( jarPaths)

پارامترها
`jarPaths`	: محل کوزه های آزمایشی.

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

پارامترها
`runArgMap`	: آرگومان هایی که باید به UiAutomatorRunner منتقل شوند.

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

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

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

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

getRunUtil

protected IRunUtil getRunUtil ()

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

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix, 
                UiAutomatorTest.TestFailureAction overrideAction)

پارامترها
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

protected void onScreenshotAndBugreport (ITestDevice device, 
                ITestInvocationListener listener, 
                String prefix)

پارامترها
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

بررسی می کند که آیا اجزای UI Automator در دستگاه وجود دارد یا خیر

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`