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