本地代码库规则

可以从 @bazel_tools//tools/build_defs/repo:local.bzl 加载以下函数。

用于将本地文件系统中的目录作为代码库提供的规则。

设置

如需在模块扩展程序中使用这些规则，请将其加载到 .bzl 文件中，然后从扩展程序的实现函数中调用它们。例如，如需使用 local_repository，请使用以下代码：

load("@bazel_tools//tools/build_defs/repo:local.bzl", "local_repository")

def _my_extension_impl(mctx):
  local_repository(name = "foo", path = "foo")

my_extension = module_extension(implementation = _my_extension_impl)

或者，您也可以使用 use_repo_rule 直接在 MODULE.bazel 文件中调用这些代码库规则：

local_repository = use_repo_rule("@bazel_tools//tools/build_defs/repo:local.bzl", "local_repository")
local_repository(name = "foo", path = "foo")

local_repository

local_repository(name, path, repo_mapping)

将已包含 Bazel 文件的本地目录作为代码库提供。此目录应包含 Bazel BUILD 文件和代码库边界文件。如果不包含这些文件，请考虑改用 <a href="#new_local_repository"><code>new_local_repository</code></a>。

属性

name

名称；必需

此代码库的唯一名称。

path

字符串；必需

要作为代码库提供的目录的路径。

路径可以是绝对路径，也可以是工作区根目录的相对路径。

repo_mapping

字典：String -> String；必需

从本地代码库名称到全局代码库名称的字典。这样，您就可以控制此代码库的依赖项的工作区依赖项解析。

例如，条目“@foo”:“@bar”声明，每当此仓库依赖于“@foo”（例如依赖于“@foo//some:target”）时，它实际上应在全局声明的“@bar”中解析该依赖项（“@bar//some:target”）。

new_local_repository

new_local_repository(name, build_file, build_file_content, path, repo_mapping)

将不包含 Bazel 文件的本地目录作为代码库提供。此目录无需包含 Bazel BUILD 文件或代码库边界文件；这些文件将由此代码库规则创建。如果目录中已包含 Bazel 文件，请考虑改用 <a href="#local_repository"><code>local_repository</code></a>。

属性

`name`	名称；必需此代码库的唯一名称。
`build_file`	Label（标签）；选填要用作此代码库的 BUILD 文件的文件。必须指定 `build_file` 和 `build_file_content` 中的一个（且只能指定其中一个）。此标签所引用的文件不必命名为 BUILD，但可以这样命名。`BUILD.new-repo-name` 之类的名称可能很适合用来将其与实际的 BUILD 文件区分开来。
`build_file_content`	字符串；可选要为此代码库创建的 BUILD 文件的内容。必须指定 `build_file` 和 `build_file_content` 中的一个（且只能指定其中一个）。
`path`	字符串；必需要作为代码库提供的目录的路径。路径可以是绝对路径，也可以是工作区根目录的相对路径。
`repo_mapping`	字典：String -> String；必需一个字典，用于将本地代码库名称转换为全局代码库名称。这样，您就可以控制此代码库的依赖项的工作区依赖项解析。例如，“@foo": "@bar"` 条目声明：无论何时此仓库依赖于 `@foo`（例如 `@foo//some:target` 的依赖项），它实际上都应在全局声明的 `@bar` (`@bar//some:target`) 中解析该依赖项。