از سال ۲۰۲۶، برای همسو شدن با مدل توسعه پایدار trunk و تضمین پایداری پلتفرم برای اکوسیستم، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساخت و مشارکت در AOSP، توصیه می‌کنیم android-latest-release به جای aosp-main استفاده کنید. شاخه manifest در android-latest-release همیشه به جدیدترین نسخه منتشر شده در AOSP ارجاع می‌دهد. برای اطلاعات بیشتر، به تغییرات در AOSP مراجعه کنید.

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

تست خودکار رابط کاربری

public class UiAutomatorTest
extends Object implements IDeviceTest , IRemoteTest , ITestFilterReceiver

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

خلاصه

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

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

روش‌های عمومی
`void`	`addAllExcludeFilters ( filters)` `ERROR(/Set)` فیلترهایی را که تست‌هایشان باید حذف شوند، اضافه می‌کند.
`void`	`addAllIncludeFilters ( filters)` `ERROR(/Set)` فیلترهایی که تست‌هایشان باید لحاظ شوند را اضافه می‌کند.
`void`	`addClassName (String className)` نام کلاس آزمایشی را برای اجرا اضافه کنید.
`void`	`addClassNames ( classNames)` یک مجموعه نام کلاس آزمایشی برای اجرا اضافه کنید.
`void`	`addExcludeFilter (String filter)` فیلتری اضافه می‌کند که کدام تست‌ها باید حذف شوند.
`void`	`addIncludeFilter (String filter)` فیلتری اضافه می‌کند که کدام تست‌ها باید لحاظ شوند.
`void`	`addRunArg (String key, String value)` هنگام اجرای تست‌های UI Automator، یک آرگومان برای ارائه اضافه کنید
`void`	`clearExcludeFilters ()` تمام فیلترهای حذف‌شده‌ای که در حال حاضر ردیابی می‌شوند را حذف کنید.
`void`	`clearIncludeFilters ()` تمام فیلترهای موجود که در حال حاضر ردیابی می‌شوند را حذف کنید.
	`getClassNames ()` فهرست نام کلاس‌های آزمایشی که Harness برای اجرای آنها پیکربندی شده است را برمی‌گرداند.
`ITestDevice`	`getDevice ()` دستگاه را تحت آزمایش قرار دهید.
	`getExcludeFilters ()` مقدار `ERROR(/Set)` فعلی فیلترهای مستثنی شده را برمی‌گرداند.
	`getIncludeFilters ()` مقدار `ERROR(/Set)` فعلی فیلترهای include شده را برمی‌گرداند.
`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)`
`void`	`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 روی دستگاه وجود دارند یا خیر.

فیلدها

mListener ها

protected  mListeners

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

تست خودکار رابط کاربری

public UiAutomatorTest ()

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

فیلترهای addAllExclude

public void addAllExcludeFilters ( filters)

ERROR(/Set) فیلترهایی را که تست‌هایشان باید حذف شوند، اضافه می‌کند.

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

فیلترهای addAllInclude

public void addAllIncludeFilters ( filters)

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

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

نام کلاس را اضافه کنید

public void addClassName (String className)

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

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

اضافه کردن نام کلاس‌ها

public void addClassNames ( classNames)

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

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

فیلتر addExclude

public void addExcludeFilter (String filter)

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

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

فیلتر addInclude

public void addIncludeFilter (String filter)

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

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

addRunArg

public void addRunArg (String key, 
                String value)

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

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

فیلترهای clearExclude

public void clearExcludeFilters ()

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

فیلترهای clearInclude

public void clearIncludeFilters ()

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

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

public  getClassNames ()

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

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

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

public ITestDevice getDevice ()

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

بازگشت‌ها
`ITestDevice`	`ITestDevice`

فیلترهای getExclude

public  getExcludeFilters ()

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

بازگشت‌ها

فیلترهای getInclude

public  getIncludeFilters ()

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

بازگشت‌ها

دریافت همگام‌سازی زمان

public long getSyncTime ()

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

getTestJarPaths

public  getTestJarPaths ()

بازگشت‌ها
	مسیر شیشه آزمایش.

دریافتTestRunArgMap

public  getTestRunArgMap ()

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

دریافت تست رانر

public IRemoteAndroidTestRunner getTestRunner ()

بازگشت‌ها
`IRemoteAndroidTestRunner`	اجراکننده‌ی آزمایش

آزمون ابزار دقیق

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`

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

public void setDevice (ITestDevice device)

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

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

تنظیم گزینه ثبت وقایع

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

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

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

public void setRunName (String runName)

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

نام اجرایی setRunnerName

public void setRunnerName (String runnerName)

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

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

public void setSyncTime (long syncTime)

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

setTestJarPaths

public void setTestJarPaths ( jarPaths)

پارامترها
`jarPaths`	: محل قرارگیری ظروف آزمایش.

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

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

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

ایجاد تست‌رانر

protected IRemoteAndroidTestRunner createTestRunner ()

بازگشت‌ها
`IRemoteAndroidTestRunner`

پرتاب‌ها
`DeviceNotAvailableException`

دریافت RunUtil

protected IRunUtil getRunUtil ()

بازگشت‌ها
`IRunUtil`

onScreenshot و Bugreport

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

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

onScreenshot و Bugreport

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

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

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

protected void preTestSetup ()

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

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