TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
   ↳ com.android.tradefed.sandbox.TradefedSandbox

Vùng chứa hộp cát có thể chạy một lệnh gọi Liên đoàn Thương mại. TODO: Cho phép truyền các tuỳ chọn đến hộp cát.

Tóm tắt

Hằng số

String EXTRA_TARGET_LAB

String GENERAL_TESTS_ZIP

String SANDBOX_ENABLED

Hàm khởi tạo công khai

TradefedSandbox()

Phương thức công khai

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(IInvocationContext,IConfiguration,String[]) trả về.

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 một cấu hình dường như không tồn tại trong phần tử mẹ, chúng ta sẽ quay lại trình chạy mỏng, nơi chúng ta cố gắng thiết lập hộp cát bằng thông tin hiện tại đã 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.

File getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)
static Set<String> matchSandboxExtraBuildTargetByConfigName(String configName)

Với tên cấu hình kiểm thử, hãy so khớp các mục tiêu bản dựng bổ sung từ các mục tiêu bản dựng bổ sung của Sandbox.

Exception prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

Chuẩn bị môi trường để hộp cát chạy đúng cách.

static String[] removeIncompatibleFlags(String[] args)
CommandResult run(TestInformation info, IConfiguration config, ITestLogger logger)

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

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 bảo vệ

File dumpGlobalConfig(IConfiguration config, Set<String> exclusionPatterns)

Kết xuất cấu hình chung được lọc từ một số đối tượng.

String getJava()
Exception prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)

Chuẩn bị IConfiguration sẽ được truyền đến quy trình con và sẽ điều khiển quá trình thực thi vùng chứa.

File prepareContext(IInvocationContext context, IConfiguration config)

Chuẩn bị và tuần tự hoá IInvocationContext.

Hằng số

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Giá trị không đổi: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Giá trị không đổi: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Giá trị không đổi: "SANDBOX_ENABLED"

Hàm khởi tạo công khai

TradefedSandbox

public TradefedSandbox ()

Phương thức công khai

createClasspath

public 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(IInvocationContext,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 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 một cấu hình dường như không tồn tại trong phần tử mẹ, chúng ta sẽ quay lại trình chạy mỏng, nơi chúng ta cố gắng thiết lập hộp cát bằng thông tin hiện tại đã 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.

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 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 để dùng chạy các quy trình con của TF.
Giá trị trả về
IConfiguration một Tệp trỏ đến cấu hình XML của TF cho các đối tượng NON_VERSIONED. Trả về giá trị rỗng nếu không tạo được cấu hình trình chạy đơn giản.

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

Gửi
Exception

matchSandboxExtraBuildTargetByConfigName

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

Với tên cấu hình kiểm thử, hãy so khớp các mục tiêu bản dựng bổ sung từ các mục tiêu bản dựng bổ sung của Sandbox.

Tham số
configName String

Giá trị trả về
Set<String>

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                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.
config IConfiguration: IConfiguration cho lệnh cần chạy.
listener ITestInvocationListener: lệnh gọi hiện tại ITestInvocationListener nơi các kết quả cuối cùng sẽ được truyền.
Giá trị trả về
Exception một Exception chứa lỗi. hoặc Null nếu thành công.

removeIncompatibleFlags

public static String[] removeIncompatibleFlags (String[] args)

Tham số
args String

Giá trị trả về
String[]

chạy

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

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

Tham số
info TestInformation: TestInformation mô tả lời gọi
config IConfiguration: IConfiguration cho lệnh cần chạy.
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 của quá trình chạy hộp cát và nhật ký.
Gửi
Throwable

tearDown

public 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 bảo vệ

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

Kết xuất cấu hình chung được lọc từ một số đối tượng.

Tham số
config IConfiguration

exclusionPatterns Set

Giá trị trả về
File

Gửi
ConfigurationException
IOException

getJava

protected String getJava ()

Giá trị trả về
String

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Chuẩn bị IConfiguration sẽ được truyền đến quy trình con và sẽ điều khiển quá trình thực thi vùng chứa.

Tham số
context IInvocationContext: IInvocationContext hiện tại.
config IConfiguration: IConfiguration cần chuẩn bị.
listener ITestInvocationListener: Lệnh gọi hiện tại ITestInvocationListener.
Giá trị trả về
Exception một Ngoại lệ nếu có lỗi xảy ra, nếu không thì trả về giá trị rỗng.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Chuẩn bị và tuần tự hoá IInvocationContext.

Tham số
context IInvocationContext: IInvocationContext cần chuẩn bị.
config IConfiguration: IConfiguration của hộp cát.
Giá trị trả về
File IInvocationContext được tuần tự hoá.
Gửi
java.io.IOException
IOException