ISandbox

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 minh thương mại.

---

Giao diện xác định một hộp cát có thể 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 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.
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) để khám phá các kiểm thử nếu SandboxOptions.shouldUseTestDiscovery() được bật.
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 để 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 bằng 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 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 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.

discoverTests

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) để khám phá các 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 để chạy lệnh.

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

discoverTests

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

Tham số
context	IInvocationContext
configuration	IConfiguration
logger	ITestLogger

Giá trị trả về

fetchSandboxExtraArtifacts

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 được 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

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.

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

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 để 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 abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

Chạy hộp cát bằng 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ý 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 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.