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

設定

public class Configuration
extends Object implements IConfiguration

java.lang.Object
↳	com.android.tradefed.config.Configuration

具體的 IConfiguration 實作項目，可將載入的設定物件儲存在對應中。

摘要

常數
`String`	`BUILD_PROVIDER_TYPE_NAME`
`String`	`CMD_OPTIONS_TYPE_NAME`
`String`	`CONFIGURATION_DESCRIPTION_TYPE_NAME`
`String`	`COVERAGE_OPTIONS_TYPE_NAME`
`String`	`DEVICE_METRICS_COLLECTOR_TYPE_NAME`
`String`	`DEVICE_NAME`
`String`	`DEVICE_OPTIONS_TYPE_NAME`
`String`	`DEVICE_RECOVERY_TYPE_NAME`
`String`	`DEVICE_REQUIREMENTS_TYPE_NAME`
`String`	`GLOBAL_FILTERS_TYPE_NAME`
`String`	`LAB_PREPARER_TYPE_NAME`
`String`	`LOGGER_TYPE_NAME`
`String`	`LOG_SAVER_TYPE_NAME`
`String`	`METRIC_POST_PROCESSOR_TYPE_NAME`
`String`	`MULTI_PREPARER_TYPE_NAME`
`String`	`MULTI_PRE_TARGET_PREPARER_TYPE_NAME`
`String`	`RESULT_REPORTER_TYPE_NAME`
`String`	`RETRY_DECISION_TYPE_NAME`
`String`	`SANBOX_OPTIONS_TYPE_NAME`
`String`	`SANDBOX_TYPE_NAME`
`String`	`SKIP_MANAGER_TYPE_NAME`
`String`	`SYSTEM_STATUS_CHECKER_TYPE_NAME`
`String`	`TARGET_PREPARER_TYPE_NAME`
`String`	`TEST_TYPE_NAME`

欄位
`public static final`	`NON_MODULE_OBJECTS`

公用建構函式
`Configuration(String name, String description)` 使用預設設定物件建立 `Configuration`。

公用方法
`void`	`addFilesToClean( toBeCleaned)` 新增必須在 `cleanConfigurationData()` 期間清除的檔案
`void`	`cleanConfigurationData()` 刪除下載至遠端檔案 Option 欄位的任何檔案。
`Configuration`	`clone()` 建立這個物件的淺層副本。
`void`	`dumpXml(PrintWriter output)` 取得設定的展開 XML 檔案，其中顯示這個 `IConfiguration` 的所有選項，做為 `String`。
`void`	`dumpXml(PrintWriter output, excludeFilters)` 取得設定的展開 XML 檔案，其中顯示這個 `IConfiguration` 的所有選項，但物件會依鍵名篩選。
`void`	`dumpXml(PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)` 取得設定的展開 XML 檔案，其中顯示這個 `IConfiguration` 的所有選項，但物件會依鍵名篩選。
	`getAllConfigurationObjectsOfType(String configType)` 通用介面，可取得裝置上指定型別名稱的所有物件。
`IBuildProvider`	`getBuildProvider()` 從設定取得 `IBuildProvider`。
`String`	`getCommandLine()` 取得用於建立這個 `IConfiguration` 的指令列。
`ICommandOptions`	`getCommandOptions()` 從設定取得要使用的 `ICommandOptions`。
`ConfigurationDescriptor`	`getConfigurationDescription()` 傳回設定中提供的 `ConfigurationDescriptor`。
`Object`	`getConfigurationObject(String typeName)` 通用介面，可取得具有指定型別名稱的設定物件。
	`getConfigurationObjectList(String typeName)` 與 `getConfigurationObject(String)` 類似，但適用於支援多個物件的設定物件類型。
`CoverageOptions`	`getCoverageOptions()` 從設定取得要使用的 `CoverageOptions`。
`String`	`getDescription()`
	`getDeviceConfig()` 從設定取得 `IDeviceConfiguration`。
`IDeviceConfiguration`	`getDeviceConfigByName(String nameDevice)` 傳回與所提供名稱相關聯的 `IDeviceConfiguration`，如果找不到則傳回 null。
`TestDeviceOptions`	`getDeviceOptions()` 從設定取得要使用的 `TestDeviceOptions`。
`IDeviceRecovery`	`getDeviceRecovery()` 從設定取得要使用的 `IDeviceRecovery`。
`IDeviceSelection`	`getDeviceRequirements()` 從設定取得要使用的 `IDeviceSelection`。
	`getFilesToClean()` 取得在 `cleanConfigurationData()`
`GlobalTestFilter`	`getGlobalFilters()` 取得調用的 `GlobalTestFilter`。
	`getInopOptions()` 取得未變更任何值的選項名稱
	`getLabPreparers()` 從設定取得 `ITargetPreparer`。
`ILeveledLogOutput`	`getLogOutput()` 從設定取得要使用的 `ILeveledLogOutput`。
`ILogSaver`	`getLogSaver()` 從設定取得要使用的 `ILogSaver`。
	`getMetricCollectors()` 從設定取得 `IMetricCollector`。
`static`	`getMultiDeviceSupportedTag()` 傳回裝置標記的 `ERROR(/Set)`，適用於多裝置設定。
	`getMultiPreTargetPreparers()` 從應在任何裝置 target_preparer 之前執行的設定取得 `IMultiTargetPreparer`。
	`getMultiTargetPreparers()` 從設定取得 `IMultiTargetPreparer`。
`String`	`getName()` 傳回設定的名稱。
	`getPostProcessors()` 從設定取得 `IPostProcessor`。
`IRetryDecision`	`getRetryDecision()` 傳回用於調用的 `IRetryDecision`。
`SkipManager`	`getSkipManager()` 取得調用的 `SkipManager`。
	`getSystemStatusCheckers()` 從設定取得 `ISystemStatusChecker`。
	`getTargetPreparers()` 從設定取得 `ITargetPreparer`。
	`getTestInvocationListeners()` 從設定取得要使用的 `ITestInvocationListener`。
	`getTests()` 從設定取得要執行的 `IRemoteTest`。
`void`	`injectOptionValue(String optionName, String optionValue)` 將選項值插入設定物件集。
`void`	`injectOptionValue(String optionName, String optionKey, String optionValue)` 將選項值插入設定物件集。
`void`	`injectOptionValueWithSource(String optionName, String optionKey, String optionValue, String source)` 將選項值插入設定物件集。
`void`	`injectOptionValues( optionDefs)` 將多個選項值插入設定物件集。
`boolean`	`isDeviceConfiguredFake(String deviceName)` 傳回已設定的裝置是否標記為 isFake=true。
`IConfiguration`	`partialDeepClone( objectToDeepClone, IKeyStoreClient client)` 從 `clone()` 建立基本副本，然後深層複製指定設定物件的清單。
`void`	`printCommandUsage(boolean importantOnly, PrintStream out)` 將此設定的指令列用法說明文字輸出至指定的 printStream。
`void`	`resolveDynamicOptions(DynamicRemoteFileResolver resolver)` 解決 `ERROR(/File)` 指向遠端位置的選項。
`void`	`safeInjectOptionValues( optionDefs)` 將多個選項值注入設定物件集，如果其中一個選項無法套用，也不會擲回例外狀況。
	`setBestEffortOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` 盡量使用一組指定的指令列引數，設定 config `Option` 欄位。
`void`	`setBuildProvider(IBuildProvider provider)` 取代設定中的目前 `IBuildProvider`。
`void`	`setCommandLine(String[] arrayArgs)` 設定用於建立這個 `IConfiguration` 的指令列。
`void`	`setCommandOptions(ICommandOptions cmdOptions)` 設定 `ICommandOptions`，取代所有現有值
`void`	`setConfigurationObject(String typeName, Object configObject)` 設定具有指定名稱的設定物件，並取代任何現有值的通用方法。
`void`	`setConfigurationObjectList(String typeName, configList)` 一般方法，可為指定名稱設定設定物件清單，並取代任何現有值。
`void`	`setCoverageOptions(CoverageOptions coverageOptions)` 設定 `CoverageOptions`，取代所有現有值。
`void`	`setDeviceConfig(IDeviceConfiguration deviceConfig)` 設定 `IDeviceConfiguration`，取代所有現有值。
`void`	`setDeviceConfigList( deviceConfigs)` 設定 `IDeviceConfiguration`，取代現有值。
`void`	`setDeviceMetricCollectors( collectors)` 設定 `IMetricCollector` 清單，取代所有現有值。
`void`	`setDeviceOptions(TestDeviceOptions devOptions)` 設定 `TestDeviceOptions`，取代所有現有值
`void`	`setDeviceRecovery(IDeviceRecovery recovery)` 設定 `IDeviceRecovery`，取代所有現有值。
`void`	`setDeviceRequirements(IDeviceSelection devRequirements)` 設定 `IDeviceSelection`，取代所有現有值
`void`	`setLabPreparer(ITargetPreparer preparer)` 設定 `ITargetPreparer`，取代所有現有值。
`void`	`setLabPreparers( preparers)` 設定 `ITargetPreparer` 清單，取代任何現有值。
`void`	`setLogOutput(ILeveledLogOutput logger)` 設定 `ILeveledLogOutput`，取代現有值。
`void`	`setLogSaver(ILogSaver logSaver)` 設定 `ILogSaver`，取代所有現有值。
`void`	`setMultiPreTargetPreparer(IMultiTargetPreparer multiPreTargPrep)` 方便的方法，可在這個設定中設定單一 `IMultiTargetPreparer`，該設定應在任何裝置 target_preparer 之前執行，並取代任何現有值
`void`	`setMultiPreTargetPreparers( multiPreTargPreps)` 設定此設定中應在任何裝置 target_preparers 之前執行的 `IMultiTargetPreparer` 清單，取代任何現有值
`void`	`setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)` 設定此設定中單一 `IMultiTargetPreparer` 的便利方法，會取代任何現有值
`void`	`setMultiTargetPreparers( multiTargPreps)` 在這項設定中設定 `IMultiTargetPreparer` 清單，取代所有現有值
	`setOptionsFromCommandLineArgs( listArgs)` 使用指定的一組指令列引數設定 config `Option` 欄位如要查看預期格式，請點選 `ArgsOptionParser`
	`setOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` 使用指定的一組指令列引數設定 config `Option` 欄位如要查看預期格式，請參閱 `ArgsOptionParser`
`void`	`setPostProcessors( processors)` 設定 `IPostProcessor` 清單，取代所有現有值。
`void`	`setRetryDecision(IRetryDecision decisionRetry)` 設定 `IRetryDecision`，取代現有值。
`void`	`setSystemStatusChecker(ISystemStatusChecker systemChecker)` 設定此設定中單一 `ISystemStatusChecker` 的便利方法，會取代任何現有值
`void`	`setSystemStatusCheckers( systemCheckers)` 在這項設定中設定 `ISystemStatusChecker` 清單，取代所有現有值
`void`	`setTargetPreparer(ITargetPreparer preparer)` 設定 `ITargetPreparer`，取代所有現有值。
`void`	`setTargetPreparers( preparers)` 設定 `ITargetPreparer` 清單，取代任何現有值。
`void`	`setTest(IRemoteTest test)` 便利方法，可在這個設定中設定單一 `IRemoteTest`，取代任何現有值
`void`	`setTestInvocationListener(ITestInvocationListener listener)` 設定單一 `ITestInvocationListener` 的便利方法
`void`	`setTestInvocationListeners( listeners)` 設定 `ITestInvocationListener` 清單，取代所有現有值
`void`	`setTests( tests)` 在這項設定中設定 `IRemoteTest` 清單，取代所有現有值
`void`	`validateOptions()` 驗證選項值。

受保護的方法
`boolean`	`isRemoteEnvironment()` 傳回 TF 環境是否為遠端呼叫。

常數

BUILD_PROVIDER_TYPE_NAME

public static final String BUILD_PROVIDER_TYPE_NAME

常數值： "build_provider"

CMD_OPTIONS_TYPE_NAME

public static final String CMD_OPTIONS_TYPE_NAME

常數值： "cmd_options"

CONFIGURATION_DESCRIPTION_TYPE_NAME

public static final String CONFIGURATION_DESCRIPTION_TYPE_NAME

常數值： "config_desc"

COVERAGE_OPTIONS_TYPE_NAME

public static final String COVERAGE_OPTIONS_TYPE_NAME

常數值： "coverage"

DEVICE_METRICS_COLLECTOR_TYPE_NAME

public static final String DEVICE_METRICS_COLLECTOR_TYPE_NAME

常數值： "metrics_collector"

DEVICE_NAME

public static final String DEVICE_NAME

常數值： "device"

DEVICE_OPTIONS_TYPE_NAME

public static final String DEVICE_OPTIONS_TYPE_NAME

常數值： "device_options"

DEVICE_RECOVERY_TYPE_NAME

public static final String DEVICE_RECOVERY_TYPE_NAME

常數值： "device_recovery"

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

常數值： "device_requirements"

GLOBAL_FILTERS_TYPE_NAME

public static final String GLOBAL_FILTERS_TYPE_NAME

常數值： "global_filters"

LAB_PREPARER_TYPE_NAME

public static final String LAB_PREPARER_TYPE_NAME

常數值： "lab_preparer"

LOGGER_TYPE_NAME

public static final String LOGGER_TYPE_NAME

常數值： "logger"

LOG_SAVER_TYPE_NAME

public static final String LOG_SAVER_TYPE_NAME

常數值： "log_saver"

METRIC_POST_PROCESSOR_TYPE_NAME

public static final String METRIC_POST_PROCESSOR_TYPE_NAME

常數值： "metric_post_processor"

MULTI_PREPARER_TYPE_NAME

public static final String MULTI_PREPARER_TYPE_NAME

常數值： "multi_target_preparer"

MULTI_PRE_TARGET_PREPARER_TYPE_NAME

public static final String MULTI_PRE_TARGET_PREPARER_TYPE_NAME

常數值： "multi_pre_target_preparer"

RESULT_REPORTER_TYPE_NAME

public static final String RESULT_REPORTER_TYPE_NAME

常數值： "result_reporter"

RETRY_DECISION_TYPE_NAME

public static final String RETRY_DECISION_TYPE_NAME

常數值： "retry_decision"

SANBOX_OPTIONS_TYPE_NAME

public static final String SANBOX_OPTIONS_TYPE_NAME

常數值： "sandbox_options"

SANDBOX_TYPE_NAME

public static final String SANDBOX_TYPE_NAME

常數值： "sandbox"

SKIP_MANAGER_TYPE_NAME

public static final String SKIP_MANAGER_TYPE_NAME

常數值： "skip_manager"

SYSTEM_STATUS_CHECKER_TYPE_NAME

public static final String SYSTEM_STATUS_CHECKER_TYPE_NAME

常數值： "system_checker"

TARGET_PREPARER_TYPE_NAME

public static final String TARGET_PREPARER_TYPE_NAME

常數值： "target_preparer"

TEST_TYPE_NAME

public static final String TEST_TYPE_NAME

常數值： "test"

欄位

NON_MODULE_OBJECTS

public static final  NON_MODULE_OBJECTS

公用建構函式

設定

public Configuration (String name, 
                String description)

使用預設設定物件建立 Configuration。

參數
`name`	`String`
`description`	`String`

公用方法

addFilesToClean

public void addFilesToClean ( toBeCleaned)

新增在 cleanConfigurationData() 期間必須清除的檔案

參數
`toBeCleaned`

cleanConfigurationData

public void cleanConfigurationData ()

刪除下載至遠端檔案已解決的「選項」欄位的所有檔案。

複製

public Configuration clone ()

建立這個物件的淺層副本。

傳回
`Configuration`

dumpXml

public void dumpXml (PrintWriter output)

取得設定的展開 XML 檔案，其中顯示這個 IConfiguration 的所有選項 (做為 String)。

參數
`output`	`PrintWriter`：要將 XML 列印至的寫入器。

dumpXml

public void dumpXml (PrintWriter output, 
                 excludeFilters)

取得設定的展開式 XML 檔案，其中顯示這個 IConfiguration 的所有選項，但物件會依鍵名篩選。

篩選器範例：Configuration.TARGET_PREPARER_TYPE_NAME。

參數
`output`	`PrintWriter`：要將 XML 列印至的寫入器。
`excludeFilters`	：不應傾印的物件型別清單。

dumpXml

public void dumpXml (PrintWriter output, 
                 excludeFilters, 
                boolean printDeprecatedOptions, 
                boolean printUnchangedOptions)

取得設定的展開式 XML 檔案，其中顯示這個 IConfiguration 的所有選項，但物件會依鍵名篩選。

篩選器範例：Configuration.TARGET_PREPARER_TYPE_NAME。

參數
`output`	`PrintWriter`：要將 XML 列印至的寫入器。
`excludeFilters`	：不應傾印的物件型別清單。
`printDeprecatedOptions`	`boolean`：是否列印標示為已淘汰的選項
`printUnchangedOptions`	`boolean`

getAllConfigurationObjectsOfType

public  getAllConfigurationObjectsOfType (String configType)

通用介面，可取得所有裝置中指定型別名稱的所有物件。

參數
`configType`	`String`：設定物件的專屬類型

傳回
	指定類型的設定物件清單。

getBuildProvider

public IBuildProvider getBuildProvider ()

從設定取得 IBuildProvider。

傳回
`IBuildProvider`	設定中提供的 `IBuildProvider`

getCommandLine

public String getCommandLine ()

取得用於建立這個 IConfiguration 的指令列。

傳回
`String`	用於建立這個 `IConfiguration` 的指令列。

getCommandOptions

public ICommandOptions getCommandOptions ()

從設定中取得要使用的 ICommandOptions。

傳回
`ICommandOptions`	設定中提供的 `ICommandOptions`。

getConfigurationDescription

public ConfigurationDescriptor getConfigurationDescription ()

傳回設定中提供的 ConfigurationDescriptor。

傳回
`ConfigurationDescriptor`

getConfigurationObject

public Object getConfigurationObject (String typeName)

通用介面，可取得具有指定型別名稱的設定物件。

參數
`typeName`	`String`：設定物件的專屬類型

傳回
`Object`	設定物件，或如果具有指定名稱的物件類型不存在，則為 `null`。

getConfigurationObjectList

public  getConfigurationObjectList (String typeName)

與 getConfigurationObject(String) 類似，但適用於支援多個物件的設定物件類型。

參數
`typeName`	`String`：設定物件的專屬型別名稱

傳回
	設定物件清單，或如果具有指定名稱的物件類型不存在，則為 `null`。

getCoverageOptions

public CoverageOptions getCoverageOptions ()

從設定中取得要使用的 CoverageOptions。

傳回
`CoverageOptions`	設定中提供的 `CoverageOptions`。

getDescription

public String getDescription ()

傳回
`String`	使用者可讀的簡短說明，`Configuration`

getDeviceConfig

public  getDeviceConfig ()

從設定取得 IDeviceConfiguration。

傳回
	設定中依序提供的 `IDeviceConfiguration`

getDeviceConfigByName

public IDeviceConfiguration getDeviceConfigByName (String nameDevice)

傳回與所提供名稱相關聯的 IDeviceConfiguration，如果找不到則傳回 null。

參數
`nameDevice`	`String`

傳回
`IDeviceConfiguration`

getDeviceOptions

public TestDeviceOptions getDeviceOptions ()

從設定中取得要使用的 TestDeviceOptions。

傳回
`TestDeviceOptions`	設定中提供的 `TestDeviceOptions`。

getDeviceRecovery

public IDeviceRecovery getDeviceRecovery ()

從設定中取得要使用的 IDeviceRecovery。

傳回
`IDeviceRecovery`	設定中提供的 `IDeviceRecovery`。

getDeviceRequirements

public IDeviceSelection getDeviceRequirements ()

從設定中取得要使用的 IDeviceSelection。

傳回
`IDeviceSelection`	設定中提供的 `IDeviceSelection`。

getFilesToClean

public  getFilesToClean ()

取得 cleanConfigurationData() 期間會清除的檔案清單

傳回

getGlobalFilters

public GlobalTestFilter getGlobalFilters ()

取得叫用作業的 GlobalTestFilter。

傳回
`GlobalTestFilter`

getInopOptions

public  getInopOptions ()

取得未變更任何值的選項名稱

傳回

getLabPreparers

public  getLabPreparers ()

從設定取得 ITargetPreparer。

傳回
	設定中依序提供的 `ITargetPreparer`

getLogOutput

public ILeveledLogOutput getLogOutput ()

從設定中取得要使用的 ILeveledLogOutput。

傳回
`ILeveledLogOutput`	設定中提供的 `ILeveledLogOutput`。

getLogSaver

public ILogSaver getLogSaver ()

從設定中取得要使用的 ILogSaver。

傳回
`ILogSaver`	設定中提供的 `ILogSaver`。

getMetricCollectors

public  getMetricCollectors ()

從設定取得 IMetricCollector。

傳回

getMultiDeviceSupportedTag

public static  getMultiDeviceSupportedTag ()

傳回裝置標記的 ERROR(/Set)，支援多裝置設定。

傳回

getMultiPreTargetPreparers

public  getMultiPreTargetPreparers ()

從應在任何裝置 target_preparer 之前執行的設定中取得 IMultiTargetPreparer。

傳回
	設定中依序提供的 `IMultiTargetPreparer`

getMultiTargetPreparers

public  getMultiTargetPreparers ()

從設定取得 IMultiTargetPreparer。

傳回
	設定中依序提供的 `IMultiTargetPreparer`

getName

public String getName ()

傳回設定名稱。

傳回
`String`

getPostProcessors

public  getPostProcessors ()

從設定中取得 IPostProcessor。

傳回

getRetryDecision

public IRetryDecision getRetryDecision ()

傳回用於調用的 IRetryDecision。

傳回
`IRetryDecision`

getSkipManager

public SkipManager getSkipManager ()

取得叫用作業的 SkipManager。

傳回
`SkipManager`

getSystemStatusCheckers

public  getSystemStatusCheckers ()

從設定取得 ISystemStatusChecker。

傳回
	設定中依序提供的 `ISystemStatusChecker`

getTargetPreparers

public  getTargetPreparers ()

從設定中取得 ITargetPreparer。

傳回
	設定中依序提供的 `ITargetPreparer`

getTestInvocationListeners

public  getTestInvocationListeners ()

從設定取得要使用的 ITestInvocationListener。

傳回
	設定中提供的 `ITestInvocationListener`。

getTests

public  getTests ()

從設定取得要執行的 IRemoteTest。

傳回
	設定中提供的測試

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionValue)

將選項值插入設定物件集。

有助於為動態產生的選項提供值。

參數
`optionName`	`String`：選項名稱
`optionValue`	`String`：選項值

擲回
`ConfigurationException`

injectOptionValue

public void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

將選項值插入設定物件集。

有助於為動態產生的選項提供值。

參數
`optionName`	`String`：選項名稱
`optionKey`	`String`：地圖選項的選用鍵，或空值
`optionValue`	`String`：地圖選項值

擲回
`ConfigurationException`

injectOptionValueWithSource

public void injectOptionValueWithSource (String optionName, 
                String optionKey, 
                String optionValue, 
                String source)

將選項值插入設定物件集。

有助於為動態產生的選項提供值。

參數
`optionName`	`String`：選項名稱
`optionKey`	`String`：地圖選項的選用鍵，或空值
`optionValue`	`String`：地圖選項值
`source`	`String`：提供這個選項值的來源設定

擲回
`ConfigurationException`

injectOptionValues

public void injectOptionValues ( optionDefs)

將多個選項值插入設定物件集。

建立新物件後，一次注入多個選項值時非常實用。

參數
`optionDefs`	：要插入的選項定義清單

擲回
`ConfigurationException`

isDeviceConfiguredFake

public boolean isDeviceConfiguredFake (String deviceName)

傳回已設定的裝置是否標記為 isFake=true。

參數
`deviceName`	`String`

傳回
`boolean`

partialDeepClone

public IConfiguration partialDeepClone ( objectToDeepClone, 
                IKeyStoreClient client)

從 clone() 建立基本副本，然後深層複製指定設定物件的清單。

參數
`objectToDeepClone`	：要深層複製的設定物件清單。
`client`	`IKeyStoreClient`：金鑰儲存區用戶端。

傳回
`IConfiguration`	部分深層複製的設定。

擲回
`ConfigurationException`

printCommandUsage

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

將此設定的指令列用法說明文字輸出至指定的 printStream。

參數
`importantOnly`	`boolean`：如果 `true` 只列印重要選項的說明
`out`	`PrintStream`：要使用的 `ERROR(/PrintStream)`。

擲回
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

resolveDynamicOptions

public void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

解決指向遠端位置的 ERROR(/File) 選項。這需要呼叫 cleanConfigurationData() 來清除檔案。

參數
`resolver`	`DynamicRemoteFileResolver`：`DynamicRemoteFileResolver`，用於解析檔案

擲回
`BuildRetrievalError`
`ConfigurationException`

safeInjectOptionValues

public void safeInjectOptionValues ( optionDefs)

將多個選項值插入設定物件集，即使其中一個選項無法套用，也不會擲回例外狀況。

建立新物件後，一次注入多個選項值時非常實用。

參數
`optionDefs`	：要插入的選項定義清單

擲回
`ConfigurationException`

setBestEffortOptionsFromCommandLineArgs

public  setBestEffortOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

盡量使用一組指定的指令列引數，設定 config Option 欄位。

如要查看預期格式，請參閱 ArgsOptionParser

參數
`listArgs`	：指令列引數
`keyStoreClient`	`IKeyStoreClient`：要使用的 `IKeyStoreClient`。

傳回
	未使用的引數

擲回
`ConfigurationException`

setBuildProvider

public void setBuildProvider (IBuildProvider provider)

取代設定中的現有 IBuildProvider。

參數
`provider`	`IBuildProvider`：新的 `IBuildProvider`

setCommandLine

public void setCommandLine (String[] arrayArgs)

設定用於建立這個 IConfiguration 的指令列。這會儲存整個指令列，包括設定名稱，與 setOptionsFromCommandLineArgs 不同。

參數
`arrayArgs`	`String`：指令列

setCommandOptions

public void setCommandOptions (ICommandOptions cmdOptions)

設定 ICommandOptions，並取代所有現有值

setConfigurationObject

public void setConfigurationObject (String typeName, 
                Object configObject)

設定具有指定名稱的設定物件，並取代任何現有值的通用方法。

參數
`typeName`	`String`：設定物件類型的專屬名稱。
`configObject`	`Object`：設定物件

擲回
`ConfigurationException`

setConfigurationObjectList

public void setConfigurationObjectList (String typeName, 
                 configList)

一般方法：為指定名稱設定設定物件清單，取代任何現有值。

參數
`typeName`	`String`：設定物件類型的專屬名稱。
`configList`	：設定物件清單

擲回
`ConfigurationException`

setCoverageOptions

public void setCoverageOptions (CoverageOptions coverageOptions)

設定 CoverageOptions，取代所有現有值。

參數
`coverageOptions`	`CoverageOptions`

setDeviceConfig

public void setDeviceConfig (IDeviceConfiguration deviceConfig)

設定 IDeviceConfiguration，取代所有現有值。

setDeviceConfigList

public void setDeviceConfigList ( deviceConfigs)

設定 IDeviceConfiguration，取代現有值。

setDeviceMetricCollectors

public void setDeviceMetricCollectors ( collectors)

設定 IMetricCollector 清單，取代所有現有值。

參數
`collectors`

setDeviceOptions

public void setDeviceOptions (TestDeviceOptions devOptions)

設定 TestDeviceOptions，並取代所有現有值

參數
`devOptions`	`TestDeviceOptions`

setDeviceRecovery

public void setDeviceRecovery (IDeviceRecovery recovery)

設定 IDeviceRecovery，取代所有現有值。

setDeviceRequirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

設定 IDeviceSelection，並取代所有現有值

setLabPreparer

public void setLabPreparer (ITargetPreparer preparer)

設定 ITargetPreparer，取代所有現有值。

setLabPreparers

public void setLabPreparers ( preparers)

設定 ITargetPreparer 清單，取代現有值。

setLogOutput

public void setLogOutput (ILeveledLogOutput logger)

設定 ILeveledLogOutput，取代所有現有值。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

設定 ILogSaver，取代所有現有值。

setMultiPreTargetPreparer

public void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPrep)

便利方法，可在這個設定中設定單一 IMultiTargetPreparer，該設定應在任何裝置 target_preparer 之前執行，並取代任何現有值

setMultiPreTargetPreparers

public void setMultiPreTargetPreparers ( multiPreTargPreps)

設定此設定中應在任何裝置 target_preparer 之前執行的 IMultiTargetPreparer 清單，取代任何現有值

setMultiTargetPreparer

public void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

設定此設定中單一 IMultiTargetPreparer 的便利方法，會取代任何現有值

setMultiTargetPreparers

public void setMultiTargetPreparers ( multiTargPreps)

在這項設定中設定 IMultiTargetPreparer 清單，取代所有現有值

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

使用指定的一組指令列引數設定 config Option 欄位

如要查看預期格式，請點選 ArgsOptionParser

參數
`listArgs`	：指令列引數

傳回
	未使用的引數

擲回
`ConfigurationException`

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

使用指定的一組指令列引數設定 config Option 欄位

如要查看預期格式，請參閱 ArgsOptionParser

參數
`listArgs`	：指令列引數
`keyStoreClient`	`IKeyStoreClient`：要使用的 `IKeyStoreClient`。

傳回
	未使用的引數

擲回
`ConfigurationException`

setPostProcessors

public void setPostProcessors ( processors)

設定 IPostProcessor 清單，取代所有現有值。

參數
`processors`

setRetryDecision

public void setRetryDecision (IRetryDecision decisionRetry)

設定 IRetryDecision，取代所有現有值。

setSystemStatusChecker

public void setSystemStatusChecker (ISystemStatusChecker systemChecker)

設定此設定中單一 ISystemStatusChecker 的便利方法，會取代任何現有值

setSystemStatusCheckers

public void setSystemStatusCheckers ( systemCheckers)

在這項設定中設定 ISystemStatusChecker 清單，取代所有現有值

setTargetPreparer

public void setTargetPreparer (ITargetPreparer preparer)

設定 ITargetPreparer，取代所有現有值。

setTargetPreparers

public void setTargetPreparers ( preparers)

設定 ITargetPreparer 清單，取代現有值。

setTest

public void setTest (IRemoteTest test)

設定此設定中的單一 IRemoteTest，並取代任何現有值的便利方法

setTestInvocationListener

public void setTestInvocationListener (ITestInvocationListener listener)

設定單一 ITestInvocationListener 的便利方法

setTestInvocationListeners

public void setTestInvocationListeners ( listeners)

設定 ITestInvocationListener 清單，取代所有現有值

setTests

public void setTests ( tests)

在這項設定中設定 IRemoteTest 清單，取代所有現有值

validateOptions

public void validateOptions ()

驗證選項值。

目前這項功能只會驗證是否已設定所有必填選項

擲回
`ConfigurationException`

受保護的方法

isRemoteEnvironment

protected boolean isRemoteEnvironment ()

傳回 TF 環境是否為遠端呼叫。

傳回
`boolean`