hộp cát
public interface ISandbox
com.android.tradefed.sandbox.ISandbox |
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 |
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.