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.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

Vùng chứa hộp cát có thể chạy lệnh gọi Liên minh thương mại. VIỆC CẦN LÀM: Cho phép truyền Tuỳ chọn đến hộp cát.

Tóm tắt

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

Phương thức công khai
`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(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])` trả về.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Chế độ đặc biệt bị ngắt kết nối với lần chạy chính: Khi một cấu hình dường như không tồn tại trong thư mục mẹ, chúng ta sẽ quay lại trình chạy mỏng để cố gắng thiết lập hộp cát bằng thông tin hiện đã biết và điền vào thư mục đang hoạt động để tạo cấu hình đầy đủ trong thư mục có phiên bản.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Trả về TF môi trường hộp cát để sử dụng dựa trên các đối số dòng lệnh.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Chuẩn bị môi trường để hộp cát chạy đúng cách.
`CommandResult`	`run(IConfiguration config, ITestLogger logger)` Chạy hộp cát bằng môi trường đã thiết lập.
`void`	`tearDown()` Dọn dẹp mọi trạng thái, tệp hoặc môi trường có thể đã thay đổi.

Phương thức được bảo vệ
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` Kết xuất cấu hình chung được lọc từ một số đối tượng.
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Chuẩn bị `IConfiguration` sẽ được truyền đến quy trình con và sẽ thúc đẩy việc thực thi vùng chứa.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Chuẩn bị và chuyển đổi tuần tự `IInvocationContext`.

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

TradefedSandbox

public TradefedSandbox ()

Phương thức công khai

createClasspath

public 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(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.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 IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Chế độ đặc biệt bị ngắt kết nối với lần chạy chính: Khi một cấu hình dường như không tồn tại trong thư mục mẹ, chúng ta sẽ quay lại trình chạy mỏng để cố gắng thiết lập hộp cát bằng thông tin hiện đã biết và điền vào thư mục đang hoạt động để 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 để 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 toàn cục để sử dụng nhằm chạy các quy trình con của TF.

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

getTradefedSandboxEnvironment

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

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

Tham số
`context`	`IInvocationContext`: `IInvocationContext` của thành phần 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 `ERROR(/File)` chứa các tệp jar môi trường hộp cát TF.

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                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`.
`config`	`IConfiguration`: `IConfiguration` để chạy lệnh.
`listener`	`ITestInvocationListener`: lệnh gọi hiện tại `ITestInvocationListener` nơi kết quả cuối cùng sẽ được chuyển vào.

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

chạy

public CommandResult run (IConfiguration config, 
                ITestLogger logger)

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

Tham số
`config`	`IConfiguration`: `IConfiguration` để chạy lệnh.
`logger`	`ITestLogger`: một `ITestLogger` nơi chúng ta có thể ghi nhật ký 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ý.

tearDown

public void tearDown ()

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

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 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`

Giá trị trả về
`File`

Gửi
`ConfigurationException`

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Chuẩn bị IConfiguration sẽ được truyền đến quy trình con và sẽ thúc đẩy việc thực thi vùng chứa.

Tham số
`context`	`IInvocationContext`: `IInvocationContext` hiện tại.
`config`	`IConfiguration`: `IConfiguration` cần chuẩn bị.
`listener`	`ITestInvocationListener`: Lệnh gọi hiện tại `ITestInvocationListener`.

Giá trị trả về
`Exception`	một ngoại lệ nếu có lỗi xảy ra, nếu không thì giá trị rỗng.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Chuẩn bị và chuyển đổi tuần tự 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` đã chuyển đổi tuần tự.