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.

default discoverTests(IInvocationContext context, IConfiguration configuration)

Một bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) để khám phá các kiểm thử nếu SandboxOptions.shouldUseTestDiscovery() được bật.

default discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)

Bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) để tìm nạp các tệp bổ sung cần thiết cho hộp cát.

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

default File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
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(TestInformation info, 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.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Một bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) để khám phá các kiểm thử nếu SandboxOptions.shouldUseTestDiscovery() được bật.

Tham số
context IInvocationContext: lệnh gọi hiện tại IInvocationContext.
configuration IConfiguration: IConfiguration để chạy lệnh.
Giá trị trả về
Bản đồ các kiểm thử đã phát hiện hoặc rỗng nếu không được hỗ trợ hoặc không thành công.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Tham số
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Giá trị trả về

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) để tìm nạp các tệp bổ sung cần thiết cho hộp cát.

Tham số
context IInvocationContext: lệnh gọi hiện tại IInvocationContext.
configuration IConfiguration: IConfiguration để chạy lệnh.
args String: đối số dòng lệnh.
Giá trị trả về
IFolderBuildInfo bản dựng được tìm nạp cho các tệp hộp cát bổ sung.
Gửi
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

Tham số
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Giá trị trả về
File

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

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

Tham số
info TestInformation: TestInformation mô tả lệnh gọi
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.