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 hộp cát có thể được sử dụng để chạy lệnh gọi.

Bản 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 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 phần gốc, chúng tôi sẽ chuyển sang 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à điền vào thư mục làm việc để tạo cấu hình đầy đủ trong thư mục đượ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 để sandbox 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 đặt.
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 thức công khai

tạoClasspath

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 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 sandbox.

trả lại
String	Đường dẫn lớp sẽ được sử dụng.

ném
ConfigurationException

tạoThinLauncherConfig

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 phần gốc, chúng tôi sẽ chuyển sang 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à điền vào thư mục làm việc để tạo cấu hình đầy đủ trong thư mục được phiên bản .

Thông số
args	String : Dòng lệnh ban đầu args.
keyStoreClient	IKeyStoreClient : ứng dụng khách kho khóa hiện tại được 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 toàn cầu được sử dụng để chạy các quy trình con của TF.

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

môi trường getTradefedSandbox

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 : IConfiguration đại diện cho các đối tượng không được phiên bản.
args	String : các đối số dòng lệnh.

trả lại
File	thư mục ERROR(/File) chứa các lọ môi trường hộp cát TF.

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

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

Chuẩn bị môi trường để sandbox chạy đúng cách.

Thông số
context	IInvocationContext : lời gọi hiện tại IInvocationContext .
configuration	IConfiguration : IConfiguration cho lệnh chạy.
listener	ITestInvocationListener : lời gọi hiện tại ITestInvocationListener trong đó các kết quả cuối cùng sẽ được đưa vào.

trả lại
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 đặt.

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

trả lại
CommandResult	một CommandResult với trạng thái chạy hộp cát và ghi nhật ký.

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.