Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

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

Các lớp con trực tiếp đã biết

JarHostTest

JarHostTest Trình chạy kiểm thử cho các kiểm thử JUnit phía máy chủ lưu trữ.

Một trình chạy kiểm thử cho các kiểm thử dựa trên máy chủ lưu trữ JUnit. Nếu kiểm thử cần chạy triển khai IDeviceTest, trình chạy này sẽ truyền một thông tin tham chiếu đến thiết bị.

Tóm tắt

Hằng số
`String`	`SET_OPTION_DESC`
`String`	`SET_OPTION_NAME`

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

Phương thức công khai
`void`	`addAllExcludeAnnotation( notAnnotations)` Thêm một `ERROR(/Set)` chú thích để loại trừ nếu một kiểm thử được đánh dấu bằng chú thích đó.
`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`	`addAllIncludeAnnotation( annotations)` Thêm `ERROR(/Set)` chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó.
`void`	`addAllIncludeFilters( filters)` Thêm `ERROR(/Set)` bộ lọc mà bạn muốn đưa vào các kiểm thử.
`void`	`addExcludeAnnotation(String notAnnotation)` Thêm chú giải để loại trừ nếu một kiểm thử được đánh dấu bằng chú giải đó.
`void`	`addExcludeFilter(String filter)` Thêm bộ lọc để loại trừ các kiểm thử.
`void`	`addIncludeAnnotation(String annotation)` Thêm chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó.
`void`	`addIncludeFilter(String filter)` Thêm bộ lọc để chọn những kiểm thử cần đưa vào.
`void`	`clearExcludeAnnotations()` Xoá tất cả chú thích loại trừ hiện đang được theo dõi.
`void`	`clearExcludeFilters()` Xoá tất cả các bộ lọc loại trừ hiện đang được theo dõi.
`void`	`clearIncludeAnnotations()` Xoá tất cả chú thích include 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.
`int`	`countTestCases()` Trả về số lượng trường hợp kiểm thử trên tất cả các lớp thuộc các kiểm thử
`IAbi`	`getAbi()`
	`getClassNames()`
`ITestDevice`	`getDevice()` Lấy thiết bị đang được kiểm thử.
	`getExcludeAnnotations()` Trả về `ERROR(/Set)` hiện tại của các chú thích cần loại trừ.
	`getExcludeFilters()` Trả về `ERROR(/Set)` hiện tại của các bộ lọc loại trừ.
	`getIncludeAnnotations()` Trả về `ERROR(/Set)` hiện tại của các chú thích cần đưa vào.
	`getIncludeFilters()` Trả về `ERROR(/Set)` hiện tại của bộ lọc bao gồm.
`long`	`getRuntimeHint()` Trả về thời gian chạy dự kiến của kiểm thử tính bằng mili giây.
`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`	`setAbi(IAbi abi)`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm
`void`	`setConfiguration(IConfiguration configuration)` Chèn `IConfiguration` đang dùng.
`void`	`setDevice(ITestDevice device)` Chèn thiết bị đang được kiểm thử.
`static void`	`setOptionToLoadedObject(Object testObj, keyValueOptions)` Trợ giúp cho Device Runners sử dụng để đặt các lựa chọn theo cách tương tự như HostTest, từ set-option.
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` Chúng tôi chia theo từng cá nhân theo lớp hoặc phương thức kiểm thử.

Phương thức được bảo vệ
`HostTest`	`createHostTest(Class<?> classObj)` Trợ giúp tạo một thực thể HostTest khi phân đoạn.
`IBuildInfo`	`getBuild()` Nhận thông tin bản dựng mà HostTest nhận được.
`ClassLoader`	`getClassLoader()` Trả về trình tải lớp mặc định.
`final`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Kiểm tra một số vị trí mà thường có các cấu phần phần mềm cho nhiều trường hợp sử dụng để tìm jar của chúng ta.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Trợ giúp xác định xem chúng ta có đang xử lý lớp Kiểm thử bằng chú thích Junit4 hay không.
`Object`	`loadObject(Class<?> classObj)` tải đối tượng lớp và đặt thông tin kiểm thử (thiết bị, bản dựng).
`void`	`setClassName(String className)` Xoá rồi đặt tên lớp sẽ chạy.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Kiểm tra xem một phần tử có chú thích có vượt qua bộ lọc hay không.

Hằng số

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Giá trị không đổi: "Các lựa chọn sẽ được truyền xuống lớp đang kiểm thử, khoá và giá trị phải được phân tách bằng dấu hai chấm ":"; ví dụ: nếu lớp đang kiểm thử hỗ trợ "--iteration 1" từ dòng lệnh, thì lớp đó phải được truyền vào dưới dạng "--set-option iteration:1" hoặc "--set-option iteration:key=value" để truyền các lựa chọn vào bản đồ. Bạn có thể dùng dấu gạch chéo ngược để thoát các giá trị chứa ":" hoặc "=". Bạn có thể nhắm đến một lớp cụ thể bằng cách chỉ định lớp đó. " --set-option :

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Giá trị không đổi: "set-option"

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

HostTest

public HostTest ()

Phương thức công khai

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Thêm một ERROR(/Set) chú thích để loại trừ nếu một kiểm thử được đánh dấu bằng chú thích đó.

Tham số
`notAnnotations`

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`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Thêm ERROR(/Set) chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó.

Tham số
`annotations`

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`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Thêm chú giải để loại trừ nếu một kiểm thử được đánh dấu bằng chú giải đó.

Tham số
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

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

Tham số
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Thêm chú thích để đưa vào nếu một kiểm thử được đánh dấu bằng chú thích đó.

Tham số
`annotation`	`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`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Xoá tất cả chú thích loại trừ hiện đang được theo dõi.

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Xoá tất cả chú thích include 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.

countTestCases

public int countTestCases ()

Trả về số lượng trường hợp kiểm thử trên tất cả các lớp thuộc các kiểm thử

Giá trị trả về
`int`

getAbi

public IAbi getAbi ()

Giá trị trả về
`IAbi`

getClassNames

public  getClassNames ()

Giá trị trả về

getDevice

public ITestDevice getDevice ()

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

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

getExcludeAnnotations

public  getExcludeAnnotations ()

Trả về ERROR(/Set) hiện tại của các chú thích cần loại trừ.

Giá trị trả về

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ề

getIncludeAnnotations

public  getIncludeAnnotations ()

Trả về ERROR(/Set) hiện tại của các chú thích cần đưa vào.

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ề

getRuntimeHint

public long getRuntimeHint ()

Trả về thời gian chạy dự kiến của kiểm thử tính bằng mili giây. Thời gian này được dùng để cân bằng tải quá trình thực thi phân đoạn

Giá trị trả về
`long`

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`

setAbi

public void setAbi (IAbi abi)

Tham số
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

Tham số
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Bật hoặc tắt chế độ thu thập dữ liệu thử nghiệm

setConfiguration

public void setConfiguration (IConfiguration configuration)

Chèn IConfiguration đang dùng.

Tham số
`configuration`	`IConfiguration`

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

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Trợ giúp cho Device Runner sử dụng để đặt các lựa chọn theo cách tương tự như HostTest, từ set-option.

Tham số
`testObj`	`Object`: đối tượng sẽ nhận các lựa chọn.
`keyValueOptions`	: danh sách các lựa chọn được định dạng theo yêu cầu của HostTest set-option.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Tham số
`testInfo`	`TestInformation`

tách

public  split (Integer shardCount, 
                TestInformation testInfo)

Chúng tôi chia theo từng cá nhân theo lớp hoặc phương thức kiểm thử.

Tham số
`shardCount`	`Integer`: số lượng phân đoạn đã thử.
`testInfo`	`TestInformation`: `TestInformation` mẹ

Giá trị trả về
	một tập hợp các kiểm thử phụ sẽ được thực thi riêng biệt hoặc `null` nếu kiểm thử hiện không phân đoạn được

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

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Trợ giúp tạo một thực thể HostTest khi phân đoạn. Ghi đè để trả về mọi thành phần con từ HostTest.

Tham số
`classObj`	`Class`

Giá trị trả về
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Lấy thông tin bản dựng mà HostTest nhận được.

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

getClassLoader

protected ClassLoader getClassLoader ()

Trả về trình tải lớp mặc định.

Giá trị trả về
`ClassLoader`

getClasses

protected final  getClasses ()

Giá trị trả về

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Kiểm tra một số vị trí mà thường có các cấu phần phần mềm cho nhiều trường hợp sử dụng để tìm jar của chúng ta.

Tham số
`jarName`	`String`
`testInfo`	`TestInformation`

Giá trị trả về
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Trợ giúp xác định xem chúng ta có đang xử lý lớp Kiểm thử bằng chú thích Junit4 hay không.

Tham số
`classObj`	`Class`

Giá trị trả về
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

tải đối tượng lớp và đặt thông tin kiểm thử (thiết bị, bản dựng).

Tham số
`classObj`	`Class`

Giá trị trả về
`Object`

setClassName

protected void setClassName (String className)

Xoá rồi đặt tên lớp sẽ chạy.

Tham số
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Kiểm tra xem một phần tử có chú thích có vượt qua bộ lọc hay không. Được hiển thị để kiểm thử đơn vị.

Giá trị trả về
`boolean`	false nếu không nên chạy kiểm thử.