自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度将源代码发布到 AOSP。对于构建 AOSP 和向 AOSP 贡献代码，我们建议使用 android-latest-release 而不是 aosp-main。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

SandboxConfigurationFactory

public class SandboxConfigurationFactory
extends ConfigurationFactory

java.lang.Object
↳	com.android.tradefed.config.ConfigurationFactory
	↳	com.android.tradefed.config.SandboxConfigurationFactory

用于处理创建沙盒用途配置的特殊配置工厂。

TODO：将配置转储部分拆分到另一个类

摘要

字段
`public static final`	`OPTION_IGNORED_ELEMENTS`

公共构造函数
`SandboxConfigurationFactory()`

公共方法
`IConfiguration`	`createConfigurationFromArgs(String[] args, IKeyStoreClient keyStoreClient, ISandbox sandbox, IRunUtil runUtil)` 根据提供的命令行和沙盒创建 `IConfiguration`。
`IConfiguration`	`createConfigurationFromArgs(String[] arrayArgs, SandboxConfigDump.DumpCmd command)` 为命令运行转储时。
`IConfiguration`	`createConfigurationFromArgs(String[] args, IKeyStoreClient keyStoreClient, ISandbox sandbox, IRunUtil runUtil, File globalConfig)` 根据提供的命令行和沙盒创建 `IConfiguration`。
`static SandboxConfigurationFactory`	`getInstance()` 获取单例 `IConfigurationFactory` 实例。

受保护的方法
`ConfigurationDef`	`createConfigurationDef(String name)` 用于创建 `ConfigurationDef` 的内部方法
`ConfigurationDef`	`getConfigurationDef(String name, boolean isGlobal, templateMap)` 检索给定名称的 `ConfigurationDef`

字段

OPTION_IGNORED_ELEMENTS

public static final  OPTION_IGNORED_ELEMENTS

公共构造函数

SandboxConfigurationFactory

public SandboxConfigurationFactory ()

公共方法

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] args, 
                IKeyStoreClient keyStoreClient, 
                ISandbox sandbox, 
                IRunUtil runUtil)

根据提供的命令行和沙盒创建 IConfiguration。

参数
`args`	`String`：运行的命令行。
`keyStoreClient`	`IKeyStoreClient`：要从中加载密钥的 `IKeyStoreClient`。
`sandbox`	`ISandbox`：用于运行的 `ISandbox`。
`runUtil`	`IRunUtil`：用于运行命令的 `IRunUtil`。

返回
`IConfiguration`	适用于沙盒的 `IConfiguration`。

抛出
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                SandboxConfigDump.DumpCmd command)

为命令运行转储时。创建具有特定预期的配置。

参数
`arrayArgs`	`String`：运行的命令行。
`command`	`SandboxConfigDump.DumpCmd`：正在执行的转储命令

返回
`IConfiguration`	适用于 VERSIONED 沙盒的 `IConfiguration`。

抛出
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] args, 
                IKeyStoreClient keyStoreClient, 
                ISandbox sandbox, 
                IRunUtil runUtil, 
                File globalConfig)

根据提供的命令行和沙盒创建 IConfiguration。

参数
`args`	`String`：运行的命令行。
`keyStoreClient`	`IKeyStoreClient`：要从中加载密钥的 `IKeyStoreClient`。
`sandbox`	`ISandbox`：用于运行的 `ISandbox`。
`runUtil`	`IRunUtil`：用于运行命令的 `IRunUtil`。
`globalConfig`	`File`

返回
`IConfiguration`	适用于沙盒的 `IConfiguration`。

抛出
`ConfigurationException`

getInstance

public static SandboxConfigurationFactory getInstance ()

获取单例 IConfigurationFactory 实例。

返回
`SandboxConfigurationFactory`

受保护的方法

createConfigurationDef

protected ConfigurationDef createConfigurationDef (String name)

用于创建 ConfigurationDef 的内部方法

参数
`name`	`String`

返回
`ConfigurationDef`

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

检索给定名称的 ConfigurationDef

参数
`name`	`String`：要加载的内置配置的名称或要加载的配置文件的文件路径
`isGlobal`	`boolean`
`templateMap`

返回
`ConfigurationDef`	`ConfigurationDef`

抛出
`ConfigurationException`