I配置
public interface IConfiguration
com.android.tradefed.config.IConfiguration |
TradeFederation 呼叫的設定資訊。每個 TradeFederation 呼叫都有一個IConfiguration
。 IConfiguration
在儲存呼叫期間應使用的所有委託物件及其關聯的Option
。
概括
公共方法 | |
---|---|
abstract void | addFilesToClean ( toBeCleaned) addFilesToClean ( toBeCleaned) 新增必須在 |
abstract void | cleanConfigurationData () 刪除下載到遠端文件解析選項欄位的所有檔案。 |
abstract IConfiguration | clone () 建立該物件的淺表副本。 |
abstract void | dumpXml (PrintWriter output) 取得配置的擴充 XML 文件,其中以 |
abstract void | dumpXml (PrintWriter output, excludeFilters) dumpXml (PrintWriter output, excludeFilters) 取得配置的擴充 XML 文件,其中包含此 |
abstract void | dumpXml (PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions) dumpXml (PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions) 取得配置的擴充 XML 文件,其中包含此 |
abstract | getAllConfigurationObjectsOfType (String typeName) 用於跨裝置取得給定類型名稱的所有物件的通用介面。 |
abstract IBuildProvider | getBuildProvider () 從配置中取得 |
abstract String | getCommandLine () 取得用於建立此 |
abstract ICommandOptions | getCommandOptions () 從配置中取得要使用的 |
abstract ConfigurationDescriptor | getConfigurationDescription () 傳回配置中提供的 |
abstract Object | getConfigurationObject (String typeName) 用於取得具有給定類型名稱的配置物件的通用介面。 |
abstract | getConfigurationObjectList (String typeName) 與 |
abstract CoverageOptions | getCoverageOptions () 從配置中取得要使用的 |
abstract | getDeviceConfig () 從設定中取得 |
abstract IDeviceConfiguration | getDeviceConfigByName (String nameDevice) 傳回與提供的名稱關聯的 |
abstract TestDeviceOptions | getDeviceOptions () 從配置中取得要使用的 |
abstract IDeviceRecovery | getDeviceRecovery () 從設定中取得要使用的 |
abstract IDeviceSelection | getDeviceRequirements () 從配置中取得要使用的 |
abstract | getFilesToClean () 取得將在 |
abstract GlobalTestFilter | getGlobalFilters () 取得調用的 |
abstract | getInopOptions () 取得未更改任何值的選項名稱 |
abstract | getLabPreparers () 從配置中取得 |
abstract ILeveledLogOutput | getLogOutput () 從配置中取得要使用的 |
abstract ILogSaver | getLogSaver () 從配置中取得要使用的 |
abstract | getMetricCollectors () 從配置中取得 |
abstract | getMultiPreTargetPreparers () 從配置中取得 |
abstract | getMultiTargetPreparers () 從配置中取得 |
abstract String | getName () 傳回配置的名稱。 |
abstract | getPostProcessors () 從配置中取得 |
abstract IRetryDecision | getRetryDecision () 傳回用於呼叫的 |
abstract SkipManager | getSkipManager () 取得呼叫的 |
abstract | getSystemStatusCheckers () 從配置中取得 |
abstract | getTargetPreparers () 從配置中取得 |
abstract | getTestInvocationListeners () 從設定中取得要使用的 |
abstract | getTests () 取得要從配置運行的 |
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 ( optionDefs) injectOptionValues ( optionDefs) 將多個選項值注入到組態物件集中。 |
abstract boolean | isDeviceConfiguredFake (String deviceName) 傳回已配置設備是否標記為 isFake=true。 |
abstract IConfiguration | partialDeepClone ( objectToDeepClone, IKeyStoreClient client) partialDeepClone ( objectToDeepClone, IKeyStoreClient client) 從 |
abstract void | printCommandUsage (boolean importantOnly, PrintStream out) 將此配置的命令列使用幫助文字輸出到給定的 printStream。 |
abstract void | resolveDynamicOptions ( DynamicRemoteFileResolver resolver) 解決指向遠端位置的 |
abstract void | safeInjectOptionValues ( optionDefs) safeInjectOptionValues ( optionDefs) 將多個選項值注入到一組配置物件中,如果其中一個選項無法套用,則不會拋出異常。 |
abstract | setBestEffortOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) setBestEffortOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) 使用盡力而為的方法使用給定的一組命令列參數設定配置 |
abstract void | setBuildProvider ( IBuildProvider provider) 替換配置中目前的 |
abstract void | setCommandLine (String[] arrayArgs) 設定用於建立此 |
abstract void | setCommandOptions ( ICommandOptions cmdOptions) 設定 |
abstract void | setConfigurationObject (String name, Object configObject) 使用給定名稱設定配置物件的通用方法,替換任何現有值。 |
abstract void | setConfigurationObjectList (String name, configList) setConfigurationObjectList (String name, configList) 設定給定名稱的配置物件清單的通用方法,替換任何現有值。 |
abstract void | setCoverageOptions ( CoverageOptions coverageOptions) 設定 |
abstract void | setDeviceConfig ( IDeviceConfiguration deviceConfig) 設定 |
abstract void | setDeviceConfigList ( deviceConfigs) setDeviceConfigList ( deviceConfigs) 設定 |
abstract void | setDeviceMetricCollectors ( collectors) setDeviceMetricCollectors ( collectors) 設定 |
abstract void | setDeviceOptions ( TestDeviceOptions deviceOptions) 設定 |
abstract void | setDeviceRecovery ( IDeviceRecovery recovery) 設定 |
abstract void | setDeviceRequirements ( IDeviceSelection deviceSelection) 設定 |
abstract void | setLabPreparer ( ITargetPreparer preparer) 設定 |
abstract void | setLabPreparers ( preparers) setLabPreparers ( preparers) 設定 |
abstract void | setLogOutput ( ILeveledLogOutput logger) 設定 |
abstract void | setLogSaver ( ILogSaver logSaver) 設定 |
abstract void | setMultiPreTargetPreparer ( IMultiTargetPreparer multiPreTargPreps) 在此配置中設定單一 |
abstract void | setMultiPreTargetPreparers ( multiPreTargPreps) setMultiPreTargetPreparers ( multiPreTargPreps) 設定此配置中的 |
abstract void | setMultiTargetPreparer ( IMultiTargetPreparer multiTargPrep) 在此配置中設定單一 |
abstract void | setMultiTargetPreparers ( multiTargPreps) setMultiTargetPreparers ( multiTargPreps) 在此配置中設定 |
abstract | setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs) 使用給定的一組命令列參數設定配置 ArgsOptionParser 用於預期格式 |
abstract | setOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) setOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) 使用給定的一組命令列參數設定配置 ArgsOptionParser 以了解預期格式 |
abstract void | setPostProcessors ( processors) setPostProcessors ( processors) 設定 |
abstract void | setRetryDecision ( IRetryDecision decisionRetry) 設定 |
abstract void | setSystemStatusChecker ( ISystemStatusChecker systemChecker) 在此配置中設定單一 |
abstract void | setSystemStatusCheckers ( systemCheckers) setSystemStatusCheckers ( systemCheckers) 在此配置中設定 |
abstract void | setTargetPreparer ( ITargetPreparer preparer) 設定 |
abstract void | setTargetPreparers ( preparers) setTargetPreparers ( preparers) 設定 |
abstract void | setTest ( IRemoteTest test) 在此配置中設定單一 |
abstract void | setTestInvocationListener ( ITestInvocationListener listener) 設定單一 |
abstract void | setTestInvocationListeners ( listeners) setTestInvocationListeners ( listeners) 設定 |
abstract void | setTests ( tests) setTests ( tests) 設定此配置中的 |
abstract void | validateOptions () 驗證選項值。 |
公共方法
新增要清理的文件
public abstract void addFilesToClean (toBeCleaned)
新增必須在cleanConfigurationData()
期間清理的文件
參數 | |
---|---|
toBeCleaned |
清理配置數據
public abstract void cleanConfigurationData ()
刪除下載到遠端文件解析選項欄位的所有檔案。
轉儲Xml
public abstract void dumpXml (PrintWriter output)
取得配置的擴充 XML 文件,其中以String
顯示此IConfiguration
的所有選項。
參數 | |
---|---|
output | PrintWriter :列印 xml 的編寫器。 |
投擲 | |
---|---|
| IO異常 |
轉儲Xml
public abstract void dumpXml (PrintWriter output,excludeFilters)
取得配置的擴充 XML 文件,其中包含此IConfiguration
顯示的所有選項,減去按鍵名稱篩選的物件。
過濾器範例: Configuration#TARGET_PREPARER_TYPE_NAME
。
參數 | |
---|---|
output | PrintWriter :列印 xml 的編寫器。 |
excludeFilters |
投擲 | |
---|---|
| IO異常 |
轉儲Xml
public abstract void dumpXml (PrintWriter output,excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)
取得配置的擴充 XML 文件,其中包含此IConfiguration
顯示的所有選項,減去按鍵名稱篩選的物件。
過濾器範例: Configuration#TARGET_PREPARER_TYPE_NAME
。
參數 | |
---|---|
output | PrintWriter :列印 xml 的編寫器。 |
excludeFilters | |
printDeprecatedOptions | boolean : 是否會列印標記為已棄用的選項 |
printUnchangedOptions | boolean |
投擲 | |
---|---|
| IO異常 |
取得所有配置物件類型
public abstractgetAllConfigurationObjectsOfType (String typeName)
用於跨裝置取得給定類型名稱的所有物件的通用介面。
參數 | |
---|---|
typeName | String : 配置物件的唯一類型 |
退貨 | |
---|---|
給定類型的配置物件的清單。 |
取得建置提供者
public abstract IBuildProvider getBuildProvider ()
從配置中取得IBuildProvider
。
退貨 | |
---|---|
IBuildProvider | 配置中提供的IBuildProvider |
取得命令列
public abstract String getCommandLine ()
取得用於建立此IConfiguration
命令列。
退貨 | |
---|---|
String | 用於建立此IConfiguration 命令列。 |
取得命令選項
public abstract ICommandOptions getCommandOptions ()
從配置中取得要使用的ICommandOptions
。
退貨 | |
---|---|
ICommandOptions | 配置中提供的ICommandOptions 。 |
取得配置描述
public abstract ConfigurationDescriptor getConfigurationDescription ()
傳回配置中提供的ConfigurationDescriptor
。
退貨 | |
---|---|
ConfigurationDescriptor |
取得配置對象
public abstract Object getConfigurationObject (String typeName)
用於取得具有給定類型名稱的配置物件的通用介面。
參數 | |
---|---|
typeName | String : 配置物件的唯一類型 |
退貨 | |
---|---|
Object | 配置對象,如果給定名稱的對象類型不存在,則null 。 |
取得配置對象列表
public abstractgetConfigurationObjectList (String typeName)
與getConfigurationObject(String)
類似,但適用於支援多個物件的配置物件類型。
參數 | |
---|---|
typeName | String : 配置物件的唯一類型名稱 |
退貨 | |
---|---|
配置物件列表,如果給定名稱的物件類型不存在,則null 。 |
取得覆蓋選項
public abstract CoverageOptions getCoverageOptions ()
從配置中取得要使用的CoverageOptions
。
退貨 | |
---|---|
CoverageOptions | 配置中提供的CoverageOptions 。 |
取得設備配置按名稱
public abstract IDeviceConfiguration getDeviceConfigByName (String nameDevice)
傳回與提供的名稱關聯的IDeviceConfiguration
,如果找不到則傳回 null。
參數 | |
---|---|
nameDevice | String |
退貨 | |
---|---|
IDeviceConfiguration |
取得設備選項
public abstract TestDeviceOptions getDeviceOptions ()
從配置中取得要使用的TestDeviceOptions
。
退貨 | |
---|---|
TestDeviceOptions | 配置中提供的TestDeviceOptions 。 |
取得設備恢復
public abstract IDeviceRecovery getDeviceRecovery ()
從設定中取得要使用的IDeviceRecovery
。
退貨 | |
---|---|
IDeviceRecovery | 配置中提供的IDeviceRecovery 。 |
取得設備需求
public abstract IDeviceSelection getDeviceRequirements ()
從配置中取得要使用的IDeviceSelection
。
退貨 | |
---|---|
IDeviceSelection | 配置中提供的IDeviceSelection 。 |
取得全域過濾器
public abstract GlobalTestFilter getGlobalFilters ()
取得調用的GlobalTestFilter
。
退貨 | |
---|---|
GlobalTestFilter |
取得InopOptions
public abstractgetInopOptions ()
取得未更改任何值的選項名稱
退貨 | |
---|---|
取得日誌輸出
public abstract ILeveledLogOutput getLogOutput ()
從配置中取得要使用的ILeveledLogOutput
。
退貨 | |
---|---|
ILeveledLogOutput | 配置中提供的ILeveledLogOutput 。 |
getMultiPreTargetPreparers
public abstractgetMultiPreTargetPreparers ()
從配置中取得IMultiTargetPreparer
,該配置應在任何設備 target_preparers 之前執行。
退貨 | |
---|---|
在配置中依序提供的IMultiTargetPreparer |
取得多目標準備器
public abstractgetMultiTargetPreparers ()
從配置中取得IMultiTargetPreparer
。
退貨 | |
---|---|
在配置中依序提供的IMultiTargetPreparer |
取得名稱
public abstract String getName ()
傳回配置的名稱。
退貨 | |
---|---|
String |
取得系統狀態檢查器
public abstractgetSystemStatusCheckers ()
從配置中取得ISystemStatusChecker
。
退貨 | |
---|---|
配置中依序提供的ISystemStatusChecker |
取得測試調用監聽器
public abstractgetTestInvocationListeners ()
從設定中取得要使用的ITestInvocationListener
。
退貨 | |
---|---|
配置中提供的ITestInvocationListener 。 |
注入選項值
public abstract void injectOptionValue (String optionName, String optionValue)
將選項值注入到配置物件集中。
對於為動態產生的選項提供值很有用。參數 | |
---|---|
optionName | String : 選項名稱 |
optionValue | String : 選項值 |
投擲 | |
---|---|
ConfigurationException | 如果未能設定選項的值 |
注入選項值
public abstract void injectOptionValue (String optionName, String optionKey, String optionValue)
將選項值注入到配置物件集中。
對於為動態產生的選項提供值很有用。參數 | |
---|---|
optionName | String : 選項名稱 |
optionKey | String : 地圖選項的可選鍵,或 null |
optionValue | String : 地圖選項值 |
投擲 | |
---|---|
ConfigurationException | 如果未能設定選項的值 |
注入選項值與來源
public abstract void injectOptionValueWithSource (String optionName, String optionKey, String optionValue, String optionSource)
將選項值注入到配置物件集中。
對於為動態產生的選項提供值很有用。參數 | |
---|---|
optionName | String : 選項名稱 |
optionKey | String : 地圖選項的可選鍵,或 null |
optionValue | String : 地圖選項值 |
optionSource | String :提供此選項值的來源配置 |
投擲 | |
---|---|
ConfigurationException | 如果未能設定選項的值 |
注入選項值
public abstract void injectOptionValues (optionDefs)
將多個選項值注入到組態物件集中。
在建立新物件後一次注入多個選項值非常有用。參數 | |
---|---|
optionDefs |
投擲 | |
---|---|
ConfigurationException | 如果設定選項值失敗 |
isDeviceConfiguredFake
public abstract boolean isDeviceConfiguredFake (String deviceName)
傳回已配置設備是否標記為 isFake=true。
參數 | |
---|---|
deviceName | String |
退貨 | |
---|---|
boolean |
部分深克隆
public abstract IConfiguration partialDeepClone (objectToDeepClone, IKeyStoreClient client)
從clone()
建立一個基本克隆,然後深度克隆給定配置物件的清單。
參數 | |
---|---|
objectToDeepClone | |
client | IKeyStoreClient :金鑰庫客戶端。 |
退貨 | |
---|---|
IConfiguration | 部分深度克隆的配置。 |
投擲 | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
列印命令用法
public abstract void printCommandUsage (boolean importantOnly, PrintStream out)
將此配置的命令列使用幫助文字輸出到給定的 printStream。
參數 | |
---|---|
importantOnly | boolean :如果為true 則只列印重要選項的協助 |
out | PrintStream :要使用的ERROR(/PrintStream) 。 |
投擲 | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
解析動態選項
public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)
解決指向遠端位置的ERROR(/File)
選項。這需要呼叫cleanConfigurationData()
來清理檔案。
參數 | |
---|---|
resolver | DynamicRemoteFileResolver :解析檔案的DynamicRemoteFileResolver |
投擲 | |
---|---|
| com.android.tradefed.build.BuildRetrievalError |
| com.android.tradefed.config.ConfigurationException |
BuildRetrievalError | |
ConfigurationException |
安全注入選項值
public abstract void safeInjectOptionValues (optionDefs)
將多個選項值注入到一組配置物件中,如果其中一個選項無法套用,則不會拋出異常。
在建立新物件後一次注入多個選項值非常有用。
參數 | |
---|---|
optionDefs |
投擲 | |
---|---|
ConfigurationException | 如果建立OptionSetter 失敗 |
setBestEffortOptionsFromCommandLineArgs
public abstractsetBestEffortOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient)
使用盡力而為的方法使用給定的一組命令列參數設定配置Option
欄位。
請參閱ArgsOptionParser
以了解預期格式
參數 | |
---|---|
listArgs | |
keyStoreClient | IKeyStoreClient :要使用的IKeyStoreClient 。 |
退貨 | |
---|---|
未消耗的參數 |
投擲 | |
---|---|
ConfigurationException |
設定建置提供者
public abstract void setBuildProvider (IBuildProvider provider)
替換配置中目前的IBuildProvider
。
參數 | |
---|---|
provider | IBuildProvider :新的IBuildProvider |
設定命令列
public abstract void setCommandLine (String[] arrayArgs)
設定用於建立此IConfiguration
命令列。與 setOptionsFromCommandLineArgs 不同,它儲存整個命令行,包括配置名稱。
參數 | |
---|---|
arrayArgs | String :命令列 |
設定命令選項
public abstract void setCommandOptions (ICommandOptions cmdOptions)
設定ICommandOptions
,替換任何現有值
設定配置對象
public abstract void setConfigurationObject (String name, Object configObject)
使用給定名稱設定配置物件的通用方法,替換任何現有值。
參數 | |
---|---|
name | String :配置物件類型的唯一名稱。 |
configObject | Object :配置對象 |
投擲 | |
---|---|
ConfigurationException | 如果 configObject 的類型不正確 |
設定配置對象列表
public abstract void setConfigurationObjectList (String name,configList)
設定給定名稱的配置物件清單的通用方法,替換任何現有值。
參數 | |
---|---|
name | String :配置物件類型的唯一名稱。 |
configList |
投擲 | |
---|---|
ConfigurationException | 如果清單中的任何物件不是正確的類型 |
設定覆蓋選項
public abstract void setCoverageOptions (CoverageOptions coverageOptions)
設定CoverageOptions
,替換任何現有值。
參數 | |
---|---|
coverageOptions | CoverageOptions |
設定設備配置
public abstract void setDeviceConfig (IDeviceConfiguration deviceConfig)
設定IDeviceConfiguration
,取代任何現有值。
設定設備指標收集器
public abstract void setDeviceMetricCollectors (collectors)
設定IMetricCollector
列表,取代任何現有值。
參數 | |
---|---|
collectors |
設定設備選項
public abstract void setDeviceOptions (TestDeviceOptions deviceOptions)
設定TestDeviceOptions
,替換任何現有值
參數 | |
---|---|
deviceOptions | TestDeviceOptions |
設定設備要求
public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)
設定IDeviceSelection
,替換任何現有值
setMultiPreTargetPreparer
public abstract void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPreps)
在此配置中設定單一IMultiTargetPreparer
便利方法,該方法應在任何裝置 target_preparers 之前執行,取代任何現有值
setMultiPreTargetPreparers
public abstract void setMultiPreTargetPreparers (multiPreTargPreps)
設定此配置中的IMultiTargetPreparer
列表,該列表應在任何裝置 target_preparers 之前執行,取代任何現有值
設定多目標準備器
public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)
在此配置中設定單一IMultiTargetPreparer
便捷方法,取代任何現有值
設定多目標準備器
public abstract void setMultiTargetPreparers (multiTargPreps)
在此配置中設定IMultiTargetPreparer
列表,取代任何現有值
setOptionsFromCommandLineArgs
public abstractsetOptionsFromCommandLineArgs ( listArgs)
使用給定的一組命令列參數設定配置Option
字段
ArgsOptionParser
用於預期格式參數 | |
---|---|
listArgs |
退貨 | |
---|---|
未消耗的參數 |
投擲 | |
---|---|
ConfigurationException |
setOptionsFromCommandLineArgs
public abstractsetOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient)
使用給定的一組命令列參數設定配置Option
字段
ArgsOptionParser
以了解預期格式參數 | |
---|---|
listArgs | |
keyStoreClient | IKeyStoreClient :要使用的IKeyStoreClient 。 |
退貨 | |
---|---|
未消耗的參數 |
投擲 | |
---|---|
ConfigurationException |
設定重試決策
public abstract void setRetryDecision (IRetryDecision decisionRetry)
設定IRetryDecision
,替換任何現有值。
設定係統狀態檢查器
public abstract void setSystemStatusChecker (ISystemStatusChecker systemChecker)
在此配置中設定單一ISystemStatusChecker
便捷方法,取代任何現有值
設定係統狀態檢查器
public abstract void setSystemStatusCheckers (systemCheckers)
在此配置中設定ISystemStatusChecker
列表,取代任何現有值
設定目標準備器
public abstract void setTargetPreparer (ITargetPreparer preparer)
設定ITargetPreparer
,替換任何現有值。
設定測試調用監聽器
public abstract void setTestInvocationListener (ITestInvocationListener listener)
設定單一ITestInvocationListener
便捷方法
設定測試調用監聽器
public abstract void setTestInvocationListeners (listeners)
設定ITestInvocationListener
列表,取代任何現有值
I配置
public interface IConfiguration
com.android.tradefed.config.IConfiguration |
TradeFederation 呼叫的設定資訊。每個 TradeFederation 呼叫都有一個IConfiguration
。 IConfiguration
在儲存呼叫期間應使用的所有委託物件及其關聯的Option
。
概括
公共方法 | |
---|---|
abstract void | addFilesToClean ( toBeCleaned) addFilesToClean ( toBeCleaned) 新增必須在 |
abstract void | cleanConfigurationData () 刪除下載到遠端文件解析選項欄位的所有檔案。 |
abstract IConfiguration | clone () 建立該物件的淺表副本。 |
abstract void | dumpXml (PrintWriter output) 取得配置的擴充 XML 文件,其中以 |
abstract void | dumpXml (PrintWriter output, excludeFilters) dumpXml (PrintWriter output, excludeFilters) 取得配置的擴充 XML 文件,其中包含此 |
abstract void | dumpXml (PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions) dumpXml (PrintWriter output, excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions) 取得配置的擴充 XML 文件,其中包含此 |
abstract | getAllConfigurationObjectsOfType (String typeName) 用於跨裝置取得給定類型名稱的所有物件的通用介面。 |
abstract IBuildProvider | getBuildProvider () 從配置中取得 |
abstract String | getCommandLine () 取得用於建立此 |
abstract ICommandOptions | getCommandOptions () 從配置中取得要使用的 |
abstract ConfigurationDescriptor | getConfigurationDescription () 傳回配置中提供的 |
abstract Object | getConfigurationObject (String typeName) 用於取得具有給定類型名稱的配置物件的通用介面。 |
abstract | getConfigurationObjectList (String typeName) 與 |
abstract CoverageOptions | getCoverageOptions () 從配置中取得要使用的 |
abstract | getDeviceConfig () 從設定中取得 |
abstract IDeviceConfiguration | getDeviceConfigByName (String nameDevice) 傳回與提供的名稱關聯的 |
abstract TestDeviceOptions | getDeviceOptions () 從配置中取得要使用的 |
abstract IDeviceRecovery | getDeviceRecovery () 從設定中取得要使用的 |
abstract IDeviceSelection | getDeviceRequirements () 從配置中取得要使用的 |
abstract | getFilesToClean () 取得將在 |
abstract GlobalTestFilter | getGlobalFilters () 取得調用的 |
abstract | getInopOptions () 取得未更改任何值的選項名稱 |
abstract | getLabPreparers () 從配置中取得 |
abstract ILeveledLogOutput | getLogOutput () 從配置中取得要使用的 |
abstract ILogSaver | getLogSaver () 從配置中取得要使用的 |
abstract | getMetricCollectors () 從配置中取得 |
abstract | getMultiPreTargetPreparers () 從配置中取得 |
abstract | getMultiTargetPreparers () 從配置中取得 |
abstract String | getName () 傳回配置的名稱。 |
abstract | getPostProcessors () 從配置中取得 |
abstract IRetryDecision | getRetryDecision () 傳回用於呼叫的 |
abstract SkipManager | getSkipManager () 取得呼叫的 |
abstract | getSystemStatusCheckers () 從配置中取得 |
abstract | getTargetPreparers () 從配置中取得 |
abstract | getTestInvocationListeners () 從設定中取得要使用的 |
abstract | getTests () 取得要從配置運行的 |
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 ( optionDefs) injectOptionValues ( optionDefs) 將多個選項值注入到組態物件集中。 |
abstract boolean | isDeviceConfiguredFake (String deviceName) 傳回已配置設備是否標記為 isFake=true。 |
abstract IConfiguration | partialDeepClone ( objectToDeepClone, IKeyStoreClient client) partialDeepClone ( objectToDeepClone, IKeyStoreClient client) 從 |
abstract void | printCommandUsage (boolean importantOnly, PrintStream out) 將此配置的命令列使用幫助文字輸出到給定的 printStream。 |
abstract void | resolveDynamicOptions ( DynamicRemoteFileResolver resolver) 解決指向遠端位置的 |
abstract void | safeInjectOptionValues ( optionDefs) safeInjectOptionValues ( optionDefs) 將多個選項值注入到一組配置物件中,如果其中一個選項無法套用,則不會拋出異常。 |
abstract | setBestEffortOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) setBestEffortOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) 使用盡力而為的方法使用給定的一組命令列參數設定配置 |
abstract void | setBuildProvider ( IBuildProvider provider) 替換配置中目前的 |
abstract void | setCommandLine (String[] arrayArgs) 設定用於建立此 |
abstract void | setCommandOptions ( ICommandOptions cmdOptions) 設定 |
abstract void | setConfigurationObject (String name, Object configObject) 使用給定名稱設定配置物件的通用方法,替換任何現有值。 |
abstract void | setConfigurationObjectList (String name, configList) setConfigurationObjectList (String name, configList) 設定給定名稱的配置物件清單的通用方法,替換任何現有值。 |
abstract void | setCoverageOptions ( CoverageOptions coverageOptions) 設定 |
abstract void | setDeviceConfig ( IDeviceConfiguration deviceConfig) 設定 |
abstract void | setDeviceConfigList ( deviceConfigs) setDeviceConfigList ( deviceConfigs) 設定 |
abstract void | setDeviceMetricCollectors ( collectors) setDeviceMetricCollectors ( collectors) 設定 |
abstract void | setDeviceOptions ( TestDeviceOptions deviceOptions) 設定 |
abstract void | setDeviceRecovery ( IDeviceRecovery recovery) 設定 |
abstract void | setDeviceRequirements ( IDeviceSelection deviceSelection) 設定 |
abstract void | setLabPreparer ( ITargetPreparer preparer) 設定 |
abstract void | setLabPreparers ( preparers) setLabPreparers ( preparers) 設定 |
abstract void | setLogOutput ( ILeveledLogOutput logger) 設定 |
abstract void | setLogSaver ( ILogSaver logSaver) 設定 |
abstract void | setMultiPreTargetPreparer ( IMultiTargetPreparer multiPreTargPreps) 在此配置中設定單一 |
abstract void | setMultiPreTargetPreparers ( multiPreTargPreps) setMultiPreTargetPreparers ( multiPreTargPreps) 設定此配置中的 |
abstract void | setMultiTargetPreparer ( IMultiTargetPreparer multiTargPrep) 在此配置中設定單一 |
abstract void | setMultiTargetPreparers ( multiTargPreps) setMultiTargetPreparers ( multiTargPreps) 在此配置中設定 |
abstract | setOptionsFromCommandLineArgs ( listArgs) setOptionsFromCommandLineArgs ( listArgs) 使用給定的一組命令列參數設定配置 ArgsOptionParser 用於預期格式 |
abstract | setOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) setOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient) 使用給定的一組命令列參數設定配置 ArgsOptionParser 以了解預期格式 |
abstract void | setPostProcessors ( processors) setPostProcessors ( processors) 設定 |
abstract void | setRetryDecision ( IRetryDecision decisionRetry) 設定 |
abstract void | setSystemStatusChecker ( ISystemStatusChecker systemChecker) 在此配置中設定單一 |
abstract void | setSystemStatusCheckers ( systemCheckers) setSystemStatusCheckers ( systemCheckers) 在此配置中設定 |
abstract void | setTargetPreparer ( ITargetPreparer preparer) 設定 |
abstract void | setTargetPreparers ( preparers) setTargetPreparers ( preparers) 設定 |
abstract void | setTest ( IRemoteTest test) 在此配置中設定單一 |
abstract void | setTestInvocationListener ( ITestInvocationListener listener) 設定單一 |
abstract void | setTestInvocationListeners ( listeners) setTestInvocationListeners ( listeners) 設定 |
abstract void | setTests ( tests) setTests ( tests) 設定此配置中的 |
abstract void | validateOptions () 驗證選項值。 |
公共方法
新增要清理的文件
public abstract void addFilesToClean (toBeCleaned)
新增必須在cleanConfigurationData()
期間清理的文件
參數 | |
---|---|
toBeCleaned |
清理配置數據
public abstract void cleanConfigurationData ()
刪除下載到遠端文件解析選項欄位的所有檔案。
轉儲Xml
public abstract void dumpXml (PrintWriter output)
取得配置的擴充 XML 文件,其中以String
顯示此IConfiguration
的所有選項。
參數 | |
---|---|
output | PrintWriter :列印 xml 的編寫器。 |
投擲 | |
---|---|
| IO異常 |
轉儲Xml
public abstract void dumpXml (PrintWriter output,excludeFilters)
取得配置的擴充 XML 文件,其中包含此IConfiguration
顯示的所有選項,減去按鍵名稱篩選的物件。
過濾器範例: Configuration#TARGET_PREPARER_TYPE_NAME
。
參數 | |
---|---|
output | PrintWriter :列印 xml 的編寫器。 |
excludeFilters |
投擲 | |
---|---|
| IO異常 |
轉儲Xml
public abstract void dumpXml (PrintWriter output,excludeFilters, boolean printDeprecatedOptions, boolean printUnchangedOptions)
取得配置的擴充 XML 文件,其中包含此IConfiguration
顯示的所有選項,減去按鍵名稱篩選的物件。
過濾器範例: Configuration#TARGET_PREPARER_TYPE_NAME
。
參數 | |
---|---|
output | PrintWriter :列印 xml 的編寫器。 |
excludeFilters | |
printDeprecatedOptions | boolean : 是否會列印標記為已棄用的選項 |
printUnchangedOptions | boolean |
投擲 | |
---|---|
| IO異常 |
取得所有配置物件類型
public abstractgetAllConfigurationObjectsOfType (String typeName)
用於跨裝置取得給定類型名稱的所有物件的通用介面。
參數 | |
---|---|
typeName | String : 配置物件的唯一類型 |
退貨 | |
---|---|
給定類型的配置物件的清單。 |
取得建置提供者
public abstract IBuildProvider getBuildProvider ()
從配置中取得IBuildProvider
。
退貨 | |
---|---|
IBuildProvider | 配置中提供的IBuildProvider |
取得命令列
public abstract String getCommandLine ()
取得用於建立此IConfiguration
命令列。
退貨 | |
---|---|
String | 用於建立此IConfiguration 命令列。 |
取得命令選項
public abstract ICommandOptions getCommandOptions ()
從配置中取得要使用的ICommandOptions
。
退貨 | |
---|---|
ICommandOptions | 配置中提供的ICommandOptions 。 |
取得配置描述
public abstract ConfigurationDescriptor getConfigurationDescription ()
傳回配置中提供的ConfigurationDescriptor
。
退貨 | |
---|---|
ConfigurationDescriptor |
取得配置對象
public abstract Object getConfigurationObject (String typeName)
用於取得具有給定類型名稱的配置物件的通用介面。
參數 | |
---|---|
typeName | String : 配置物件的唯一類型 |
退貨 | |
---|---|
Object | 配置對象,如果給定名稱的對象類型不存在,則null 。 |
取得配置對象列表
public abstractgetConfigurationObjectList (String typeName)
與getConfigurationObject(String)
類似,但適用於支援多個物件的配置物件類型。
參數 | |
---|---|
typeName | String : 配置物件的唯一類型名稱 |
退貨 | |
---|---|
配置物件列表,如果給定名稱的物件類型不存在,則null 。 |
取得覆蓋選項
public abstract CoverageOptions getCoverageOptions ()
從配置中取得要使用的CoverageOptions
。
退貨 | |
---|---|
CoverageOptions | 配置中提供的CoverageOptions 。 |
取得設備配置按名稱
public abstract IDeviceConfiguration getDeviceConfigByName (String nameDevice)
傳回與提供的名稱關聯的IDeviceConfiguration
,如果找不到則傳回 null。
參數 | |
---|---|
nameDevice | String |
退貨 | |
---|---|
IDeviceConfiguration |
取得設備選項
public abstract TestDeviceOptions getDeviceOptions ()
從配置中取得要使用的TestDeviceOptions
。
退貨 | |
---|---|
TestDeviceOptions | 配置中提供的TestDeviceOptions 。 |
取得設備恢復
public abstract IDeviceRecovery getDeviceRecovery ()
從設定中取得要使用的IDeviceRecovery
。
退貨 | |
---|---|
IDeviceRecovery | 配置中提供的IDeviceRecovery 。 |
取得設備需求
public abstract IDeviceSelection getDeviceRequirements ()
從配置中取得要使用的IDeviceSelection
。
退貨 | |
---|---|
IDeviceSelection | 配置中提供的IDeviceSelection 。 |
取得全域過濾器
public abstract GlobalTestFilter getGlobalFilters ()
取得調用的GlobalTestFilter
。
退貨 | |
---|---|
GlobalTestFilter |
取得InopOptions
public abstractgetInopOptions ()
取得未更改任何值的選項名稱
退貨 | |
---|---|
取得日誌輸出
public abstract ILeveledLogOutput getLogOutput ()
從配置中取得要使用的ILeveledLogOutput
。
退貨 | |
---|---|
ILeveledLogOutput | 配置中提供的ILeveledLogOutput 。 |
getMultiPreTargetPreparers
public abstractgetMultiPreTargetPreparers ()
從配置中取得IMultiTargetPreparer
,該配置應在任何設備 target_preparers 之前執行。
退貨 | |
---|---|
在配置中依序提供的IMultiTargetPreparer |
取得多目標準備器
public abstractgetMultiTargetPreparers ()
從配置中取得IMultiTargetPreparer
。
退貨 | |
---|---|
在配置中依序提供的IMultiTargetPreparer |
取得名稱
public abstract String getName ()
傳回配置的名稱。
退貨 | |
---|---|
String |
取得系統狀態檢查器
public abstractgetSystemStatusCheckers ()
從配置中取得ISystemStatusChecker
。
退貨 | |
---|---|
配置中依序提供的ISystemStatusChecker |
取得測試調用監聽器
public abstractgetTestInvocationListeners ()
從設定中取得要使用的ITestInvocationListener
。
退貨 | |
---|---|
配置中提供的ITestInvocationListener 。 |
注入選項值
public abstract void injectOptionValue (String optionName, String optionValue)
將選項值注入到配置物件集中。
對於為動態產生的選項提供值很有用。參數 | |
---|---|
optionName | String : 選項名稱 |
optionValue | String : 選項值 |
投擲 | |
---|---|
ConfigurationException | 如果未能設定選項的值 |
注入選項值
public abstract void injectOptionValue (String optionName, String optionKey, String optionValue)
將選項值注入到配置物件集中。
對於為動態產生的選項提供值很有用。參數 | |
---|---|
optionName | String : 選項名稱 |
optionKey | String : 地圖選項的可選鍵,或 null |
optionValue | String : 地圖選項值 |
投擲 | |
---|---|
ConfigurationException | 如果未能設定選項的值 |
注入選項值與來源
public abstract void injectOptionValueWithSource (String optionName, String optionKey, String optionValue, String optionSource)
將選項值注入到配置物件集中。
對於為動態產生的選項提供值很有用。參數 | |
---|---|
optionName | String : 選項名稱 |
optionKey | String : 地圖選項的可選鍵,或 null |
optionValue | String : 地圖選項值 |
optionSource | String :提供此選項值的來源配置 |
投擲 | |
---|---|
ConfigurationException | 如果未能設定選項的值 |
注入選項值
public abstract void injectOptionValues (optionDefs)
將多個選項值注入到組態物件集中。
在建立新物件後一次注入多個選項值非常有用。參數 | |
---|---|
optionDefs |
投擲 | |
---|---|
ConfigurationException | 如果設定選項值失敗 |
isDeviceConfiguredFake
public abstract boolean isDeviceConfiguredFake (String deviceName)
傳回已配置設備是否標記為 isFake=true。
參數 | |
---|---|
deviceName | String |
退貨 | |
---|---|
boolean |
部分深克隆
public abstract IConfiguration partialDeepClone (objectToDeepClone, IKeyStoreClient client)
從clone()
建立一個基本克隆,然後深度克隆給定配置物件的清單。
參數 | |
---|---|
objectToDeepClone | |
client | IKeyStoreClient :金鑰庫客戶端。 |
退貨 | |
---|---|
IConfiguration | 部分深度克隆的配置。 |
投擲 | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
列印命令用法
public abstract void printCommandUsage (boolean importantOnly, PrintStream out)
將此配置的命令列使用幫助文字輸出到給定的 printStream。
參數 | |
---|---|
importantOnly | boolean :如果為true 則只列印重要選項的協助 |
out | PrintStream :要使用的ERROR(/PrintStream) 。 |
投擲 | |
---|---|
| com.android.tradefed.config.ConfigurationException |
ConfigurationException |
解析動態選項
public abstract void resolveDynamicOptions (DynamicRemoteFileResolver resolver)
解決指向遠端位置的ERROR(/File)
選項。這需要呼叫cleanConfigurationData()
來清理檔案。
參數 | |
---|---|
resolver | DynamicRemoteFileResolver :解析檔案的DynamicRemoteFileResolver |
投擲 | |
---|---|
| com.android.tradefed.build.BuildRetrievalError |
| com.android.tradefed.config.ConfigurationException |
BuildRetrievalError | |
ConfigurationException |
安全注入選項值
public abstract void safeInjectOptionValues (optionDefs)
將多個選項值注入到一組配置物件中,如果其中一個選項無法套用,則不會拋出異常。
在建立新物件後一次注入多個選項值非常有用。
參數 | |
---|---|
optionDefs |
投擲 | |
---|---|
ConfigurationException | 如果建立OptionSetter 失敗 |
setBestEffortOptionsFromCommandLineArgs
public abstractsetBestEffortOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient)
使用盡力而為的方法使用給定的一組命令列參數設定配置Option
欄位。
請參閱ArgsOptionParser
以了解預期格式
參數 | |
---|---|
listArgs | |
keyStoreClient | IKeyStoreClient :要使用的IKeyStoreClient 。 |
退貨 | |
---|---|
未消耗的參數 |
投擲 | |
---|---|
ConfigurationException |
設定建置提供者
public abstract void setBuildProvider (IBuildProvider provider)
替換配置中目前的IBuildProvider
。
參數 | |
---|---|
provider | IBuildProvider :新的IBuildProvider |
設定命令列
public abstract void setCommandLine (String[] arrayArgs)
設定用於建立此IConfiguration
命令列。與 setOptionsFromCommandLineArgs 不同,它儲存整個命令行,包括配置名稱。
參數 | |
---|---|
arrayArgs | String :命令列 |
設定命令選項
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,configList)
為給定名稱設定配置物件清單的通用方法,替換任何現有值。
參數 | |
---|---|
name | String :配置物件類型的唯一名稱。 |
configList |
投擲 | |
---|---|
ConfigurationException | 如果清單中的任何物件不是正確的類型 |
setCoverageOptions
public abstract void setCoverageOptions (CoverageOptions coverageOptions)
設定CoverageOptions
,替換任何現有值。
參數 | |
---|---|
coverageOptions | CoverageOptions |
setDeviceConfig
public abstract void setDeviceConfig (IDeviceConfiguration deviceConfig)
設定一個IDeviceConfiguration
,以取代任何現有值。
setDeviceConfiglist
public abstract void setDeviceConfigList (deviceConfigs)
設定IDeviceConfiguration
s,取代任何現有值。
setDeviceMetricCollectors
public abstract void setDeviceMetricCollectors (collectors)
設定IMetricCollector
s的列表,取代任何現有值。
參數 | |
---|---|
collectors |
setdeviceoptions
public abstract void setDeviceOptions (TestDeviceOptions deviceOptions)
設定TestDeviceOptions
,替換任何現有值
參數 | |
---|---|
deviceOptions | TestDeviceOptions |
setDevicErecovery
public abstract void setDeviceRecovery (IDeviceRecovery recovery)
設定IDeviceRecovery
,取代任何現有值。
setDevicreequirentess
public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)
設定IDeviceSelection
,取代任何現有值
setLabpreparer
public abstract void setLabPreparer (ITargetPreparer preparer)
設定ITargetPreparer
,取代任何現有值。
setLogOutput
public abstract void setLogOutput (ILeveledLogOutput logger)
設定ILeveledLogOutput
,替換任何現有值。
setMultipretargetPreparer
public abstract void setMultiPreTargetPreparer (IMultiTargetPreparer multiPreTargPreps)
在此配置中設定單一IMultiTargetPreparer
便利方法,該配置應在任何裝置target_preparers之前執行,取代任何現有值
setMultipretargetPreparers
public abstract void setMultiPreTargetPreparers (multiPreTargPreps)
在此配置中設定IMultiTargetPreparer
s的列表,該配置應在任何設備target_preparers之前執行,以取代任何現有值
setmultitargetPreparer
public abstract void setMultiTargetPreparer (IMultiTargetPreparer multiTargPrep)
在此配置中設定單一IMultiTargetPreparer
便利方法,取代任何現有值
setmultitargetPreparers
public abstract void setMultiTargetPreparers (multiTargPreps)
在此配置中設定IMultiTargetPreparer
s的列表,取代任何現有值
setOptions thromcommandlineargs
public abstractsetOptionsFromCommandLineArgs ( listArgs)
設定帶有給定命令列參數集的配置Option
字段
ArgsOptionParser
參數 | |
---|---|
listArgs |
退貨 | |
---|---|
無需耗時的論點 |
投擲 | |
---|---|
ConfigurationException |
setOptions thromcommandlineargs
public abstractsetOptionsFromCommandLineArgs ( listArgs, IKeyStoreClient keyStoreClient)
設定帶有給定命令列參數集的配置Option
字段
ArgsOptionParser
參數 | |
---|---|
listArgs | |
keyStoreClient | IKeyStoreClient :使用IKeyStoreClient 。 |
退貨 | |
---|---|
無需耗時的論點 |
投擲 | |
---|---|
ConfigurationException |
SetPost Processors
public abstract void setPostProcessors (processors)
設定IPostProcessor
s的列表,取代所有現有值。
參數 | |
---|---|
processors |
setRetryDecision
public abstract void setRetryDecision (IRetryDecision decisionRetry)
設定IRetryDecision
,取代任何現有值。
setSystemStatuschecker
public abstract void setSystemStatusChecker (ISystemStatusChecker systemChecker)
在此配置中設定單一ISystemStatusChecker
便利方法,取代任何現有值
setSystemStatuscheckers
public abstract void setSystemStatusCheckers (systemCheckers)
在此配置中設定ISystemStatusChecker
s的列表,取代任何現有值
SettargetPreparer
public abstract void setTargetPreparer (ITargetPreparer preparer)
設定ITargetPreparer
,取代任何現有值。
SettargetPreparers
public abstract void setTargetPreparers (preparers)
設定ITargetPreparer
s的列表,取代任何現有值。
SettEstInvocationListener
public abstract void setTestInvocationListener (ITestInvocationListener listener)
設定單一ITestInvocationListener
便利方法
SettEstInvocationListeners
public abstract void setTestInvocationListeners (listeners)
設定ITestInvocationListener
s的列表,替換任何現有值