此页面由 Cloud Translation API 翻译。

Tradefed沙箱

public class TradefedSandbox
extends Object implements ISandbox

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

可以运行 Trade Federation 调用的沙盒容器。 TODO：允许将选项传递到沙箱。

概括

领域
`public static final String`	`SANDBOX_ENABLED`

公共构造函数
`TradefedSandbox ()`

公共方法
`String`	`createClasspath (File workingDir)` 根据环境和`getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`返回的工作目录创建类路径。
`IConfiguration`	`createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` 与主运行断开连接的特殊模式：当父级中似乎不存在配置时，我们会回退到精简启动器，在其中尝试使用当前已知信息设置沙箱并填充工作目录以在版本化目录中完全创建配置。
`File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` 根据命令行参数返回要使用的沙箱环境 TF。
`Exception`	`prepareEnvironment ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` 准备沙箱正常运行的环境。
`CommandResult`	`run ( TestInformation info, IConfiguration config, ITestLogger logger)` 使用设置的环境运行沙箱。
`void`	`tearDown ()` 清理可能已更改的任何状态、文件或环境。

受保护的方法
`File`	`dumpGlobalConfig ( IConfiguration config, exclusionPatterns)` `dumpGlobalConfig ( IConfiguration config, exclusionPatterns)` 转储从某些对象中过滤出来的全局配置。
`String`	`getJava ()`
`Exception`	`prepareConfiguration ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` 准备将传递给子进程并驱动容器执行的`IConfiguration` 。
`File`	`prepareContext ( IInvocationContext context, IConfiguration config)` 准备并序列化`IInvocationContext` 。

领域

沙盒_启用

public static final String SANDBOX_ENABLED

公共构造函数

Tradefed沙箱

public TradefedSandbox ()

公共方法

创建类路径

public String createClasspath (File workingDir)

根据环境和getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])返回的工作目录创建类路径。

参数
`workingDir`	`File` ：沙箱的当前工作目录。

退货
`String`	要使用的类路径。

投掷
`ConfigurationException`

创建ThinLauncherConfig

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

与主运行断开连接的特殊模式：当父级中似乎不存在配置时，我们会回退到精简启动器，在其中尝试使用当前已知信息设置沙箱并填充工作目录以在版本化目录中完全创建配置。

参数
`args`	`String` ：原始命令行参数。
`keyStoreClient`	`IKeyStoreClient` ：用于创建配置的当前密钥库客户端。
`runUtil`	`IRunUtil` ：当前运行主机命令的`IRunUtil` 。
`globalConfig`	`File` ：用于运行 TF 子进程的全局配置。

退货
`IConfiguration`	指向 NON_VERSIONED 对象的 TF 配置 XML 的文件。如果无法创建瘦启动器配置，则返回 null。

getTradefedSandboxEnvironment

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

根据命令行参数返回要使用的沙箱环境 TF。

参数
`context`	`IInvocationContext` ：父级的`IInvocationContext` 。
`nonVersionedConfig`	`IConfiguration` ：表示非版本化对象的`IConfiguration` 。
`args`	`String` ：命令行参数。

退货
`File`	包含 TF 沙箱环境 jar 的`ERROR(/File)`目录。

准备环境

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

准备沙箱正常运行的环境。

参数
`context`	`IInvocationContext` ：当前调用`IInvocationContext` 。
`config`	`IConfiguration` ：要运行的命令的`IConfiguration` 。
`listener`	`ITestInvocationListener` ：当前调用`ITestInvocationListener`应通过管道传输最终结果。

退货
`Exception`	包含失败的`Exception` 。如果成功则为 Null。

跑步

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

使用设置的环境运行沙箱。

参数
`info`	`TestInformation` ：描述调用的`TestInformation`
`config`	`IConfiguration` ：要运行的命令的`IConfiguration` 。
`logger`	`ITestLogger` ：一个`ITestLogger` ，我们可以在其中记录文件。

退货
`CommandResult`	包含沙箱运行状态和日志的`CommandResult` 。

拆除

public void tearDown ()

清理可能已更改的任何状态、文件或环境。

受保护的方法

转储全局配置

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

转储从某些对象中过滤出来的全局配置。

参数
`config`	`IConfiguration`
`exclusionPatterns`

退货
`File`

投掷
`ConfigurationException`

获取Java

protected String getJava ()

退货
`String`

准备配置

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

准备将传递给子进程并驱动容器执行的IConfiguration 。

参数
`context`	`IInvocationContext` ：当前的`IInvocationContext` 。
`config`	`IConfiguration` ：要准备的`IConfiguration` 。
`listener`	`ITestInvocationListener` ：当前调用`ITestInvocationListener` 。

退货
`Exception`	如果出现任何问题，则抛出 Exception，否则返回 null。

准备上下文

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

准备并序列化IInvocationContext 。

参数
`context`	`IInvocationContext` ：要准备的`IInvocationContext` 。
`config`	`IConfiguration` ：沙箱的`IConfiguration` 。

退货
`File`	序列化的`IInvocationContext` 。

投掷
	IO异常