ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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.

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

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

getTradefedSandboxEnvironment

public abstract 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.

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

Chạy hộp cát bằng môi trường đã thiết lập.

Tham số
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.