實作工廠

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

已知間接子類別 ConfigurationFactory、GCSConfigurationFactory、重試 ConfigurationFactory、SandboxConfigurationFactory ConfigurationFactory 建立 IConfiguration 的工廠。  GCSConfigurationFactory ConfigurationFactory 會從 Google Cloud Storage 載入設定。  重試 ConfigurationFactory 處理重試指令的工廠。  SandboxConfigurationFactory 用於處理沙箱用途設定建立作業的特殊設定工廠。

---

用於建立 IConfiguration 的工廠

摘要

公用方法
abstract IConfiguration	createConfigurationFromArgs(String[] args, unconsumedArgs) 透過指令列引數建立 IConfiguration。
abstract IConfiguration	createConfigurationFromArgs(String[] args) 呼叫 ERROR(/#createConfigurationFromArgs(String[],List)) 的便利方法 呼叫 null 秒即可啟動函式
abstract IConfiguration	createConfigurationFromArgs(String[] args, unconsumedArgs, IKeyStoreClient keyStoreClient) 使用金鑰儲存庫的指令列引數建立 IConfiguration。
abstract IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] args, nonGlobalArgs) 透過指令列引數建立 IGlobalConfiguration。
abstract IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) 建立僅包含一組所選物件的設定。
abstract void	dumpConfig(String configName, PrintStream out) 將設定內容傾印至指定的 ERROR(/PrintStream)
abstract	getConfigList() 傳回在類別路徑的 JAR 中找到的所有設定名稱清單。
abstract	getConfigList(String subPath, boolean loadFromEnv) getConfigList() 的變化，用於指定是否要一併載入 從環境複製設定
abstract void	printHelp(PrintStream out) 列印這台工廠的說明輸出內容。
abstract void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) 列印指令列引數中指定的 IConfiguration 說明輸出內容。 如果「args」代表已知的設定，系統會建立 IConfiguration 物件 並輸出 IConfiguration 的說明

公用方法

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs)

透過指令列引數建立 IConfiguration。

預期格式為「設定 [選項]」，其中 CONFIG 為內建設定名稱或 設定檔路徑

參數
args	String：指令列引數
unconsumedArgs	：要填入非引數的清單 所消耗的物件。如果這是 null，則實作將會擲回 ConfigurationException 表示有任何未處理的引數。

傳回
IConfiguration	載入的 IConfiguration。委派物件「Option」欄位有 就會填入 args 的值。

擲回
ConfigurationException	如果無法載入設定

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

呼叫 ERROR(/#createConfigurationFromArgs(String[],List)) 的便利方法 呼叫 null 秒即可啟動函式因此，如果發生以下情況，系統會擲回 ConfigurationException 所有未消耗的引數都會保留下來。

參數
args	String

傳回
IConfiguration

擲回
ConfigurationException

另請參閱：

• ERROR(/#createConfigurationFromArgs(String[], List))

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

使用金鑰儲存庫的指令列引數建立 IConfiguration。

預期格式為「設定 [選項]」，其中 CONFIG 為內建設定名稱或 設定檔路徑

參數
args	String：指令列引數
unconsumedArgs	：要填入非引數的清單 所消耗的物件。如果這是 null，則實作將會擲回 ConfigurationException 表示有任何未處理的引數。
keyStoreClient	IKeyStoreClient：IKeyStoreClient，用於取得機密資訊 引數

傳回
IConfiguration	載入的 IConfiguration。委派物件「Option」欄位有 就會填入 args 的值。

擲回
ConfigurationException	如果無法載入設定

createGlobalConfigurationFromArgs

public abstract IGlobalConfiguration createGlobalConfigurationFromArgs (String[] args, 
                 nonGlobalArgs)

透過指令列引數建立 IGlobalConfiguration。

預期格式為「設定 [選項]」，其中 CONFIG 為內建設定名稱或 設定檔路徑

參數
args	String：指令列引數
nonGlobalArgs	：要填入未定義引數的清單 視為全域引數

傳回
IGlobalConfiguration	載入的 IGlobalConfiguration。委派物件 Option 欄位 而是填入 args 的值。

擲回
ConfigurationException	如果無法載入設定

createPartialConfigurationFromArgs

public abstract IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

建立僅包含一組所選物件的設定。

參數
arrayArgs	String：指令列引數
keyStoreClient	IKeyStoreClient：IKeyStoreClient，用於取得 引數。
allowedObjects	：要建立的允許物件組合
delegator	TradefedDelegator

傳回
IConfiguration	已載入的 IConfiguration。

擲回
ConfigurationException	如果無法載入設定

轉儲設定

public abstract void dumpConfig (String configName, 
                PrintStream out)

將設定內容傾印至指定的 ERROR(/PrintStream)

參數
configName	String：設定名稱
out	PrintStream：指定要將輸出內容轉儲到哪個 ERROR(/PrintStream)

getConfigList

public abstract  getConfigList ()

傳回在類別路徑的 JAR 中找到的所有設定名稱清單。 不會嘗試載入任何設定，因此可能會在設定期間失效 。

傳回

getConfigList

public abstract  getConfigList (String subPath, 
                boolean loadFromEnv)

getConfigList() 的變化，用於指定是否要一併載入 從環境複製設定

參數
subPath	String：要尋找的子目錄名稱。若為空值，將會有 行為與 getConfigList() 相同
loadFromEnv	boolean：如果我們要在環境變數中載入設定，則為「是」。

傳回

列印說明

public abstract void printHelp (PrintStream out)

列印這台工廠的說明輸出內容。

列印一般說明資訊，並列出所有可用設定。

參數
out	PrintStream：指定要將輸出內容轉儲到哪個 ERROR(/PrintStream)

printHelpForConfig

public abstract void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

列印指令列引數中指定的 IConfiguration 說明輸出內容。

如果「args」代表已知的設定，系統會建立 IConfiguration 物件 並輸出 IConfiguration 的說明注意所有其他的「args」 值將被忽略 (也就是說，說明文字將描述 Options 目前的值 從 XML 載入，不會反映指令列引數所設定的選項值。

如果「args」未參照已知的 IConfiguration (通用產品) 系統隨即會顯示printHelp(PrintStream)說明。

參數
args	String：指令列引數
importantOnly	boolean：如果為 true，則只顯示列出縮寫說明 重要細節
out	PrintStream：指定要將輸出內容轉儲到哪個 ERROR(/PrintStream)