為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

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 Sandbox 的 `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`