例如:設定 rule()
函式的 build_setting
參數,將下列規則標示為建構設定。具體來說,這是 int
類型的建構設定和 flag
,這表示可以透過指令列呼叫這項建構設定。
my_rule = rule( implementation = _impl, build_setting = config.int(flag = True), ... )
成員
bool
BuildSetting config.bool(flag=False)布林值型版本設定
參數
參數 | 說明 |
---|---|
flag
|
default = False 是否可以在指令列中呼叫這項建構設定。 |
exec
ExecTransitionFactory config.exec(exec_group=None)建立執行轉換作業。
參數
參數 | 說明 |
---|---|
exec_group
|
string; or None ;
default = None轉換平台的執行平台名稱。如未提供,這項執行轉換將使用目標的預設執行平台。 |
int
BuildSetting config.int(flag=False)整數類型的建構設定
參數
參數 | 說明 |
---|---|
flag
|
default = False 是否可以在指令列中呼叫這項建構設定。 |
字串
BuildSetting config.string(flag=False, allow_multiple=False)字串類型的建構設定
參數
參數 | 說明 |
---|---|
flag
|
default = False 是否可以在指令列中呼叫這項建構設定。 |
allow_multiple
|
default = False 已淘汰,請改用 string_list 設定搭配 repeatable = True 。如有設定,則可在指令列中多次設定這個標記。在轉換和建構設定實作函式中存取的旗標值會成為字串清單。廣告訂單和重複的值會保留。如果需要其他行為,可以在建構設定實作函式中後期處理這份清單。 |
string_list
BuildSetting config.string_list(flag=False, repeatable=False)字串清單類型的建構設定。在指令列上傳送清單時,請使用以半形逗號分隔的值,例如「--//my/setting=foo,bar」。
參數
參數 | 說明 |
---|---|
flag
|
default = False 是否可以在指令列中呼叫這項建構設定。 |
repeatable
|
default = False 設定後,該旗標可在指令列上多次設定,而非使用半形逗號分隔,而且每個個別值都視為單一字串加入清單值。廣告訂單和重複的值會保留。如果需要其他行為,可以在建構設定實作函式中後期處理這份清單。 |