Để 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 năm 2026. Để tạo và đóng góp cho AOSP, hãy sử dụng android-latest-release. 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.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

GoogleTradefedSandbox

public class GoogleTradefedSandbox
extends TradefedSandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox
	↳	com.google.android.tradefed.sandbox.GoogleTradefedSandbox

Chuyên môn nội bộ của TradefedSandbox sẽ được dùng trong cơ sở hạ tầng phòng thí nghiệm. Điều này giải quyết nhu cầu tải phiên bản thích hợp được liên kết với bản dựng xuống. Chúng tôi có thể chuyển việc này sang AOSP nếu một ngày nào đó chúng tôi có thể dựa vào API AOSP để tải bản dựng xuống.

Tóm tắt

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

Phương thức công khai
`String`	`createClasspath(File workingDir)` Hộp cát Google Tradefed chỉ sử dụng các tệp jar bên trong thư mục đang hoạt động.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Chế độ đặc biệt bị ngắt kết nối khỏi lần chạy chính: Khi một cấu hình dường như không tồn tại trong phần tử mẹ, chúng ta sẽ quay lại trình chạy mỏng, nơi chúng ta cố gắng thiết lập hộp cát bằng thông tin hiện tại đã biết và điền vào thư mục làm việc để tạo cấu hình đầy đủ trong thư mục có phiên bản.
`Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger)`
`IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)`
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`void`	`tearDown()` Dọn dẹp mọi trạng thái, tệp hoặc môi trường có thể đã bị thay đổi.

Phương thức được bảo vệ
`File`	`dumpGlobalConfig(IConfiguration config, Set<String> exclusionPatterns)` Kết xuất cấu hình chung được lọc từ một số đối tượng.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Chuẩn bị và tuần tự hoá `IInvocationContext`.

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

GoogleTradefedSandbox

public GoogleTradefedSandbox ()

Phương thức công khai

createClasspath

public String createClasspath (File workingDir)

Hộp cát Google Tradefed chỉ sử dụng các tệp jar bên trong thư mục đang hoạt động.

Tham số
`workingDir`	`File`: thư mục đang hoạt động hiện tại cho hộp cát.

Giá trị trả về
`String`	Đường dẫn lớp sẽ được sử dụng.

Gửi
`ConfigurationException`

createThinLauncherConfig

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Chế độ đặc biệt bị ngắt kết nối khỏi lần chạy chính: Khi một cấu hình dường như không tồn tại trong phần tử mẹ, chúng ta sẽ quay lại trình chạy mỏng, nơi chúng ta cố gắng thiết lập hộp cát bằng thông tin hiện tại đã biết và điền vào thư mục làm việc để tạo cấu hình đầy đủ trong thư mục có phiên bản.

Tham số
`args`	`String`: Các đối số dòng lệnh ban đầu.
`keyStoreClient`	`IKeyStoreClient`: ứng dụng kho khoá hiện tại dùng để tạo cấu hình.
`runUtil`	`IRunUtil`: `IRunUtil` hiện tại để chạy các lệnh của máy chủ.
`globalConfig`	`File`: Cấu hình chung để dùng chạy các quy trình con của TF.

Giá trị trả về
`IConfiguration`	một Tệp trỏ đến cấu hình XML của TF cho các đối tượng NON_VERSIONED. Trả về giá trị rỗng nếu không tạo được cấu hình trình chạy đơn giản.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger)

Tham số
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`

Giá trị trả về
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

Tham số
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`args`	`String`

Giá trị trả về
`IFolderBuildInfo`

Gửi
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

Tham số
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Giá trị trả về
`File`

Gửi
`Exception`

tearDown

public void tearDown ()

Dọn dẹp mọi trạng thái, tệp hoặc môi trường có thể đã bị thay đổi.

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

Kết xuất cấu hình chung được lọc từ một số đối tượng.

Tham số
`config`	`IConfiguration`
`exclusionPatterns`	`Set`

Giá trị trả về
`File`

Gửi
`ConfigurationException`
`IOException`

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Chuẩn bị và tuần tự hoá IInvocationContext.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` cần chuẩn bị.
`config`	`IConfiguration`: `IConfiguration` của hộp cát.

Giá trị trả về
`File`	`IInvocationContext` được tuần tự hoá.

Gửi
`IOException`