Git 代码库规则

<ph type="x-smartling-placeholder"></ph> 报告问题查看来源敬上每晚 · 7.3。 · 7.2 条 · 7.1。 · 7.0。 · 6.5

您可以从 @bazel_tools//tools/build_defs/repo:git.bzl。

克隆外部 Git 代码库的规则。

git_repository

git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args,
               patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote,
               repo_mapping, shallow_since, strip_prefix, tag, verbose, workspace_file,
               workspace_file_content)

克隆外部 Git 代码库。

克隆 Git 代码库，签出指定的标记或提交，以及使其目标可供绑定。还要确定提交实际签出及其日期，并返回一个包含参数的字典提供此规则的可重现版本（即是）。

Bazel 会先尝试仅对指定的提交执行浅层提取。如果请求失败（通常是因为缺少服务器支持），就会回退到执行代码库的完整提取操作

与 git_repository 相比，首选 http_archive。原因如下：

Git 代码库规则依赖于系统 git(1)，而 HTTP 下载程序是构建的并且没有系统依赖项
http_archive 支持 urls 列表作为镜像，git_repository 仅支持单个 remote。
http_archive 可与代码库缓存结合使用，但不适用于 git_repository。请参阅 #5116 了解详情。

属性

`name`	姓名；必需此代码库的唯一名称。
`branch`	String;可选分支进行签出。必须指定分支、标记或提交中的一个。
`build_file`	标签；可选要用作此代码库的 BUILD 文件的文件。此属性是绝对标签（对于主代码库，请使用“@//”）。该文件不需要命名为 BUILD，但可以（像 BUILD.new-repo-name 这样的名称可能很适合将其与代码库的实际 BUILD 文件区分开来）。
`build_file_content`	String;可选此代码库的 BUILD 文件的内容。
`commit`	String;可选要签出的特定提交必须指定分支、标记或提交中的一个。
`init_submodules`	布尔值；可选是否克隆代码库中的子模块。
`patch_args`	字符串列表；可选提供给修补工具的参数。默认为 -p0，但是 git 生成的补丁通常需要 -p1。如果指定了多个 -p 参数，则最后一个参数将会生效。如果指定了 -p 以外的参数，Bazel 将回退到使用补丁命令行工具，而不是 Bazel 原生补丁实现。如果回退到补丁命令行工具且未指定 patch_tool 属性，系统将使用“patch”。
`patch_cmds`	字符串列表；可选应用补丁后，要应用于 Linux/Macos 的一系列 Bash 命令。
`patch_cmds_win`	字符串列表；可选应用补丁后，要应用于 Windows 的 Powershell 命令序列。如果未设置该属性，则系统将在 Windows 上执行 patch_cmds，这要求存在 Bash 二进制文件。
`patch_tool`	String;可选要使用的补丁(1) 实用程序。如果指定此字段，Bazel 将使用指定的修补工具，而不是 Bazel 原生补丁程序实现。
`patches`	标签列表；可选在提取归档文件后要作为补丁应用的文件列表。默认情况下，它使用不支持模糊匹配和二进制补丁的 Bazel 原生补丁实现，但如果指定了“patch_tool”属性或“patch_args”属性中存在除“-p”以外的参数，Bazel 将回退到使用补丁命令行工具。
`recursive_init_submodules`	布尔值；可选是否在代码库中以递归方式克隆子模块。
`remote`	String;必需远程 Git 代码库的 URI
`repo_mapping`	字典：String ->String;必需从本地代码库名称到全局代码库名称的字典。这样，您就可以控制此代码库的依赖项的工作区依赖项解析。例如，条目 "@foo": "@bar"` 声明，无论何时此仓库依赖于 `@foo`（例如 `@foo//some:target` 的依赖项），它实际上都应在全局声明的 `@bar` (`@bar//some:target`) 中解析该依赖项。
`shallow_since`	String;可选可选日期，而不是在指定的提交之后；如果指定了标记或分支（始终可使用 --depth=1 克隆），则不允许使用该参数。将此类日期设置为接近指定的提交日期可能允许对代码库进行浅层克隆，即使服务器不支持对任意提交内容的浅层提取也是如此。由于 Git 的 --shallow-since 实现中存在 bug，因此不建议使用此属性，因为它可能会导致提取失败。
`strip_prefix`	String;可选要从提取的文件中删除的目录前缀。
`tag`	String;可选标记来签出。必须指定分支、标记或提交中的一个。
`verbose`	布尔值；可选
`workspace_file`	标签；可选要用作此代码库的“WORKSPACE”文件的文件。可以指定“workspace_file”或“workspace_file_content”，也可以不指定任何一个，但不能同时指定两者。
`workspace_file_content`	String;可选此代码库的 WORKSPACE 文件的内容。可以指定“workspace_file”或“workspace_file_content”，也可以不指定任何一个，但不能同时指定两者。

new_git_repository

new_git_repository(name, branch, build_file, build_file_content, commit, init_submodules,
                   patch_args, patch_cmds, patch_cmds_win, patch_tool, patches,
                   recursive_init_submodules, remote, repo_mapping, shallow_since, strip_prefix, tag,
                   verbose, workspace_file, workspace_file_content)

克隆外部 Git 代码库。

Bazel 会先尝试仅对指定的提交执行浅层提取。如果请求失败（通常是因为缺少服务器支持），就会回退到执行代码库的完整提取操作

与 git_repository 相比，首选 http_archive。原因如下：

Git 代码库规则依赖于系统 git(1)，而 HTTP 下载程序是构建的并且没有系统依赖项
http_archive 支持 urls 列表作为镜像，git_repository 仅支持单个 remote。
http_archive 可与代码库缓存结合使用，但不适用于 git_repository。请参阅 #5116 了解详情。

属性

`name`	姓名；必需此代码库的唯一名称。
`branch`	String;可选分支进行签出。必须指定分支、标记或提交中的一个。
`build_file`	标签；可选要用作此代码库的 BUILD 文件的文件。此属性是绝对标签（对于主代码库，请使用“@//”）。该文件不需要命名为 BUILD，但可以（像 BUILD.new-repo-name 这样的名称可能很适合将其与代码库的实际 BUILD 文件区分开来）。
`build_file_content`	String;可选此代码库的 BUILD 文件的内容。
`commit`	String;可选要签出的特定提交必须指定分支、标记或提交中的一个。
`init_submodules`	布尔值；可选是否克隆代码库中的子模块。
`patch_args`	字符串列表；可选提供给修补工具的参数。默认为 -p0，但是 git 生成的补丁通常需要 -p1。如果指定了多个 -p 参数，则最后一个参数将会生效。如果指定了 -p 以外的参数，Bazel 将回退到使用补丁命令行工具，而不是 Bazel 原生补丁实现。如果回退到补丁命令行工具且未指定 patch_tool 属性，系统将使用“patch”。
`patch_cmds`	字符串列表；可选应用补丁后，要应用于 Linux/Macos 的一系列 Bash 命令。
`patch_cmds_win`	字符串列表；可选应用补丁后，要应用于 Windows 的 Powershell 命令序列。如果未设置该属性，则系统将在 Windows 上执行 patch_cmds，这要求存在 Bash 二进制文件。
`patch_tool`	String;可选要使用的补丁(1) 实用程序。如果指定此字段，Bazel 将使用指定的修补工具，而不是 Bazel 原生补丁程序实现。
`patches`	标签列表；可选在提取归档文件后要作为补丁应用的文件列表。默认情况下，它使用不支持模糊匹配和二进制补丁的 Bazel 原生补丁实现，但如果指定了“patch_tool”属性或“patch_args”属性中存在除“-p”以外的参数，Bazel 将回退到使用补丁命令行工具。
`recursive_init_submodules`	布尔值；可选是否在代码库中以递归方式克隆子模块。
`remote`	String;必需远程 Git 代码库的 URI
`repo_mapping`	字典：String ->String;必需从本地代码库名称到全局代码库名称的字典。这样，您就可以控制此代码库的依赖项的工作区依赖项解析。例如，条目 "@foo": "@bar"` 声明，无论何时此仓库依赖于 `@foo`（例如 `@foo//some:target` 的依赖项），它实际上都应在全局声明的 `@bar` (`@bar//some:target`) 中解析该依赖项。
`shallow_since`	String;可选可选日期，而不是在指定的提交之后；如果指定了标记或分支（始终可使用 --depth=1 克隆），则不允许使用该参数。将此类日期设置为接近指定的提交日期可能允许对代码库进行浅层克隆，即使服务器不支持对任意提交内容的浅层提取也是如此。由于 Git 的 --shallow-since 实现中存在 bug，因此不建议使用此属性，因为它可能会导致提取失败。
`strip_prefix`	String;可选要从提取的文件中删除的目录前缀。
`tag`	String;可选标记来签出。必须指定分支、标记或提交中的一个。
`verbose`	布尔值；可选
`workspace_file`	标签；可选要用作此代码库的“WORKSPACE”文件的文件。可以指定“workspace_file”或“workspace_file_content”，也可以不指定任何一个，但不能同时指定两者。
`workspace_file_content`	String;可选此代码库的 WORKSPACE 文件的内容。可以指定“workspace_file”或“workspace_file_content”，也可以不指定任何一个，但不能同时指定两者。