預設資訊

7.3 · 7.2 · 7.1 · 7.0 · 6.5

提供供應器，可提供目標的直接和間接檔案的一般資訊。每個規則類型都會提供這個提供者，即使規則的實作函式未明確傳回這個提供者，也是如此。每個 DefaultInfo 例項都包含下列欄位：

files
files_to_run
data_runfiles
default_runfiles

如需詳細的使用說明，請參閱「規則」頁面。

成員

DefaultInfo
data_runfiles
default_runfiles
檔案
files_to_run
to_json
to_proto

DefaultInfo

DefaultInfo DefaultInfo(files=None, runfiles=None, data_runfiles=None, default_runfiles=None, executable=None)

DefaultInfo 建構函式。

參數

參數	說明
`files`	depset；或 `None`；預設為 `None` A `depset` of `File` objects representing the default outputs to build when this target is specified on the bazel command line. 預設為所有預先宣告的輸出內容。
`runfiles`	runfiles 或 `None`；預設為 `None` 。runfiles 描述元描述這個目標在執行時需要的檔案 (透過 `run` 指令或做為工具依附元件)。
`data_runfiles`	runfiles 或 `None`；預設值為 `None` 建議您避免使用這個參數 (請參閱「避免使用 runfile 功能」) runfiles 描述元，說明這個目標在透過 `data` 屬性設為依附元件時，需要執行的 runfiles。
`default_runfiles`	runfiles 或 `None`；預設值為 `None` 建議您避免使用這個參數 (請參閱「避免使用 runfile 功能」) 執行檔案描述元，用於說明這個目標在透過 `data` 屬性以外任何屬性為依附元件時，需要執行的執行檔案。
`executable`	檔案或 `None`；預設為 `None` 。如果這個規則標示為 `executable` 或 `test`，則代表這是 `File` 物件，代表應執行的檔案，以便執行目標。預設為預先宣告的輸出內容 `ctx.outputs.executable`。

data_runfiles

runfiles DefaultInfo.data_runfiles

runfiles 描述元，說明在目標為 data 依附元件屬性時，執行時所需的檔案。在大多數情況下，請改用 default_runfiles 參數。詳情請參閱「"runfiles 功能應避免使用"」一節。可能會傳回 None。

default_runfiles

runfiles DefaultInfo.default_runfiles

執行檔案描述元，以說明此目標執行時需要的檔案 (透過 run 指令或做為工具依附元件)。可能會傳回 None。

檔案

depset DefaultInfo.files

File 物件的 depset，代表在 bazel 指令列中指定這個目標時要建構的預設輸出內容。預設情況下，這會是所有預先宣告的輸出內容。可能會傳回 None。

files_to_run

FilesToRunProvider DefaultInfo.files_to_run

FilesToRunProvider 物件，其中包含目標的可執行檔和執行檔。可能會傳回 None。

to_json

string DefaultInfo.to_json()

已淘汰。這個 API 已淘汰，並將在近期內移除。請勿仰賴這項功能。---incompatible_struct_has_no_methods 會停用。請使用這個標記確認您的程式碼是否與即將移除的程式碼相容。
使用結構體參數建立 JSON 字串。只有在所有結構體元素 (遞迴) 都是字串、整數、布林值、其他結構體、這些類型的清單，或是含有這些類型字串鍵和值的字典時，這個方法才有效。字串中的引號和換行符號會逸出。例如：

struct(key=123).to_json()
# {"key":123}

struct(key=True).to_json()
# {"key":true}

struct(key=[1, 2, 3]).to_json()
# {"key":[1,2,3]}

struct(key='text').to_json()
# {"key":"text"}

struct(key=struct(inner_key='text')).to_json()
# {"key":{"inner_key":"text"}}

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json()
# {"key":[{"inner_key":1},{"inner_key":2}]}

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json()
# {"key":{"inner_key":{"inner_inner_key":"text"}}}

。

已淘汰：請改用 json.encode(x) 或 json.encode_indent(x)，這兩者適用於結構體以外的值，且不會污染結構體欄位命名空間。

to_proto

string DefaultInfo.to_proto()

已淘汰。這個 API 已淘汰，並將在近期移除。請勿依賴這項功能。---incompatible_struct_has_no_methods 會停用。使用這個標記，驗證您的程式碼是否與即將移除的標記相容。
使用結構體參數建立文字訊息。只有在所有結構體元素 (遞迴) 都是字串、整數、布林值、其他結構體或字典或這些類型的清單時，這個方法才會運作。字串中的引號和換行符號會逸出。結構體鍵會依照排序順序進行疊代。範例：

struct(key=123).to_proto()
# key: 123

struct(key=True).to_proto()
# key: true

struct(key=[1, 2, 3]).to_proto()
# key: 1
# key: 2
# key: 3

struct(key='text').to_proto()
# key: "text"

struct(key=struct(inner_key='text')).to_proto()
# key {
#   inner_key: "text"
# }

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto()
# key {
#   inner_key: 1
# }
# key {
#   inner_key: 2
# }

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto()
# key {
#    inner_key {
#     inner_inner_key: "text"
#   }
# }

struct(foo={4: 3, 2: 1}).to_proto()
# foo: {
#   key: 4
#   value: 3
# }
# foo: {
#   key: 2
#   value: 1
# }

已淘汰：請改用 proto.encode_text(x)。