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 pháp công khai

abstract String createClasspath (File workingDir)

Tạo đườ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 bản gốc, chúng tôi chuyển sang trình khởi chạy mỏng trong đó 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 ( 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 pháp công khai

tạoClasspath

public abstract String createClasspath (File workingDir)

Tạo đườ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

createThinLauncherConfig

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 bản gốc, chúng tôi chuyển sang trình khởi chạy mỏng trong đó 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 gốc lập luận.

keyStoreClient IKeyStoreClient : ứng dụng 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 của máy chủ.

globalConfig File : Cấu hình chung đượ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.

getTradefedSandboxMôi trường

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 một 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 để lệnh chạy.

listener ITestInvocationListener : lệnh gọi hiện tại ITestInvocationListener nơi kết quả cuối cùng sẽ được dẫn đến.

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 (IConfiguration configuration, 
                ITestLogger logger)

Chạy hộp cát với môi trường đã được đặt.

Thông số
configuration IConfiguration : IConfiguration để lệnh chạy.

logger ITestLogger : ITestLogger nơi chúng ta có thể ghi nhật ký tệp.

Trả lại
CommandResult một CommandResult với trạng thái chạy sandbox và 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.