Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

Hộp cát

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

TradefedSandbox

TradefedSandbox Vùng 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 dùng để chạy 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(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])` trả về.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Chế độ đặc biệt đã 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 mẹ, chúng ta dự phòng trình chạy mỏng mà chúng ta sẽ cố gắng thiết lập hộp cát với thông tin đã biết và điền vào thư mục đang hoạt động để tạo cấu hình đầy đủ trong dir được tạo phiên bản.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Một bước phụ của `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` giúp khám phá hoạt động kiểm thử nếu bạn đã bật `SandboxOptions.shouldUseTestDiscovery()`.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Bước phụ của `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.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 môi trường hộp cát được sử 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 đã 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ể đã 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(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) trả về.

Tham số
`workingDir`	`File`: thư mục đang làm việc của hộp cát.

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

Gửi
`ConfigurationException`

createThinLaunchConfig

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

Chế độ đặc biệt đã 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 mẹ, chúng ta dự phòng trình chạy mỏng mà chúng ta sẽ cố gắng thiết lập hộp cát với thông tin đã biết và điền vào thư mục đang hoạt động để tạo cấu hình đầy đủ trong dir được tạo phiên bản.

Tham số
`args`	`String`: Tham 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 lưu trữ.
`globalConfig`	`File`: Cấu hình chung cần sử dụng để chạy các quy trình phụ của TF.

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

discoveryTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Một bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) giúp khám phá hoạt động kiểm thử nếu bạn đã bật SandboxOptions.shouldUseTestDiscovery().

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

Giá trị trả về
	Bản đồ các kiểm thử đã phát hiện được hoặc rỗng nếu không được hỗ trợ hoặc không thành công.

discoveryTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

Giá trị trả về

Tìm nạp Hộp cát ExtraArtifacts

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

Bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.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` để chạy lệnh.
`args`	`String`: đối số dòng lệnh.

Giá trị trả về
`IFolderBuildInfo`	bản dựng đã tìm nạp cho các tệp hộp cát bổ sung.

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

Môi trường getTradefedSandbox

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

Trả về TF môi trường hộp cát được 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`	một thư mục `ERROR(/File)` chứa các tệp jar môi trường hộp cát TF.

Môi trường getTradefedSandbox

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`

chuẩn bị môi trường

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` để chạy lệnh.
`listener`	`ITestInvocationListener`: lệnh gọi hiện tại `ITestInvocationListener`, trong đó kết quả cuối cùng đường ống.

Giá trị trả về
`Exception`	`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 đã thiết lập.

Tham số
`info`	`TestInformation`: `TestInformation` mô tả lệnh gọi
`configuration`	`IConfiguration`: `IConfiguration` để chạy lệnh.
`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 chạy và nhật ký hộp cát.

xé hình

public abstract void tearDown ()

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