Để 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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

GoogleTradefedSandbox, TradefedSandbox

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.
TradefedSandbox	Vùng chứa hộp cát có thể chạy một lệnh gọi Liên đoàn Thương mại.

Giao diện xác định một hộp cát có thể dùng để chạy một lệnh gọi.

Tóm tắt

Phương thức công khai
`abstract String`	`createClasspath(File workingDir)` Tạo một đường dẫn lớp dựa trên môi trường và thư mục đang hoạt động do `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])` trả về.
`abstract 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.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Một bước phụ của `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)`, khám phá các bài kiểm thử nếu `SandboxOptions.shouldUseTestDiscovery()` được bật.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Bước phụ của `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` để tìm nạp các tệp bổ sung cần thiết cho hộp cát.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Trả về TF của môi trường hộp cát sẽ được dùng dựa trên các đối số dòng lệnh.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Chuẩn bị môi trường để hộp cát chạy đúng cách.
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` Chạy hộp cát với môi trường đã được thiết lập.
`abstract 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ông khai

createClasspath

public abstract String createClasspath (File workingDir)

Tạo một đường dẫn lớp dựa trên môi trường và thư mục đang hoạt động do getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) trả về.

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 abstract 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 configuration)

Một bước phụ của prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener), khám phá các bài kiểm thử nếu SandboxOptions.shouldUseTestDiscovery() được bật.

Tham số
`context`	`IInvocationContext`: lệnh gọi hiện tại `IInvocationContext`.
`configuration`	`IConfiguration`: `IConfiguration` cho lệnh cần chạy.

Giá trị trả về
`Map<String, List<String>>`	Bản đồ của các kiểm thử đã phát hiện hoặc giá trị rỗng nếu không được hỗ trợ hoặc không thành công.

discoverTests

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

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

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

fetchSandboxExtraArtifacts

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

Bước phụ của prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) để tìm nạp các tệp bổ sung cần thiết cho hộp cát.

Tham số
`context`	`IInvocationContext`: lệnh gọi hiện tại `IInvocationContext`.
`configuration`	`IConfiguration`: `IConfiguration` cho lệnh cần chạy.
`args`	`String`: đối số dòng lệnh.

Giá trị trả về
`IFolderBuildInfo`	bản dựng được tìm nạp cho các tệp bổ sung được cách ly.

Gửi
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

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

Trả về TF của môi trường hộp cát sẽ được dùng dựa trên các đối số dòng lệnh.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` của phần tử mẹ.
`nonVersionedConfig`	`IConfiguration`: `IConfiguration` đại diện cho các đối tượng không có phiên bản.
`args`	`String`: đối số dòng lệnh.

Giá trị trả về
`File`	thư mục `File` chứa các tệp jar của môi trường hộp cát TF.

Gửi
`Exception`

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`

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

Chuẩn bị môi trường để hộp cát chạy đúng cách.

Tham số
`context`	`IInvocationContext`: lệnh gọi hiện tại `IInvocationContext`.
`configuration`	`IConfiguration`: `IConfiguration` cho lệnh cần chạy.
`listener`	`ITestInvocationListener`: lệnh gọi hiện tại `ITestInvocationListener` nơi các kết quả cuối cùng sẽ được truyền.

Giá trị trả về
`Exception`	một `Exception` chứa lỗi. hoặc Null nếu thành công.

chạy

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

Chạy hộp cát với môi trường đã được thiết lập.

Tham số
`info`	`TestInformation`: `TestInformation` mô tả lời gọi
`configuration`	`IConfiguration`: `IConfiguration` cho lệnh cần chạy.
`logger`	`ITestLogger`: một `ITestLogger` nơi chúng ta có thể ghi nhật ký các tệp.

Giá trị trả về
`CommandResult`	`CommandResult` có trạng thái của quá trình chạy hộp cát và nhật ký.

Gửi
`Throwable`

tearDown

public abstract 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.