ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

TradefedSandbox

TradefedSandbox Bộ chứa hộp cát có thể chạy 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ể được sử dụng để chạy một lời kêu gọi.

Bản tóm tắt

Phương pháp công khai
`abstract String`	`createClasspath (File workingDir)` Tạo một classpath dựa trên môi trường và thư mục làm việc được trả về bởi `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])` .
`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 cấu hình dường như không tồn tại trong cấu hình gốc, chúng tôi dự phòng cho trình khởi chạy mỏng, nơi chúng tôi cố gắng thiết lập hộp cát với thông tin hiện đã biết và lấp đầy thư mục làm việc để tạo cấu hình đầy đủ trong dir đã được phiên bản .
`abstract File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Trả về TF môi trường hộp cát sẽ được sử dụng dựa trên các đối số dòng lệnh.
`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 pháp công khai

createClasspath

public abstract String createClasspath (File workingDir)

Tạo một classpath dựa trên môi trường và thư mục làm việc được trả về bởi getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

Thông số
`workingDir`	`File` : thư mục làm việc hiện tại cho hộp cát.

Lợi nhuận
`String`	Classpath sẽ được sử dụng.

Ném
`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 cấu hình dường như không tồn tại trong cấu hình gốc, chúng tôi dự phòng cho trình khởi chạy mỏng, nơi chúng tôi cố gắng thiết lập hộp cát với thông tin hiện đã biết và lấp đầy thư mục làm việc để tạo cấu hình đầy đủ trong dir đã được phiên bản .

Thông số
`args`	`String` : Dòng lệnh gốc args.
`keyStoreClient`	`IKeyStoreClient` : máy khách kho khóa hiện tại để sử dụng để tạo cấu hình.
`runUtil`	`IRunUtil` : `IRunUtil` hiện tại để chạy các lệnh máy chủ.
`globalConfig`	`File` : Cấu hình chung để sử dụng để chạy các quy trình con của TF.

Lợi nhuận
`IConfiguration`	a Tệp trỏ tới 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 có cấu hình trình khởi chạy mỏng nào có thể được tạo.

getTradefedSandboxEnosystem

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

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

Thông số
`context`	`IInvocationContext` : `IInvocationContext` của cha mẹ.
`nonVersionedConfig`	`IConfiguration` : cấu hình `IConfiguration` đại diện cho các đối tượng không được tạo phiên bản.
`args`	`String` : đối số dòng lệnh.

Lợi nhuận
`File`	thư mục `ERROR(/File)` chứa các lọ môi trường hộp cát TF.

chuẩn bị

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.

Thông số
`context`	`IInvocationContext` : lời gọi hiện tại `IInvocationContext` .
`configuration`	`IConfiguration` : cấu hình `IConfiguration` cho lệnh chạy.
`listener`	`ITestInvocationListener` : lời kêu gọi hiện tại `ITestInvocationListener` nơi kết quả cuối cùng sẽ được tổng hợp.

Lợi nhuận
`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.

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

Lợi nhuận
`CommandResult`	một `CommandResult` với trạng thái của hộp cát chạy và các bản ghi.

phá bỏ

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.