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.

ITestStorageClient

public interface ITestStorageClient

com.google.android.tradefed.result.teststorage.ITestStorageClient

Các lớp con gián tiếp đã biết

Khách hàng

Khách hàng Ứng dụng lưu trữ kiểm thử Android tải kết quả kiểm thử lên dịch vụ Lưu trữ kiểm thử.

Giao diện để giao tiếp với phần phụ trợ Bộ nhớ kiểm thử Android. Giao diện này chứa các phương thức để tạo và cập nhật lệnh gọi cũng như đơn vị công việc và tải kết quả kiểm thử lên. Để tạo hoặc cập nhật các đơn vị công việc hoặc kết quả kiểm thử, các đơn vị này phải thuộc một lệnh gọi do ứng dụng này tạo hoặc lệnh gọi phải được thêm bằng phương thức addInvocation.

Tóm tắt

Phương thức công khai
`abstract Invocation`	`createInvocation(Invocation invocation)` Tạo một lệnh gọi trong Bộ nhớ kiểm thử bằng dữ liệu trong lệnh gọi được cung cấp.
`abstract Build`	`createLocalBuild(Build localBuild)` Chèn bản dựng cục bộ vào phần phụ trợ.
`abstract WorkUnit`	`createWorkUnit(WorkUnit workUnit)` Tạo một đơn vị công việc trong Bộ nhớ kiểm thử.
`abstract ImmutableList<WorkUnit>`	`createWorkUnits( workUnits)` Tạo tất cả các đơn vị công việc trong danh sách được cung cấp trong TestStorage.
`abstract File`	`fetchTestArtifact(String invocationId, String resourceId)` Tìm nạp và trả về tệp cấu phần phần mềm kiểm thử thực tế được yêu cầu.
`abstract void`	`finalizeTestResults()` Chờ cho đến khi tất cả kết quả kiểm thử được tải lên.
`abstract Invocation`	`getInvocation(String invocationId)` Trả về một lệnh gọi có mã lệnh gọi được cung cấp.
`abstract BuildArtifactMetadata`	`getTestArtifact(String invocationId, String resourceId)` Trả về một cấu phần phần mềm kiểm thử khớp với lệnh gọi và mã nhận dạng tài nguyên đã cung cấp.
`abstract WorkUnit`	`getWorkUnit(String workUnitId)` Trả về một workunit khớp với mã nhận dạng được cung cấp.
`abstract TestArtifactListResponse`	`listTestArtifact(String invocationId, String artifactType)` Tìm kiếm và liệt kê tất cả các cấu phần phần mềm kiểm thử khớp với loại được cung cấp.
`abstract Invocation`	`updateInvocation(Invocation invocation)` Cập nhật một lệnh gọi trong Bộ nhớ kiểm thử bằng dữ liệu trong lệnh gọi được cung cấp.
`abstract BuildArtifactMetadata`	`updateTestArtifact(String invocationId, String workUnitId, String testResultId, BuildArtifactMetadata artifact, long legacyId)` Cập nhật cấu phần phần mềm được cung cấp.
`abstract BuildArtifactMetadata`	`updateTestArtifact(BuildArtifactMetadata artifact, long legacyId, AbstractInputStreamContent content)` Cập nhật cấu phần phần mềm đã cung cấp và tải nội dung đã cung cấp lên.
`abstract WorkUnit`	`updateWorkUnit(WorkUnit workUnit)` Cập nhật một đơn vị công việc được cung cấp trong Bộ nhớ kiểm thử.
`abstract void`	`uploadAssociations( associations, int poolSize)` Tải mối liên kết giữa nhật ký và các đơn vị kiểm thử/công việc lên.
`abstract void`	`uploadResult(TestResult result)` Tải kết quả kiểm thử đã cung cấp lên Bộ nhớ kiểm thử.

Phương thức công khai

createInvocation

public abstract Invocation createInvocation (Invocation invocation)

Tạo một lệnh gọi trong Bộ nhớ kiểm thử bằng dữ liệu trong lệnh gọi được cung cấp.

Tham số
`invocation`	`Invocation`: – mô tả lệnh gọi sẽ được tạo.

Giá trị trả về
`Invocation`	lệnh gọi được tạo trong Bộ nhớ kiểm thử.

Gửi
	IOException

createLocalBuild

public abstract Build createLocalBuild (Build localBuild)

Chèn bản dựng cục bộ vào phần phụ trợ.

Tham số
`localBuild`	`Build`: nội dung mô tả về bản dựng cục bộ

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

Gửi
	IOException

createWorkUnit

public abstract WorkUnit createWorkUnit (WorkUnit workUnit)

Tạo một đơn vị công việc trong Bộ nhớ kiểm thử.

Tham số
`workUnit`	`WorkUnit`: – mô tả đơn vị công việc cần tạo.

Giá trị trả về
`WorkUnit`	một đơn vị công việc mới.

Gửi
	IOException

createWorkUnits

public abstract ImmutableList<WorkUnit> createWorkUnits ( workUnits)

Tạo tất cả các đơn vị công việc trong danh sách được cung cấp trong TestStorage.

Tham số
`workUnits`	: – danh sách các đơn vị công việc cần tạo.

Giá trị trả về
`ImmutableList<WorkUnit>`	danh sách các đơn vị công việc đã được tạo.

Gửi
	IOException

fetchTestArtifact

public abstract File fetchTestArtifact (String invocationId, 
                String resourceId)

Tìm nạp và trả về tệp cấu phần phần mềm kiểm thử thực tế được yêu cầu.

Tham số
`invocationId`	`String`
`resourceId`	`String`

Giá trị trả về
`File`

finalizeTestResults

public abstract void finalizeTestResults ()

Chờ cho đến khi tất cả kết quả kiểm thử được tải lên.

getInvocation

public abstract Invocation getInvocation (String invocationId)

Trả về một lệnh gọi có mã lệnh gọi được cung cấp.

Tham số
`invocationId`	`String`: – mã nhận dạng của lệnh gọi cần trả về.

Giá trị trả về
`Invocation`

Gửi
	– nếu không tìm thấy lệnh gọi được cung cấp hoặc nếu có lỗi khi giao tiếp với phần phụ trợ.

getTestArtifact

public abstract BuildArtifactMetadata getTestArtifact (String invocationId, 
                String resourceId)

Trả về một cấu phần phần mềm kiểm thử khớp với lệnh gọi và mã nhận dạng tài nguyên đã cung cấp.

Tham số
`invocationId`	`String`
`resourceId`	`String`

Giá trị trả về
`BuildArtifactMetadata`

getWorkUnit

public abstract WorkUnit getWorkUnit (String workUnitId)

Trả về một đơn vị công việc khớp với mã nhận dạng được cung cấp.

Tham số
`workUnitId`	`String`: – mã nhận dạng của đơn vị công việc.

Giá trị trả về
`WorkUnit`

Gửi
	– nếu không tìm thấy đơn vị công việc được cung cấp hoặc xảy ra lỗi khi giao tiếp với các dịch vụ phụ trợ.

listTestArtifact

public abstract TestArtifactListResponse listTestArtifact (String invocationId, 
                String artifactType)

Tìm kiếm và liệt kê tất cả các cấu phần phần mềm kiểm thử khớp với loại được cung cấp.

Tham số
`invocationId`	`String`
`artifactType`	`String`

Giá trị trả về
`TestArtifactListResponse`

updateInvocation

public abstract Invocation updateInvocation (Invocation invocation)

Cập nhật một lệnh gọi trong Bộ nhớ kiểm thử bằng dữ liệu trong lệnh gọi được cung cấp.

Tham số
`invocation`	`Invocation`: – lệnh gọi có dữ liệu đã cập nhật.

Giá trị trả về
`Invocation`	một lệnh gọi đã được cập nhật.

Gửi
	IOException

updateTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (String invocationId, 
                String workUnitId, 
                String testResultId, 
                BuildArtifactMetadata artifact, 
                long legacyId)

Cập nhật cấu phần phần mềm được cung cấp. Phương thức này chỉ cập nhật mối liên kết và không sửa đổi nội dung. Khi gọi phương thức này, hãy cung cấp mã lệnh gọi ban đầu, mã đơn vị công việc và mã kết quả kiểm thử dưới dạng đối số. Đặt đơn vị công việc mới và mã kết quả kiểm thử trong đối tượng BuildArtifactMetadata. Khi mã đơn vị công việc và/hoặc kết quả kiểm thử không được dùng trong mối liên kết, bạn nên đặt mã này thành chuỗi trống ("").

Tham số
`invocationId`	`String`
`workUnitId`	`String`
`testResultId`	`String`
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`

Giá trị trả về
`BuildArtifactMetadata`

updateTestArtifact

public abstract BuildArtifactMetadata updateTestArtifact (BuildArtifactMetadata artifact, 
                long legacyId, 
                AbstractInputStreamContent content)

Cập nhật cấu phần phần mềm đã cung cấp và tải nội dung đã cung cấp lên. Khi tải nội dung lên, bạn không thể cập nhật dữ liệu liên kết. Đừng sửa đổi mã đơn vị công việc và mã kết quả kiểm thử đã được đặt trong đối số BuildArtifactMetadata.

Tham số
`artifact`	`BuildArtifactMetadata`
`legacyId`	`long`
`content`	`AbstractInputStreamContent`

Giá trị trả về
`BuildArtifactMetadata`

updateWorkUnit

public abstract WorkUnit updateWorkUnit (WorkUnit workUnit)

Cập nhật một đơn vị công việc được cung cấp trong Bộ nhớ kiểm thử.

Tham số
`workUnit`	`WorkUnit`: – đơn vị công việc cần cập nhật.

Giá trị trả về
`WorkUnit`	đã cập nhật đơn vị công việc.

Gửi
	IOException

uploadAssociations

public abstract void uploadAssociations ( associations, 
                int poolSize)

Tải mối liên kết giữa nhật ký và các đơn vị kiểm thử/công việc lên. Các mối liên kết cho phép Bộ nhớ kiểm thử Android theo dõi xem kiểm thử nào đã tạo nhật ký.

Tham số
`associations`	: danh sách các tệp nhật ký và mối liên kết của chúng.
`poolSize`	`int`: Kích thước của nhóm worker dùng để tải lên song song. 0 nếu không tải lên song song.

Gửi
	IOException

uploadResult

public abstract void uploadResult (TestResult result)

Tải kết quả kiểm thử đã cung cấp lên Bộ nhớ kiểm thử. Kết quả kiểm thử phải là một phần của lệnh gọi đã tạo trước đó.

Tham số
`result`	`TestResult`: – kết quả để tải lên.

Gửi
	IOException