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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IConfiguration

public interface IConfiguration

com.android.tradefed.config.IConfiguration

已知間接子類別

設定

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

TradeFederation 叫用的設定資訊。每次叫用 TradeFederation 都會有單一 IConfiguration。IConfiguration 會儲存應在叫用期間使用的所有委派物件，以及相關聯的 Option

摘要

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

公用方法

addFilesToClean

public abstract void addFilesToClean (Set<File> toBeCleaned)

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

參數
`toBeCleaned`	`Set`

cleanConfigurationData

public abstract void cleanConfigurationData ()

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

clone

public abstract IConfiguration clone ()

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

傳回
`IConfiguration`	{link IConfiguration} 副本

dumpXml

public abstract void dumpXml (PrintWriter output)

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

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

擲回
	java.io.IOException
`IOException`

dumpXml

public abstract void dumpXml (PrintWriter output, 
                List<String> excludeFilters)

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

篩選器範例：Configuration.TARGET_PREPARER_TYPE_NAME。

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

擲回
	java.io.IOException
`IOException`

dumpXml

public abstract void dumpXml (PrintWriter output, 
                List<String> excludeFilters, 
                boolean printDeprecatedOptions, 
                boolean printUnchangedOptions)

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

篩選器範例：Configuration.TARGET_PREPARER_TYPE_NAME。

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

擲回
	java.io.IOException
`IOException`

getAllConfigurationObjectsOfType

public abstract Collection<Object> getAllConfigurationObjectsOfType (String typeName)

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

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

傳回
`Collection<Object>`	指定類型的設定物件清單。

getBuildProvider

public abstract IBuildProvider getBuildProvider ()

從設定取得 IBuildProvider。

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

getCommandLine

public abstract String getCommandLine ()

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

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

getCommandOptions

public abstract ICommandOptions getCommandOptions ()

從設定取得要使用的 ICommandOptions。

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

getConfigurationDescription

public abstract ConfigurationDescriptor getConfigurationDescription ()

傳回設定中提供的 ConfigurationDescriptor。

傳回
`ConfigurationDescriptor`

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

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

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

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

getConfigurationObjectList

public abstract List<?> getConfigurationObjectList (String typeName)

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

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

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

getCoverageOptions

public abstract CoverageOptions getCoverageOptions ()

從設定取得要使用的 CoverageOptions。

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

getDeviceConfig

public abstract List<IDeviceConfiguration> getDeviceConfig ()

從設定取得 IDeviceConfiguration。

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

getDeviceConfigByName

public abstract IDeviceConfiguration getDeviceConfigByName (String nameDevice)

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

參數
`nameDevice`	`String`

傳回
`IDeviceConfiguration`

getDeviceOptions

public abstract TestDeviceOptions getDeviceOptions ()

從設定取得要使用的 TestDeviceOptions。

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

getDeviceRecovery

public abstract IDeviceRecovery getDeviceRecovery ()

從設定取得要使用的 IDeviceRecovery。

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

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

從設定取得要使用的 IDeviceSelection。

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

getFilesToClean

public abstract Set<File> getFilesToClean ()

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

傳回
`Set<File>`

getGlobalFilters

public abstract GlobalTestFilter getGlobalFilters ()

取得叫用作業的 GlobalTestFilter。

傳回
`GlobalTestFilter`

getInopOptions

public abstract Set<String> getInopOptions ()

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

傳回
`Set<String>`

getLabPreparers

public abstract List<ITargetPreparer> getLabPreparers ()

從設定取得 ITargetPreparer。

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

getLogOutput

public abstract ILeveledLogOutput getLogOutput ()

從設定取得要使用的 ILeveledLogOutput。

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

getLogSaver

public abstract ILogSaver getLogSaver ()

從設定取得要使用的 ILogSaver。

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

getMetricCollectors

public abstract List<IMetricCollector> getMetricCollectors ()

從設定取得 IMetricCollector。

傳回
`List<IMetricCollector>`

getMultiPreTargetPreparers

public abstract List<IMultiTargetPreparer> getMultiPreTargetPreparers ()

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

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

getMultiTargetPreparers

public abstract List<IMultiTargetPreparer> getMultiTargetPreparers ()

從設定取得 IMultiTargetPreparer。

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

getName

public abstract String getName ()

傳回設定名稱。

傳回
`String`

getPostProcessors

public abstract List<IPostProcessor> getPostProcessors ()

從設定取得 IPostProcessor。

傳回
`List<IPostProcessor>`

getRetryDecision

public abstract IRetryDecision getRetryDecision ()

傳回用於調用的 IRetryDecision。

傳回
`IRetryDecision`

getSkipManager

public abstract SkipManager getSkipManager ()

取得叫用作業的 SkipManager。

傳回
`SkipManager`

getSystemStatusCheckers

public abstract List<ISystemStatusChecker> getSystemStatusCheckers ()

從設定取得 ISystemStatusChecker。

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

getTargetPreparers

public abstract List<ITargetPreparer> getTargetPreparers ()

從設定取得 ITargetPreparer。

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

getTestInvocationListeners

public abstract List<ITestInvocationListener> getTestInvocationListeners ()

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

傳回
`List<ITestInvocationListener>`	設定中提供的 `ITestInvocationListener`。

getTests

public abstract List<IRemoteTest> getTests ()

從設定取得要執行的 IRemoteTest。

傳回
`List<IRemoteTest>`	設定中提供的測試

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

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

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

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

擲回
`ConfigurationException`	如果無法設定選項的值

injectOptionValue

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

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

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

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

擲回
`ConfigurationException`	如果無法設定選項的值

injectOptionValueWithSource

public abstract void injectOptionValueWithSource (String optionName, 
                String optionKey, 
                String optionValue, 
                String optionSource)

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

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

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

擲回
`ConfigurationException`	如果無法設定選項的值

injectOptionValues

public abstract void injectOptionValues (List<OptionDef> optionDefs)

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

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

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

擲回
`ConfigurationException`	如果無法設定選項值

isDeviceConfiguredFake

public abstract boolean isDeviceConfiguredFake (String deviceName)

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

參數
`deviceName`	`String`

傳回
`boolean`

partialDeepClone

public abstract IConfiguration partialDeepClone (List<String> objectToDeepClone, 
                IKeyStoreClient client)

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

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

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

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

printCommandUsage

public abstract void printCommandUsage (boolean importantOnly, 
                PrintStream out)

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

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

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

resolveDynamicOptions

public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)

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

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

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

safeInjectOptionValues

public abstract void safeInjectOptionValues (List<OptionDef> optionDefs)

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

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

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

擲回
`ConfigurationException`	如果無法建立 `OptionSetter`

setBestEffortOptionsFromCommandLineArgs

public abstract List<String> setBestEffortOptionsFromCommandLineArgs (List<String> listArgs, 
                IKeyStoreClient keyStoreClient)

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

請參閱 ArgsOptionParser，瞭解預期格式。

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

傳回
`List<String>`	未使用的引數

擲回
`ConfigurationException`

setBuildProvider

public abstract void setBuildProvider (IBuildProvider provider)

取代設定中的現有 IBuildProvider。

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

setCommandLine

public abstract void setCommandLine (String[] arrayArgs)

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

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

setCommandOptions

public abstract void setCommandOptions (ICommandOptions cmdOptions)

設定 ICommandOptions，取代所有現有值

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

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

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

擲回
`ConfigurationException`	如果 configObject 的類型不正確

setConfigurationObjectList

public abstract void setConfigurationObjectList (String name, 
                List<?> configList)

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

參數
`name`	`String`：設定物件型別的專屬名稱。
`configList`	`List`：設定物件清單

擲回
`ConfigurationException`	如果清單中的任何物件類型不正確

setCoverageOptions

public abstract void setCoverageOptions (CoverageOptions coverageOptions)

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

參數
`coverageOptions`	`CoverageOptions`

setDeviceConfig

public abstract void setDeviceConfig (IDeviceConfiguration deviceConfig)

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

setDeviceConfigList

public abstract void setDeviceConfigList (List<IDeviceConfiguration> deviceConfigs)

設定 IDeviceConfiguration，取代現有值。

setDeviceMetricCollectors

public abstract void setDeviceMetricCollectors (List<IMetricCollector> collectors)

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

參數
`collectors`	`List`

setDeviceOptions

public abstract void setDeviceOptions (TestDeviceOptions deviceOptions)

設定 TestDeviceOptions，取代所有現有值

參數
`deviceOptions`	`TestDeviceOptions`

setDeviceRecovery

public abstract void setDeviceRecovery (IDeviceRecovery recovery)

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

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

設定 IDeviceSelection，取代所有現有值

setLabPreparer

public abstract void setLabPreparer (ITargetPreparer preparer)

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

setLabPreparers

public abstract void setLabPreparers (List<ITargetPreparer> preparers)

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

setLogOutput

public abstract void setLogOutput (ILeveledLogOutput logger)

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

setLogSaver

public abstract void setLogSaver (ILogSaver logSaver)

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

setMultiPreTargetPreparer

public abstract void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPreps)

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

setMultiPreTargetPreparers

public abstract void setMultiPreTargetPreparers (List<IMultiTargetPreparer> multiPreTargPreps)

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

setMultiTargetPreparer

public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

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

setMultiTargetPreparers

public abstract void setMultiTargetPreparers (List<IMultiTargetPreparer> multiTargPreps)

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

setOptionsFromCommandLineArgs

public abstract List<String> setOptionsFromCommandLineArgs (List<String> listArgs)

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

ArgsOptionParser，瞭解預期格式

參數
`listArgs`	`List`：指令列引數

傳回
`List<String>`	未使用的引數

擲回
`ConfigurationException`

setOptionsFromCommandLineArgs

public abstract List<String> setOptionsFromCommandLineArgs (List<String> listArgs, 
                IKeyStoreClient keyStoreClient)

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

請參閱 ArgsOptionParser，瞭解預期格式。

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

傳回
`List<String>`	未使用的引數

擲回
`ConfigurationException`

setPostProcessors

public abstract void setPostProcessors (List<IPostProcessor> processors)

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

參數
`processors`	`List`

setRetryDecision

public abstract void setRetryDecision (IRetryDecision decisionRetry)

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

setSkipManager

public abstract void setSkipManager (SkipManager skipManager)

設定呼叫的 SkipManager。

參數
`skipManager`	`SkipManager`

setSystemStatusChecker

public abstract void setSystemStatusChecker (ISystemStatusChecker systemChecker)

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

setSystemStatusCheckers

public abstract void setSystemStatusCheckers (List<ISystemStatusChecker> systemCheckers)

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

setTargetPreparer

public abstract void setTargetPreparer (ITargetPreparer preparer)

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

setTargetPreparers

public abstract void setTargetPreparers (List<ITargetPreparer> preparers)

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

setTest

public abstract void setTest (IRemoteTest test)

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

setTestInvocationListener

public abstract void setTestInvocationListener (ITestInvocationListener listener)

設定單一 ITestInvocationListener 的便利方法

setTestInvocationListeners

public abstract void setTestInvocationListeners (List<ITestInvocationListener> listeners)

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

setTests

public abstract void setTests (List<IRemoteTest> tests)

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

validateOptions

public abstract void validateOptions ()

驗證選項值。

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

擲回
`ConfigurationException`	如果設定無效