Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

UiAutomatorTest

public class UiAutomatorTest
extends Object implements IDeviceTest, IRemoteTest, ITestFilterReceiver

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

Tóm tắt

Trường
`protected`	`mListeners`

Hàm khởi tạo công khai
`UiAutomatorTest()`

Phương thức công khai
`void`	`addAllExcludeFilters( filters)` Thêm `ERROR(/Set)` bộ lọc mà bạn muốn loại trừ khỏi các kiểm thử.
`void`	`addAllIncludeFilters( filters)` Thêm `ERROR(/Set)` bộ lọc mà bạn muốn đưa vào các kiểm thử.
`void`	`addClassName(String className)` Thêm tên lớp kiểm thử để chạy.
`void`	`addClassNames( classNames)` Thêm một bộ sưu tập tên lớp kiểm thử để chạy.
`void`	`addExcludeFilter(String filter)` Thêm bộ lọc để loại trừ các kiểm thử.
`void`	`addIncludeFilter(String filter)` Thêm bộ lọc để chọn những kiểm thử cần đưa vào.
`void`	`addRunArg(String key, String value)` Thêm một đối số để cung cấp khi chạy các kiểm thử UI Automator
`void`	`clearExcludeFilters()` Xoá tất cả các bộ lọc loại trừ hiện đang được theo dõi.
`void`	`clearIncludeFilters()` Xoá tất cả các bộ lọc bao gồm hiện đang được theo dõi.
	`getClassNames()` Lấy danh sách tên lớp kiểm thử mà bộ kiểm thử được định cấu hình để chạy
`ITestDevice`	`getDevice()` Lấy thiết bị đang được kiểm thử.
	`getExcludeFilters()` Trả về `ERROR(/Set)` hiện tại của các bộ lọc loại trừ.
	`getIncludeFilters()` Trả về `ERROR(/Set)` hiện tại của bộ lọc bao gồm.
`long`	`getSyncTime()`
	`getTestJarPaths()`
	`getTestRunArgMap()`
`IRemoteAndroidTestRunner`	`getTestRunner()`
`boolean`	`isInstrumentationTest()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Chạy các bài kiểm thử và báo cáo kết quả cho trình nghe.
`void`	`setCaptureLogs(boolean captureLogs)` Phương thức này không được dùng nữa. thay vào đó, hãy sử dụng `setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption)`. Được giữ lại để tương thích với cts-tradefed
`void`	`setDevice(ITestDevice device)` Chèn thiết bị đang được kiểm thử.
`void`	`setLoggingOption(UiAutomatorTest.LoggingOption loggingOption)`
`void`	`setRunName(String runName)`
`void`	`setRunnerName(String runnerName)`
`void`	`setSyncTime(long syncTime)`
`void`	`setTestJarPaths( jarPaths)`
`void`	`setTestRunArgMap( runArgMap)`

Phương thức được bảo vệ
`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()` Kiểm tra xem các thành phần UI Automator có trên thiết bị hay không

Trường

mListeners

protected  mListeners

Hàm khởi tạo công khai

UiAutomatorTest

public UiAutomatorTest ()

Phương thức công khai

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Thêm ERROR(/Set) bộ lọc mà bạn muốn loại trừ khỏi các kiểm thử.

Tham số
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Thêm ERROR(/Set) bộ lọc mà bạn muốn đưa vào các kiểm thử.

Tham số
`filters`

addClassName

public void addClassName (String className)

Thêm tên lớp kiểm thử để chạy.

Tham số
`className`	`String`

addClassNames

public void addClassNames ( classNames)

Thêm một bộ sưu tập tên lớp kiểm thử để chạy.

Tham số
`classNames`

addExcludeFilter

public void addExcludeFilter (String filter)

Thêm bộ lọc để loại trừ các kiểm thử.

Tham số
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

Thêm bộ lọc để chọn những kiểm thử cần đưa vào.

Tham số
`filter`	`String`

addRunArg

public void addRunArg (String key, 
                String value)

Thêm một đối số để cung cấp khi chạy các kiểm thử UI Automator

Tham số
`key`	`String`: tên đối số
`value`	`String`: giá trị đối số

clearExcludeFilters

public void clearExcludeFilters ()

Xoá tất cả các bộ lọc loại trừ hiện đang được theo dõi.

clearIncludeFilters

public void clearIncludeFilters ()

Xoá tất cả các bộ lọc bao gồm hiện đang được theo dõi.

getClassNames

public  getClassNames ()

Lấy danh sách tên lớp kiểm thử mà bộ kiểm thử được định cấu hình để chạy

Giá trị trả về
	danh sách tên lớp kiểm thử

getDevice

public ITestDevice getDevice ()

Lấy thiết bị đang được kiểm thử.

Giá trị trả về
`ITestDevice`	`ITestDevice`

getExcludeFilters

public  getExcludeFilters ()

Trả về ERROR(/Set) hiện tại của các bộ lọc loại trừ.

Giá trị trả về

getIncludeFilters

public  getIncludeFilters ()

Trả về ERROR(/Set) hiện tại của bộ lọc bao gồm.

Giá trị trả về

getSyncTime

public long getSyncTime ()

Giá trị trả về
`long`	thời gian được phân bổ để đồng bộ hoá các bài kiểm thử.

getTestJarPaths

public  getTestJarPaths ()

Giá trị trả về
	đường dẫn jar kiểm thử.

getTestRunArgMap

public  getTestRunArgMap ()

Giá trị trả về
	các đối số ánh xạ để truyền đến UiAutomatorRunner.

getTestRunner

public IRemoteAndroidTestRunner getTestRunner ()

Giá trị trả về
`IRemoteAndroidTestRunner`	trình chạy kiểm thử.

isInstrumentationTest

public boolean isInstrumentationTest ()

Giá trị trả về
`boolean`

chạy

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Chạy các bài kiểm thử và báo cáo kết quả cho trình nghe.

Tham số
`testInfo`	`TestInformation`: Đối tượng `TestInformation` chứa thông tin hữu ích để chạy các bài kiểm thử.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` kết quả kiểm tra

Gửi
`DeviceNotAvailableException`

setCaptureLogs

public void setCaptureLogs (boolean captureLogs)

Phương thức này không được dùng nữa.
hãy sử dụng setLoggingOption(com.android.tradefed.testtype.UiAutomatorTest.LoggingOption).

Được giữ lại để tương thích với cts-tradefed

Tham số
`captureLogs`	`boolean`

setDevice

public void setDevice (ITestDevice device)

Chèn thiết bị đang được kiểm thử.

Tham số
`device`	`ITestDevice`: `ITestDevice` cần sử dụng

setLoggingOption

public void setLoggingOption (UiAutomatorTest.LoggingOption loggingOption)

Tham số
`loggingOption`	`UiAutomatorTest.LoggingOption`

setRunName

public void setRunName (String runName)

Tham số
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Tham số
`runnerName`	`String`

setSyncTime

public void setSyncTime (long syncTime)

Tham số
`syncTime`	`long`: thời gian đồng bộ hoá các tệp kiểm thử.

setTestJarPaths

public void setTestJarPaths ( jarPaths)

Tham số
`jarPaths`	: vị trí của các jar kiểm thử.

setTestRunArgMap

public void setTestRunArgMap ( runArgMap)

Tham số
`runArgMap`	: các đối số cần truyền đến UiAutomatorRunner.

Phương thức được bảo vệ

createTestRunner

protected IRemoteAndroidTestRunner createTestRunner ()

Giá trị trả về
`IRemoteAndroidTestRunner`

Gửi
`DeviceNotAvailableException`

getRunUtil

protected IRunUtil getRunUtil ()

Giá trị trả về
`IRunUtil`

onScreenshotAndBugreport

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

Tham số
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`
`overrideAction`	`UiAutomatorTest.TestFailureAction`

onScreenshotAndBugreport

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

Tham số
`device`	`ITestDevice`
`listener`	`ITestInvocationListener`
`prefix`	`String`

preTestSetup

protected void preTestSetup ()

Kiểm tra xem các thành phần UI Automator có trên thiết bị hay không

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`