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 .

default discoverTests ( IInvocationContext context, IConfiguration configuration)

Bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) sẽ phát hiện các thử nghiệm 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ẽ được 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 để 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 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.

khám pháKiểm tra

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Bước phụ của prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) sẽ phát hiện các thử nghiệm nếu SandboxOptions.shouldUseTestDiscovery() được bật.

Thông số
context IInvocationContext : lời gọi hiện tại IInvocationContext .

configuration IConfiguration : IConfiguration để lệnh chạy.

Trả lại
Bản đồ các thử nghiệm được phát hiện hoặc không có giá trị nếu không được hỗ trợ hoặc không thành công.

khám pháKiểm tra

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

Thông số
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Trả lại

tìm nạpSandboxExtraArtifacts

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.

Thông số
context IInvocationContext : lời gọi hiện tại IInvocationContext .

configuration IConfiguration : IConfiguration để lệnh chạy.

args String : các đối số dòng lệnh.

Trả lại
IFolderBuildInfo bản dựng được tìm nạp cho các tệp được đóng hộp cát bổ sung.

Ném
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxMôi trường

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

getTradefedSandboxMôi trường

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

Thông số
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

Trả lại
File

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 (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ệnh gọi

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.