沙箱

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

已知的間接子類

Tradefed沙箱

Tradefed沙箱可以運行 Trade Federation 調用的沙盒容器。

定義可用於運行調用的沙箱的接口。

概括

公共方法
`abstract String`	`createClasspath (File workingDir)` 根據`getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`返回的環境和工作目錄創建類路徑。
`abstract IConfiguration`	`createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` 與主運行斷開連接的特殊模式：當父級中似乎不存在配置時，我們回退到瘦啟動器，我們嘗試使用當前已知信息設置沙箱並填充工作目錄以在版本化目錄中完全創建配置.
`abstract File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` 根據命令行參數返回要使用的沙箱環境 TF。
`abstract Exception`	`prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` 為沙箱正常運行準備環境。
`abstract CommandResult`	`run ( TestInformation info, IConfiguration configuration, ITestLogger logger)` 使用設置的環境運行沙箱。
`abstract void`	`tearDown ()` 清理可能已更改的任何狀態、文件或環境。

公共方法

創建類路徑

public abstract String createClasspath (File workingDir)

根據getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])返回的環境和工作目錄創建類路徑。

參數
`workingDir`	`File` ：沙箱的當前工作目錄。

退貨
`String`	要使用的類路徑。

投擲
`ConfigurationException`

創建ThinLauncherConfig

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

與主運行斷開連接的特殊模式：當父級中似乎不存在配置時，我們回退到瘦啟動器，我們嘗試使用當前已知信息設置沙箱並填充工作目錄以在版本化目錄中完全創建配置.

參數
`args`	`String` ：原始命令行參數。
`keyStoreClient`	`IKeyStoreClient` ：用於創建配置的當前密鑰庫客戶端。
`runUtil`	`IRunUtil` ：當前要運行主機命令的`IRunUtil` 。
`globalConfig`	`File` ：用於運行 TF 子進程的全局配置。

退貨
`IConfiguration`	指向 TF 的 NON_VERSIONED 對象的配置 XML 的文件。如果無法創建瘦啟動器配置，則返回 null。

getTradefedSandboxEnvironment

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

根據命令行參數返回要使用的沙箱環境 TF。

參數
`context`	`IInvocationContext` ：父級的`IInvocationContext` 。
`nonVersionedConfig`	`IConfiguration` ：表示非版本化對象的`IConfiguration` 。
`args`	`String` ：命令行參數。

退貨
`File`	包含 TF 沙箱環境 jar 的`ERROR(/File)`目錄。

準備環境

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

為沙箱正常運行準備環境。

參數
`context`	`IInvocationContext` ：當前調用`IInvocationContext` 。
`configuration`	`IConfiguration` ：要運行的命令的`IConfiguration` 。
`listener`	`ITestInvocationListener` ：當前調用`ITestInvocationListener`最終結果應該通過管道傳輸。

退貨
`Exception`	包含失敗的`ERROR(/Exception)` 。如果成功則為 Null。

跑步

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

使用設置的環境運行沙箱。

參數
`info`	`TestInformation` ：描述調用的`TestInformation`
`configuration`	`IConfiguration` ：要運行的命令的`IConfiguration` 。
`logger`	`ITestLogger` ：一個`ITestLogger` ，我們可以在其中記錄文件。

退貨
`CommandResult`	具有沙箱運行和日誌狀態的`CommandResult` 。

拆除

public abstract void tearDown ()

清理可能已更改的任何狀態、文件或環境。