MODULE.bazel 檔案中可用方法。
成員
- archive_override
- bazel_dep
- git_override
- local_path_override
- 模組
- multiple_version_override
- register_execution_platforms
- register_toolchains
- single_version_override
- use_extension
- use_repo
- use_repo_rule
archive_override
None
archive_override(module_name, urls, integrity='', strip_prefix='', patches=[], patch_cmds=[], patch_strip=0)
指定這項依附元件應來自特定位置的封存檔案 (zip、gzip 等),而非註冊資料庫。這個指令只會在根模組中生效;換句話說,如果模組做為其他依附元件使用模組,系統會忽略本身的覆寫值。
參數
參數 | 說明 |
---|---|
module_name
|
必要 要套用此覆寫值的 Bazel 模組依附元件名稱。 |
urls
|
string;或「字串」的可疊代項目;
必要 封存內容的網址;可以是 http(s):// 或 file:// URL。 |
integrity
|
預設值為 '' 封存檔案的預期總和檢查碼,採用子資源完整性格式。 |
strip_prefix
|
預設值為 '' 要從已擷取檔案中移除的目錄前置字串。 |
patches
|
字串的可疊代項目;
預設值為 [] 標籤清單,指向要套用至這個模組的修補程式檔案。修補型檔案必須存在於頂層專案的來源樹狀結構中。這些規則會按照清單順序套用。 |
patch_cmds
|
字串的可疊代項目;
預設值為 [] 套用修補程式後,要套用到 Linux/Macos 的 Bash 指令序列。 |
patch_strip
|
預設值為 0 與 Unix 修補程式的 --strip 引數相同。 |
bazel_dep
None
bazel_dep(name, version='', max_compatibility_level=-1, repo_name='', dev_dependency=False)
宣告另一個 Bazel 模組的直接依附元件。
參數
參數 | 說明 |
---|---|
name
|
必要 要新增為直接依附元件的模組名稱。 |
version
|
預設值為 '' 要新增為直接依附元件的模組版本。 |
max_compatibility_level
|
預設值為 -1 支援將模組新增為直接依附元件的支援數量上限 compatibility_level 。模組版本會隱含支援的最低 compatible_level,以及如未指定屬性,則為最大值。
|
repo_name
|
預設值為 '' 代表此依附元件的外部存放區名稱。此為預設模組的名稱。 |
dev_dependency
|
預設值為 False 如果設為 true,當目前的模組不是根模組或已啟用 `--ignore_dev_dependency` 時,系統會忽略這個依附元件。 |
git_override
None
git_override(module_name, remote, commit='', patches=[], patch_cmds=[], patch_strip=0)
指定依附元件應來自某個 Git 存放區的特定修訂版本。這個指令只會在根模組中生效;換句話說,如果模組做為其他依附元件使用模組,系統會忽略本身的覆寫值。
參數
參數 | 說明 |
---|---|
module_name
|
必要 要套用此覆寫值的 Bazel 模組依附元件名稱。 |
remote
|
必要 遠端 Git 存放區的網址。 |
commit
|
預設值為 '' 應結帳的修訂版本。 |
patches
|
字串的可疊代項目;
預設值為 [] 標籤清單,指向要套用至這個模組的修補程式檔案。修補型檔案必須存在於頂層專案的來源樹狀結構中。這些規則會按照清單順序套用。 |
patch_cmds
|
字串的可疊代項目;
預設值為 [] 套用修補程式後,要套用到 Linux/Macos 的 Bash 指令序列。 |
patch_strip
|
預設值為 0 與 Unix 修補程式的 --strip 引數相同。 |
local_path_override
None
local_path_override(module_name, path)
指定依附元件應來自本機磁碟上的特定目錄。這個指令只會在根模組中生效;換句話說,如果模組做為其他依附元件使用模組,系統會忽略本身的覆寫值。
參數
參數 | 說明 |
---|---|
module_name
|
必要 要套用此覆寫值的 Bazel 模組依附元件名稱。 |
path
|
必要 模組所在目錄的路徑。 |
module
None
module(name='', version='', compatibility_level=0, repo_name='', bazel_compatibility=[])
宣告目前 Bazel 存放區所代表 Bazel 模組的某些屬性。這些屬性是模組的基本中繼資料 (例如名稱和版本),或影響目前模組及其相依項目的行為。最多不應呼叫一次。只有在這個模組為根模組時,才可以省略它 (如同同理,如果不以其他模組依附該模組)。
參數
參數 | 說明 |
---|---|
name
|
預設值為 '' 模組的名稱,只有在這個模組為根模組時,才可以省略 (就像同好,它不是由其他模組依附)。有效的模組名稱必須:1) 只能包含小寫英文字母 (a 至 z)、數字 (0 至 9)、半形句號 (.)、連字號 (-) 和底線 (_);2) 以小寫英文字母開頭;3) 結尾須為小寫英文字母或數字。 |
version
|
預設值為 '' 模組的版本。只有在這個模組為根模組時,才可以省略 (就像同好,它不是由其他模組依附)。版本必須採用寬鬆的 SemVer 格式;詳情請參閱說明文件。 |
compatibility_level
|
預設值為 0 模組的相容性等級;每次推出重大不相容的變更時,應該都會變更。這基本上就是「主要版本」模組,但不包括版本字串本身,而是獨立欄位。相容性等級不同的模組會以版本解析的形式呈現,就像是模組具有不同名稱的模組一樣,但最終依附元件圖表不能包含多個名稱相同,但相容性等級不同的模組 (除非 multiple_version_override 生效)。詳情請參閱說明文件。
|
repo_name
|
預設值為 '' 代表這個模組的存放區名稱,如模組本身所示。根據預設,存放區的名稱是模組名稱。如果專案使用某個存放區名稱,但該存放區名稱與模組名稱不同,您可以指定這個值,以便更輕鬆地遷移專案。 |
bazel_compatibility
|
字串的可疊代項目;
預設值為 [] bazel 版本清單,可讓使用者宣告與這個模組相容的 Bazel 版本。這項設定「不會」影響依附元件解析,但 bzlmod 會使用這項資訊來檢查您目前的 Bazel 版本是否相容。這個值是某些限制值的字串,並以半形逗號分隔,支援三個限制:<=X.X.X:Bazel 版本必須等於或早於 X.X.X。在新版本中有已知的不相容變更時使用。>=X.X.X:Bazel 版本必須等於或高於 X.X.X。當您依賴某些只能在 X.X.X 之後才能使用的功能時,才會使用 Bazel。-X.X.X:Bazel 版本 X.X.X 不相容。當 X.X.X 中有錯誤讓您中斷,但在後續版本中已修正時可使用。 |
multiple_version_override
None
multiple_version_override(module_name, versions, registry='')
指定依附元件應仍來自註冊資料庫,但應允許同時存在多個版本。詳情請參閱說明文件。這個指令只會在根模組中生效;換句話說,如果模組做為其他依附元件使用模組,系統會忽略本身的覆寫值。
參數
參數 | 說明 |
---|---|
module_name
|
必要 要套用此覆寫值的 Bazel 模組依附元件名稱。 |
versions
|
字串的可疊代項目;
必要 明確指定可同時存在的版本。這些版本必須已列在依附元件圖表預先選取項目中。這個模組的依附元件將「已升級」至於相容性等級中最接近的可用版本,如果依附元件的版本高於在相同相容性等級的任何可用版本,就會造成錯誤。 |
registry
|
預設值為 '' 覆寫此模組的登錄檔;而非從預設登錄檔清單中找到這個模組,則應使用指定的登錄檔。 |
register_execution_platforms
None
register_execution_platforms(dev_dependency=False, *platform_labels)
選取這個模組時,指定要登錄已定義的執行平台。必須是絕對目標模式 (例如開頭為 @
或 //
)。詳情請參閱工具鍊解決方案。
參數
參數 | 說明 |
---|---|
dev_dependency
|
預設值為 False 如果設為 true,如果目前的模組不是根模組,或已啟用 `--ignore_dev_dependency`,系統就不會註冊執行平台。 |
platform_labels
|
字串的序列;
必要 要註冊的平台標籤。 |
register_toolchains
None
register_toolchains(dev_dependency=False, *toolchain_labels)
選取這個模組時,指定要註冊的已定義的工具鍊。必須是絕對目標模式 (例如開頭為 @
或 //
)。詳情請參閱工具鍊解決方案。
參數
參數 | 說明 |
---|---|
dev_dependency
|
預設值為 False 如果設為 true,且目前的模組不是根模組,或已啟用 `--ignore_dev_dependency`,系統就不會註冊工具鍊。 |
toolchain_labels
|
字串的序列;
必要 要註冊的工具鍊標籤。標籤可以包含 :all ,在此情況下,套件中所有工具鍊提供的目標將依名稱的字母順序登錄。
|
single_version_override
None
single_version_override(module_name, version='', registry='', patches=[], patch_cmds=[], patch_strip=0)
指定依附元件應仍來自登錄檔,但其版本應固定,或是已覆寫登錄檔,或是套用修補程式清單。這個指令只會在根模組中生效;換句話說,如果模組做為其他依附元件使用模組,系統會忽略本身的覆寫值。
參數
參數 | 說明 |
---|---|
module_name
|
必要 要套用此覆寫值的 Bazel 模組依附元件名稱。 |
version
|
預設值為 '' 覆寫依附元件圖表中此模組的宣告版本。換句話說,這個模組會「固定」這個覆寫版本如果只想覆寫登錄檔或修補程式,則可省略這項屬性。 |
registry
|
預設值為 '' 覆寫此模組的登錄檔;而非從預設登錄檔清單中找到這個模組,則應使用指定的登錄檔。 |
patches
|
字串的可疊代項目;
預設值為 [] 標籤清單,指向要套用至這個模組的修補程式檔案。修補型檔案必須存在於頂層專案的來源樹狀結構中。這些規則會按照清單順序套用。 |
patch_cmds
|
字串的可疊代項目;
預設值為 [] 套用修補程式後,要套用到 Linux/Macos 的 Bash 指令序列。 |
patch_strip
|
預設值為 0 與 Unix 修補程式的 --strip 引數相同。 |
use_extension
module_extension_proxy use_extension(extension_bzl_file, extension_name, *, dev_dependency=False, isolate=False)傳回代表模組擴充功能的 Proxy 物件。即可叫用 方法,建立模組擴充功能標記。
參數
參數 | 說明 |
---|---|
extension_bzl_file
|
必要 定義模組副檔名的 Starlark 檔案標籤。 |
extension_name
|
必要 要使用的模組擴充功能名稱。具有此名稱的符號必須由 Starlark 檔案匯出。 |
dev_dependency
|
預設值為 False 設為 true 時,如果目前的模組不是根模組,或已啟用 `--ignore_dev_dependency`,系統會忽略這個模組擴充功能的用法。 |
isolate
|
預設值為 False 實驗功能。這項參數仍在實驗階段,隨時可能變更。請勿仰賴這項功能。你可以透過設定 ---experimental_isolated_extension_usages 以實驗性方式啟用該功能 設為 true 時,此模組擴充功能的使用情形將與此模組及其他模組的其他所有用途區隔開來。這麼做的標記不會影響其他用途,而且這項用量的擴充功能產生的存放區會與擴充功能產生的所有其他存放區不同。 這個參數目前處於實驗階段,只能搭配標記 |
use_repo
None
use_repo(extension_proxy, *args, **kwargs)
將指定模組擴充功能產生的一或多個存放區匯入目前模組的範圍。
參數
參數 | 說明 |
---|---|
extension_proxy
|
必要 由 use_extension 呼叫傳回的模組擴充功能 Proxy 物件。
|
args
|
必要 要匯入的存放區名稱。 |
kwargs
|
必要 使用不同名稱指定要匯入至目前模組範圍的特定存放區。鍵應為在目前範圍中使用的名稱,而值應為模組擴充功能匯出的原始名稱。 |
use_repo_rule
repo_rule_proxy use_repo_rule(repo_rule_bzl_file, repo_rule_name)傳回可直接在 MODULE.bazel 檔案中直接叫用的 Proxy 值做為存放區規則 (重複一次)。只有目前的模組可以查看以這種方式建立的重組,該模組的名稱在 Proxy 上透過
name
屬性宣告。隱含布林值 dev_dependency
屬性也可以在 Proxy 上使用,代表只有在目前模組為根模組時,系統才會建立特定存放區。
參數
參數 | 說明 |
---|---|
repo_rule_bzl_file
|
必要 定義存放區規則的 Starlark 檔案標籤。 |
repo_rule_name
|
必要 要使用的存放區規則名稱。具有此名稱的符號必須由 Starlark 檔案匯出。 |