TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

Các lớp con trực tiếp đã biết GoogleTradefedSandbox GoogleTradefedSandbox Chuyên môn nội bộ của TradefedSandbox sẽ được dùng trong cơ sở hạ tầng phòng thí nghiệm.

---

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