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, 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ủ.

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

Tóm tắt

Trường
`public static final String`	`SET_OPTION_DESC`
`public static final 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 `ERROR(/Set)` chú thích để loại trừ nếu kiểm thử được đánh dấu bằng chú thích đó.
`void`	`addAllExcludeFilters( filters)` Thêm `ERROR(/Set)` của bộ lọc về các kiểm thử cần loại trừ.
`void`	`addAllIncludeAnnotation( annotations)` Thêm `ERROR(/Set)` chú thích để đưa vào nếu kiểm thử có được đánh dấu bằng chú thích đó.
`void`	`addAllIncludeFilters( filters)` Thêm `ERROR(/Set)` của bộ lọc bao gồm các kiểm thử.
`void`	`addExcludeAnnotation(String notAnnotation)` Thêm chú thích để loại trừ nếu kiểm thử được đánh dấu bằng chú thích đó.
`void`	`addExcludeFilter(String filter)` Thêm bộ lọc về các chương trình kiểm thử cần loại trừ.
`void`	`addIncludeAnnotation(String annotation)` Thêm chú thích để đưa vào nếu kiểm thử được đánh dấu bằng chú thích đó.
`void`	`addIncludeFilter(String filter)` Thêm bộ lọc về các 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ả bộ lọc loại trừ hiện đang được theo dõi.
`void`	`clearIncludeAnnotations()` Xoá tất cả chú thích bao gồm hiện đang được theo dõi.
`void`	`clearIncludeFilters()` Xoá tất 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 trong 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 bộ lọc loại trừ.
	`getIncludeAnnotations()` Trả về `ERROR(/Set)` hiện tại của các chú giải 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 kiểm thử
`void`	`setConfiguration(IConfiguration configuration)` Chèn `IConfiguration` đang sử dụng.
`void`	`setDevice(ITestDevice device)` Chèn thiết bị đang được kiểm thử.
`static void`	`setOptionToLoadedObject(Object testObj, keyValueOptions)` Trình trợ giúp cho Trình chạy thiết bị để sử dụng nhằm đặt các tuỳ chọn giống như HostTest, từ set-option.
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` Chúng ta phân tách theo từng cá nhân theo lớp kiểm thử hoặc phương thức kiểm thử.

Phương thức được bảo vệ
`HostTest`	`createHostTest(Class<?> classObj)` Trình 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í thường chứa cấu phần phần mềm cho các trường hợp sử dụng khác nhau để tìm tệp jar của chúng ta.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Trình trợ giúp để xác định xem chúng ta có đang xử lý một lớp Kiểm thử có 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 để 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.

Trường

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

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 ERROR(/Set) chú thích để loại trừ nếu kiểm thử được đánh dấu bằng chú thích đó.

Tham số
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Thêm ERROR(/Set) của bộ lọc về các kiểm thử cần loại trừ.

Tham số
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

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

Tham số
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Thêm ERROR(/Set) của bộ lọc bao gồm các kiểm thử.

Tham số
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

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

Tham số
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

Thêm bộ lọc về các chương trình kiểm thử cần loại trừ.

Tham số
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Thêm chú thích để đưa vào nếu 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 về các 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ả bộ lọc loại trừ hiện đang được theo dõi.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Xoá tất cả chú thích bao gồm hiện đang được theo dõi.

clearIncludeFilters

public void clearIncludeFilters ()

Xoá tất 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 trong 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 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ú giải 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 để tải cân bằng 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 chương trình kiểm thử.
`listener`	`ITestInvocationListener`: `ITestInvocationListener` của kết quả kiểm thử

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 kiểm thử

setConfiguration

public void setConfiguration (IConfiguration configuration)

Chèn IConfiguration đang sử 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ình trợ giúp cho Trình chạy thiết bị để sử dụng nhằm đặt các tuỳ chọn giống như HostTest, từ set-option.

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

setTestInformation

public void setTestInformation (TestInformation testInfo)

Tham số
`testInfo`	`TestInformation`

tách

public  split (Integer shardCount, 
                TestInformation testInfo)

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

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

Giá trị trả về
	một tập hợp các chương trình kiểm thử phụ sẽ được thực thi riêng biệt hoặc `null` nếu chương trình 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ình trợ giúp để tạo một thực thể HostTest khi phân đoạn. Ghi đè để trả về bất kỳ thành phần con nào từ HostTest.

Tham số
`classObj`	`Class`

Giá trị trả về
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Nhận 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í thường chứa cấu phần phần mềm cho các trường hợp sử dụng khác nhau để tìm tệp jar của chúng ta.

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

Giá trị trả về
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Trình trợ giúp để xác định xem chúng ta có đang xử lý một lớp Kiểm thử có 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 để 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 chạy kiểm thử.