Hộp cát

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Giao diện xác định một hộp cát 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 đã ngắt kết nối khỏi lần chạy chính: Khi một cấu hình dường như không tồn tại trong mẹ, chúng ta dự phòng trình chạy mỏng mà chúng ta sẽ cố gắng thiết lập hộp cát với thông tin đã biết và điền vào thư mục đang hoạt động để tạo cấu hình đầy đủ trong dir được tạo 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) giúp khám phá hoạt động kiểm thử nếu bạn đã bật SandboxOptions.shouldUseTestDiscovery().

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 đượ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 để hộp cát 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 đã 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 làm việc của hộp cát.
Giá trị trả về
String Đường dẫn lớp sẽ được sử dụng.
Gửi
ConfigurationException

createThinLaunchConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Chế độ đặc biệt đã ngắt kết nối khỏi lần chạy chính: Khi một cấu hình dường như không tồn tại trong mẹ, chúng ta dự phòng trình chạy mỏng mà chúng ta sẽ cố gắng thiết lập hộp cát với thông tin đã biết và điền vào thư mục đang hoạt động để tạo cấu hình đầy đủ trong dir được tạo phiên bản.

Tham số
args String: Tham số dòng lệnh ban đầu.
keyStoreClient IKeyStoreClient: ứng dụng kho khoá hiện tại dùng để tạo cấu hình.
runUtil IRunUtil: IRunUtil hiện tại để chạy các lệnh lưu trữ.
globalConfig File: Cấu hình chung cần sử dụng để chạy các quy trình phụ của TF.
Giá trị trả về
IConfiguration Tệp trỏ đến XML cấu hình của TF cho đối tượng NON_VERSIONED. Trả lại hàng rỗng nếu không thể tạo cấu hình trình chạy mỏng.

discoveryTests

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) giúp khám phá hoạt động kiểm thử nếu bạn đã bật SandboxOptions.shouldUseTestDiscovery().

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 được hoặc rỗng nếu không được hỗ trợ hoặc không thành công.

discoveryTests

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

Tham số
context IInvocationContext

configuration IConfiguration

logger ITestLogger

Giá trị trả về

Tìm nạp Hộp cát ExtraArtifacts

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 đã 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

Môi trường getTradefedSandbox

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

Trả về TF môi trường hộp cát được 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 một thư mục ERROR(/File) chứa các tệp jar môi trường hộp cát TF.

Môi trường getTradefedSandbox

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

chuẩn bị môi trường

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, trong đó kết quả cuối cùng đường ống.
Giá trị trả về
Exception 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 đã 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ý các tệp.
Giá trị trả về
CommandResult CommandResult có trạng thái chạy và nhật ký hộp cát.

xé hình

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.