TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

---

Bộ chứa hộp cát có thể chạy lệnh gọi Liên đoàn thương mại. VIỆC CẦN LÀM: Cho phép chuyển Tùy chọn vào hộp cát.

Bản tóm tắt

Các nhà xây dựng công cộng
TradefedSandbox ()

Phương pháp công khai
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[]) .
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 .
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.
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 ( TestInformation info, IConfiguration config, ITestLogger logger) Chạy hộp cát với môi trường đã được 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ể đã bị thay đổi.

Các phương pháp được bảo vệ
File	dumpGlobalConfig ( IConfiguration config, exclusionPatterns) 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ị cấu hình IConfiguration sẽ được chuyển cho quy trình con và sẽ thúc đẩy quá trình thực thi vùng chứa.
File	prepareContext ( IInvocationContext context, IConfiguration config) Chuẩn bị và tuần tự hóa IInvocationContext .

Các nhà xây dựng công cộng

TradefedSandbox

public TradefedSandbox ()

Phương pháp công khai

createClasspath

public 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 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 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 Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                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 .
config	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 CommandResult run (TestInformation info, 
                IConfiguration config, 
                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
config	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 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.

Các phương pháp đượ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.

Thông số
config	IConfiguration
exclusionPatterns

Lợi nhuận
File

Ném
ConfigurationException

chuẩn bị

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

Chuẩn bị cấu hình IConfiguration sẽ được chuyển cho quy trình con và sẽ thúc đẩy quá trình thực thi vùng chứa.

Thông số
context	IInvocationContext : IInvocationContext hiện tại.
config	IConfiguration : cấu hình IConfiguration được chuẩn bị.
listener	ITestInvocationListener : Lời gọi hiện tại ITestInvocationListener .

Lợi nhuận
Exception	một Ngoại lệ nếu có gì sai, nếu không thì null.

chuẩn bị

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Chuẩn bị và tuần tự hóa IInvocationContext .

Thông số
context	IInvocationContext : IInvocationContext sẽ được chuẩn bị.
config	IConfiguration : Cấu IConfiguration của hộp cát.

Lợi nhuận
File	IInvocationContext được tuần tự hóa.