本頁面由 Cloud Translation API 翻譯而成。

設定

public class Configuration
extends Object implements IConfiguration

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

具體的 IConfiguration 實作，可將已載入的設定物件儲存在地圖中。

摘要

欄位
`public static final String`	`BUILD_PROVIDER_TYPE_NAME`
`public static final String`	`CMD_OPTIONS_TYPE_NAME`
`public static final String`	`CONFIGURATION_DESCRIPTION_TYPE_NAME`
`public static final String`	`COVERAGE_OPTIONS_TYPE_NAME`
`public static final String`	`DEVICE_METRICS_COLLECTOR_TYPE_NAME`
`public static final String`	`DEVICE_NAME`
`public static final String`	`DEVICE_OPTIONS_TYPE_NAME`
`public static final String`	`DEVICE_RECOVERY_TYPE_NAME`
`public static final String`	`DEVICE_REQUIREMENTS_TYPE_NAME`
`public static final String`	`GLOBAL_FILTERS_TYPE_NAME`
`public static final String`	`LAB_PREPARER_TYPE_NAME`
`public static final String`	`LOGGER_TYPE_NAME`
`public static final String`	`LOG_SAVER_TYPE_NAME`
`public static final String`	`METRIC_POST_PROCESSOR_TYPE_NAME`
`public static final String`	`MULTI_PREPARER_TYPE_NAME`
`public static final String`	`MULTI_PRE_TARGET_PREPARER_TYPE_NAME`
`public static final String`	`RESULT_REPORTER_TYPE_NAME`
`public static final String`	`RETRY_DECISION_TYPE_NAME`
`public static final String`	`SANBOX_OPTIONS_TYPE_NAME`
`public static final String`	`SANDBOX_TYPE_NAME`
`public static final String`	`SYSTEM_STATUS_CHECKER_TYPE_NAME`
`public static final String`	`TARGET_PREPARER_TYPE_NAME`
`public static final String`	`TEST_TYPE_NAME`

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

公用方法
`void`	`addFilesToClean( toBeCleaned)` 新增`cleanConfigurationData()`期間必須清理的檔案
`void`	`cleanConfigurationData()` 刪除已下載至遠端檔案選項欄位的所有下載檔案。
`Configuration`	`clone()` 建立這個物件的淺層複本。
`void`	`dumpXml(PrintWriter output)` 取得設定的擴充 XML 檔案，以及此設定的所有選項以 `String` 格式指定的 `IConfiguration`。
`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`，如果找不到，則為空值。
`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`。
	`getMultiPreTargetPreparers()` 從應執行的設定取得 `IMultiTargetPreparer` 目標裝置之一
	`getMultiTargetPreparers()` 從設定取得 `IMultiTargetPreparer`。
`String`	`getName()` 傳回設定名稱。
	`getPostProcessors()` 從設定取得 `IPostProcessor`。
`IRetryDecision`	`getRetryDecision()` 傳回用於叫用的 `IRetryDecision`。
	`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)` 使用最佳參考資源，設定含有指定一組指令列引數的 `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_preparers 任一裝置，取代任何現有值
`void`	`setMultiPreTargetPreparers( multiPreTargPreps)` 設定這項設定中應執行的 `IMultiTargetPreparer` 清單在所有裝置 target_preparers 前，替換任何現有的值
`void`	`setMultiTargetPreparer(IMultiTargetPreparer multiTargPrep)` 可在這項設定中設定單一 `IMultiTargetPreparer` 的便利方法。取代任何現有值
`void`	`setMultiTargetPreparers( multiTargPreps)` 設定此設定中的 `IMultiTargetPreparer` 清單，取代任何現有的值
	`setOptionsFromCommandLineArgs( listArgs)` 使用指定的一組指令列引數，設定 `Option` 設定欄位預期格式的`ArgsOptionParser`
	`setOptionsFromCommandLineArgs( listArgs, IKeyStoreClient keyStoreClient)` 使用指定的一組指令列引數，設定 `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

CMD_OPTIONS_TYPE_NAME

public static final String CMD_OPTIONS_TYPE_NAME

CONFIGURATION_DESCRIPTION_TYPE_NAME

public static final String CONFIGURATION_DESCRIPTION_TYPE_NAME

COVERAGE_OPTIONS_TYPE_NAME

public static final String COVERAGE_OPTIONS_TYPE_NAME

DEVICE_METRICS_COLLECTOR_TYPE_NAME

public static final String DEVICE_METRICS_COLLECTOR_TYPE_NAME

DEVICE_NAME

public static final String DEVICE_NAME

DEVICE_OPTIONS_TYPE_NAME

public static final String DEVICE_OPTIONS_TYPE_NAME

DEVICE_RECOVERY_TYPE_NAME

public static final String DEVICE_RECOVERY_TYPE_NAME

DEVICE_REQUIREMENTS_TYPE_NAME

public static final String DEVICE_REQUIREMENTS_TYPE_NAME

GLOBAL_FILTERS_TYPE_NAME

public static final String GLOBAL_FILTERS_TYPE_NAME

LAB_PREPARER_TYPE_NAME

public static final String LAB_PREPARER_TYPE_NAME

LOGGER_TYPE_NAME

public static final String LOGGER_TYPE_NAME

LOG_SAVER_TYPE_NAME

public static final String LOG_SAVER_TYPE_NAME

METRIC_POST_PROCESSOR_TYPE_NAME

public static final String METRIC_POST_PROCESSOR_TYPE_NAME

MULTI_PREPARER_TYPE_NAME

public static final String MULTI_PREPARER_TYPE_NAME

MULTI_PRE_TARGET_PREPARER_TYPE_NAME

public static final String MULTI_PRE_TARGET_PREPARER_TYPE_NAME

RESULT_REPORTER_TYPE_NAME

public static final String RESULT_REPORTER_TYPE_NAME

RETRY_DECISION_TYPE_NAME

public static final String RETRY_DECISION_TYPE_NAME

SANBOX_OPTIONS_TYPE_NAME

public static final String SANBOX_OPTIONS_TYPE_NAME

SANDBOX_TYPE_NAME

public static final String SANDBOX_TYPE_NAME

SYSTEM_STATUS_CHECKER_TYPE_NAME

public static final String SYSTEM_STATUS_CHECKER_TYPE_NAME

TARGET_PREPARER_TYPE_NAME

public static final String TARGET_PREPARER_TYPE_NAME

TEST_TYPE_NAME

public static final String TEST_TYPE_NAME

公用建構函式

設定

public Configuration (String name, 
                String description)

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

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

公用方法

addFilesToClean

public void addFilesToClean ( toBeCleaned)

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

參數
`toBeCleaned`

清理設定資料

public void cleanConfigurationData ()

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

本機副本

public Configuration clone ()

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

傳回
`Configuration`

dumpXml

public void dumpXml (PrintWriter output)

取得設定的擴充 XML 檔案，以及此設定的所有選項以 String 格式指定的 IConfiguration。

參數
`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，如果找不到，則為空值。

參數
`nameDevice`	`String`

傳回
`IDeviceConfiguration`

getDeviceOptions

public TestDeviceOptions getDeviceOptions ()

從設定取得要使用的 TestDeviceOptions。

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

getDeviceRecovery

public IDeviceRecovery getDeviceRecovery ()

從設定取得要使用的 IDeviceRecovery。

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

getDevice requirements

public IDeviceSelection getDeviceRequirements ()

從設定取得要使用的 IDeviceSelection。

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

getFilesToClean

public  getFilesToClean ()

取得將在 cleanConfigurationData() 中清除的檔案清單

傳回

getGlobalFilters

public GlobalTestFilter getGlobalFilters ()

取得叫用的 GlobalTestFilter。

傳回
`GlobalTestFilter`

getInopOptions

public  getInopOptions ()

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

傳回

getLabPreparers

public  getLabPreparers ()

從設定取得 ITargetPreparer。

傳回
	依序提供的 `ITargetPreparer`

取得記錄輸出

public ILeveledLogOutput getLogOutput ()

從設定取得要使用的 ILeveledLogOutput。

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

取得 LogSaver

public ILogSaver getLogSaver ()

從設定取得要使用的 ILogSaver。

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

getMetricCollectors

public  getMetricCollectors ()

從設定取得 IMetricCollector。

傳回

getMultiPreTargetPreparers

public  getMultiPreTargetPreparers ()

從應執行的設定取得 IMultiTargetPreparer 目標裝置之一

傳回
	依序提供的 `IMultiTargetPreparer`

getMultiTargetPreparers

public  getMultiTargetPreparers ()

從設定取得 IMultiTargetPreparer。

傳回
	依序提供的 `IMultiTargetPreparer`

getName

public String getName ()

傳回設定名稱。

傳回
`String`

getPostProcessors

public  getPostProcessors ()

從設定取得 IPostProcessor。

傳回

getResumeDecision

public IRetryDecision getRetryDecision ()

傳回用於叫用的 IRetryDecision。

傳回
`IRetryDecision`

getSystemStatusCheckers

public  getSystemStatusCheckers ()

從設定取得 ISystemStatusChecker。

傳回
	依序提供的 `ISystemStatusChecker`

getTargetPreparers

public  getTargetPreparers ()

從設定取得 ITargetPreparer。

傳回
	依序提供的 `ITargetPreparer`

getTestInvocationListeners

public  getTestInvocationListeners ()

從設定取得要使用的 ITestInvocationListener。

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

getTests

public  getTests ()

取得要從設定執行的 IRemoteTest。

傳回
	從設定中提供的測試

插入選項值

public void injectOptionValue (String optionName, 
                String optionValue)

將選項值插入一組設定物件。

適合針對動態產生的選項提供值。

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

擲回
`ConfigurationException`

插入選項值

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`

插入選項值

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`：KeyStore 用戶端。

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

擲回
`ConfigurationException`

printCommand 使用量

public void printCommandUsage (boolean importantOnly, 
                PrintStream out)

輸出這項設定的指令列使用情形說明文字， printStream。

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

擲回
`ConfigurationException`

responseDynamicOptions (解決動態選項)

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)

使用最佳參考資源，設定含有指定一組指令列引數的 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`：config 物件

擲回
`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，取代任何現有的值。

setDevice requirements

public void setDeviceRequirements (IDeviceSelection devRequirements)

設定 IDeviceSelection，取代任何現有值

setLabPreparer

public void setLabPreparer (ITargetPreparer preparer)

設定 ITargetPreparer，取代任何現有的值。

setLabPreparers

public void setLabPreparers ( preparers)

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

設定記錄輸出

public void setLogOutput (ILeveledLogOutput logger)

設定 ILeveledLogOutput，取代任何現有的值。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

設定 ILogSaver，取代任何現有的值。

setMultiPreTargetPreparer

public void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPrep)

在這個設定中設置單一 IMultiTargetPreparer 的便利方法，應執行於 target_preparers 任一裝置，取代任何現有值

setMultiPreTargetPreparers

public void setMultiPreTargetPreparers ( multiPreTargPreps)

設定這項設定中應執行的 IMultiTargetPreparer 清單在所有裝置 target_preparers 前，替換任何現有的值

setMultiTargetPreparer

public void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)

可在這項設定中設定單一 IMultiTargetPreparer 的便利方法。取代任何現有值

setMultiTargetPreparers

public void setMultiTargetPreparers ( multiTargPreps)

設定此設定中的 IMultiTargetPreparer 清單，取代任何現有的值

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs)

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

預期格式的ArgsOptionParser

參數
`listArgs`	：指令列引數

傳回
	未使用的引數

擲回
`ConfigurationException`

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( listArgs, 
                IKeyStoreClient keyStoreClient)

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

請前往 ArgsOptionParser 瞭解預期格式

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

傳回
	未使用的引數

擲回
`ConfigurationException`

setPostProcessors

public void setPostProcessors ( processors)

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

參數
`processors`

設定重試決策

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 清單，取代任何現有值

setTest

public void setTests ( tests)

設定此設定中的 IRemoteTest 清單，取代任何現有的值

VerifyOptions

public void validateOptions ()

驗證選項值。

目前只會用來確認是否已設定所有必要選項

擲回
`ConfigurationException`

保護方法

isRemoteEnvironment

protected boolean isRemoteEnvironment ()

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

傳回
`boolean`