以節省記憶體的方式封裝物件，建構部分或所有指令列所需的資料。
通常會發生動作需要大型指令列，其中含有從遞移依附元件累積的值。例如，連結器指令列可能會列出所有連結程式庫所需的每個物件檔案。最佳做法是將這類遞移資料儲存在 depset 中，以便多個目標共用。不過，如果規則作者必須將這些 depset 轉換為字串清單，才能建構動作指令行，這就會破壞這項記憶體共用最佳化功能。
因此，除了字串之外，動作建構函式也接受 Args 物件。每個 Args 物件都代表字串與解碼集的串連，並可選擇用於操控資料的選用轉換。在計算指令列時，Args 物件不會處理其封裝到執行階段之前封裝的 DepSet。這有助於在分析階段完成後，再延遲執行任何耗用大量資源的複製作業。詳情請參閱「最佳化效能」頁面。
Args 是透過呼叫 ctx.actions.args() 建構。可做為 ctx.actions.run() 或 ctx.actions.run_shell() 的 arguments 參數傳遞。每項 Args 物件的異動事件都會在最終指令列中附加值。
map_each 功能可讓您自訂項目轉換為字串的方式。如未提供 map_each 函式，標準轉換會如下所示：
- 已是字串的值會維持原樣。
File物件會轉換為其File.path值。Label物件會轉換為字串表示法，在主要存放區的內容中解析後，就會解析為同一個物件。如果可以，字串表示法會使用存放區的顯著名稱，取而代之的是存放區的正式名稱，因此這種表示法相當適合 BUILD 檔案使用。雖然無法保證具體的表示形式，但典型例子包括//foo:bar、@repo//foo:bar和@@canonical_name~//foo:bar.bzl。- 所有其他類型都會以未指定的方式轉換為字串。因此，請避免將非字串或
File類型的值傳遞至add()，如果您將這些值傳遞至add_all()或add_joined()，則應提供map_each函式。
使用字串格式設定 (format、format_each 和 format_joined 參數的 add*() 方法) 時，系統會以與字串 % 替換相同的方式解讀格式範本，但範本必須有且僅有一個替換預留位置，且該預留位置必須為 %s。您可以使用 %% 逸出文字百分比。系統會依照上述方法，在值轉換為字串後套用格式設定。
每個 add*() 方法都有另一種形式，可接受額外的位址參數，也就是在其餘引數之前插入的「arg name」字串。如果序列為空白，add_all 和 add_joined 就不會新增額外字串。舉例來說，視指定序列包含 val1..val3 或為空白而定，相同的使用方式可在指令列中新增 --foo val1 val2 val3 --bar 或 --bar。
如果指令列的大小可超過系統允許的大小上限，則可將引數溢出至參數檔案中。請參閱 use_param_file() 和 set_param_file_format()。
範例：假設我們要產生指令列：
--foo foo1.txt foo2.txt ... fooN.txt --bar bar1.txt,bar2.txt,...,barM.txt --baz我們可以使用下列
Args 物件：
# foo_deps and bar_deps are depsets containing
# File objects for the foo and bar .txt files.
args = ctx.actions.args()
args.add_all("--foo", foo_deps)
args.add_joined("--bar", bar_deps, join_with=",")
args.add("--baz")
ctx.actions.run(
...
arguments = [args],
...
)
成員
add
Args Args.add(arg_name_or_value, value=unbound, *, format=None)將引數附加至這個指令列。
參數
| 參數 | 說明 |
|---|---|
arg_name_or_value
|
必要 如果傳遞兩個位置參數，系統會將其解讀為引數名稱。引數名稱會在值之前新增，且不會進行任何處理。如果只傳遞一個位置參數，系統會將其視為 value (詳見下文)。
|
value
|
預設值為 unbound要附加的物件。系統會使用上述的標準轉換格式，將該字串轉換為字串。這個函式沒有 map_each 參數，因此 value 應該是字串或 File。清單、元組、depset 或目錄 File 必須傳遞至 add_all() 或 add_joined()，而非這個方法。
|
format
|
string;或 None；
預設值為 None要套用至 value 字串化版本的格式字串模式。
|
add_all
Args Args.add_all(arg_name_or_values, values=unbound, *, map_each=None, format_each=None, before_each=None, omit_if_empty=True, uniquify=False, expand_directories=True, terminate_with=None, allow_closure=False)將多個引數附加至這個指令列。項目會在執行階段延遲處理。
處理程序大多會透過附加的引數清單進行，如以下步驟所示：
- 每個目錄的
File項目都會由該目錄以遞迴方式納入的所有File取代。 - 如果指定
map_each，就會套用至每個項目，而產生的字串清單會串連起來，以形成初始引數清單。否則，初始引數清單是為每個項目套用標準轉換的結果。 - 清單中的每個引數都會採用
format_each的格式 (如果有的話)。 - 如果
uniquify為 true，系統會移除重複的引數。系統會保留第一個出現的值。 - 如果指定了
before_each字串，系統會將該字串以新引數的形式插入清單中的每個現有引數。這會有效使這個點附加的引數數量增加了一倍。 - 除了清單為空白且
omit_if_empty為 true (預設值) 的情況外，如果有指定引數名稱和terminate_with，系統會分別將這些引數插入為第一個和最後一個引數。
參數
| 參數 | 說明 |
|---|---|
arg_name_or_values
|
required 如果傳遞兩個位置參數，系統會將這項資訊解讀為引數名稱。引數名稱會新增至 values 之前，做為個別引數，且不會經過任何處理。如果 omit_if_empty 為 true (預設值)，且未附加其他項目 (也就是 values 空白或所有項目都遭到篩除)，系統就不會新增這個引數名稱。如果只傳遞一個位置參數，系統會將其解讀為 values (請參閱下方說明)。 |
values
|
sequence;或 depset；
預設值為 unbound要附加其項目的清單、元組或解碼集。 |
map_each
|
callable;或 None；
預設值為 None可將每個項目轉換為零或多個字串的函式。系統會在附加前進一步處理。如果未提供這個參數，系統會使用標準轉換。 系統會傳送一或兩個位置引數：要轉換的項目，後面加上選用的 回傳值的類型取決於要為項目產生多少引數：
None 的效果，分別等同於傳回長度為 1 或 0 的清單。不過，避免在不需要時建立清單，可提高效率及可讀性。通常，當設定 為避免在執行階段中意外保留大量分析階段資料結構， 警告：在呼叫 |
format_each
|
字串或 None；預設為 None。可選的格式字串模式，套用至 map_each 函式傳回的每個字串。格式字串中只能有一個「%s」預留位置。 |
before_each
|
string;或 None；
預設值為 None每個衍生自 values 的引數之前，都會附加選用的引數。
|
omit_if_empty
|
預設為 True如果為 true，如果沒有從 values 衍生出要附加的引數，則會抑制所有後續處理作業，且命令列不會變更。如果是 False，則無論是否有其他引數，仍會附加引數名稱和 terminate_with (如有)。
|
uniquify
|
預設值為 False如果設為 true，系統會省略衍生自 values 的重複引數。系統只會保留每個引數的第一次出現。通常不需要這項功能，因為 depset 已略過重複項目，但如果 map_each 為多個項目傳出相同的字串，這項功能就很實用。 |
expand_directories
|
預設值為 True如為 true， values 中的任何目錄都會展開為平面檔案清單。這項作業會在套用 map_each 前執行。
|
terminate_with
|
字串或 None；預設為 None。這是選用引數，會附加至所有其他引數之後。如果 omit_if_empty 為 true (預設值)，且沒有附加其他項目 (如果 values 為空白或所有項目都已篩除)，則不會加入這個引數。
|
allow_closure
|
預設為 False如果為 true，則可在 map_each 等函式參數中使用閉包。一般來說，這並非必要，而且可能會導致在執行階段保留大量的分析階段資料結構。
|
add_joined
Args Args.add_joined(arg_name_or_values, values=unbound, *, join_with, map_each=None, format_each=None, format_joined=None, omit_if_empty=True, uniquify=False, expand_directories=True, allow_closure=False)使用分隔符串連多個值，藉此將引數附加至這個指令列。項目會在執行階段延遲處理。
處理方式與 add_all() 類似，但從 values 衍生的引數清單會合併為單一引數，就像由 join_with.join(...) 一樣，然後使用指定的 format_joined 字串範本格式化。與 add_all() 不同，由於項目合併為單一引數時，這類參數通常沒有幫助，因此沒有 before_each 或 terminate_with 參數。
如果篩選後沒有字串可彙整為引數，且 omit_if_empty 為 true (預設值)，則不會進行任何處理。如果沒有要彙整的字串，但 omit_if_empty 為 false，則聯結字串將會是空字串。
參數
| 參數 | 說明 |
|---|---|
arg_name_or_values
|
必要 如果傳遞兩個位置參數，系統會將其解讀為引數名稱。且在 values 前方加入 arg 名稱，不經過任何處理。如果 omit_if_empty 為 true (預設值)，且沒有從 values 衍生並彙整的字串 (如果 values 為空白或所有項目都已篩除，就可能發生這種情況)，就不會新增這個引數。如果只傳遞一個位置參數，系統會將其解讀為 values (請參閱下方說明)。 |
values
|
sequence 或 depset；預設為 unbound。 要彙整項目的清單、元組或 depset。 |
join_with
|
必填 分隔符字串，用於將套用 map_each 和 format_each 後取得的字串連結在一起，方式與 string.join() 相同。
|
map_each
|
callable;或 None；
預設值為 None與 add_all 相同。
|
format_each
|
string;或 None；
預設值為 None與 add_all 相同。
|
format_joined
|
字串或 None；預設為 None。 (選用) 套用至已彙整字串的格式字串模式。格式字串只能有一個「%s」預留位置。 |
omit_if_empty
|
預設值為 True如果設為 true，如果沒有要合併的字串 (因為 values 空白或所有項目都經過篩選)，系統將停止後續處理作業，且指令列會保持不變。如果為 false，即使沒有要彙整的字串，也會附加兩個引數：引數名稱後面加上空白字串 (這是零字串的邏輯彙整)。
|
uniquify
|
預設為 False。與 add_all 相同。 |
expand_directories
|
預設值為 True與 add_all 相同。
|
allow_closure
|
預設值為 False與 add_all 相同。
|
set_param_file_format
Args Args.set_param_file_format(format)設定參數檔案的格式 (如果使用參數檔案)
參數
| 參數 | 說明 |
|---|---|
format
|
必要 必須是下列其中一個：
如未呼叫，格式預設為「shell」。 |
use_param_file
Args Args.use_param_file(param_file_arg, *, use_always=False)將引數溢位至參數檔案，並以指向參數檔案的指標取代引數。當引數可能超過系統指令長度限制時，請使用 。
為提高效率，Bazel 可能會選擇在執行期間略過將 param 檔案寫入輸出樹狀結構的動作。如果您正在偵錯動作，並想檢查 param 檔案，請將 --materialize_param_files 傳遞至建構項目。
參數
| 參數 | 說明 |
|---|---|
param_file_arg
|
必要 "%s" 格式字串。如果引數溢出至參數檔案，系統會將引數替換成由這個字串 (採用參數檔案路徑格式) 組成的引數。 舉例來說，如果引數會放在參數檔案「params.txt」，請指定「--file=%s」會導致動作指令列包含「--file=params.txt」。 |
use_always
|
預設值為 False是否一律將引數傳遞至參數檔案。設為 false 時，bazel 會根據系統和引數長度決定是否需要將引數排出。 |