Bazel Central Registry 使用教程

Bazel Central Registry 使用教程

bazel-central-registry The central registry of Bazel modules for the Bzlmod external dependency system. 项目地址: https://gitcode.com/gh_mirrors/ba/bazel-central-registry

1. 项目介绍

Bazel Central Registry（BCR）是 Bazel 模块的中央注册表，用于 Bazel 的 Bzlmod 外部依赖系统。它是 Bazel 项目的默认注册表，推荐用于查找和发布你喜欢的 Bazel 项目。BCR 由 Bazel 团队和 Bazel 规则作者 SIG 维护。

主要功能

• 模块管理：集中管理 Bazel 模块，方便用户查找和使用。
• 依赖管理：支持 Bzlmod 外部依赖系统，简化项目依赖管理。
• 社区贡献：鼓励社区贡献，丰富 Bazel 生态系统。

2. 项目快速启动

安装 Bazel

首先，确保你已经安装了 Bazel。如果尚未安装，可以通过以下命令安装：

$ sudo apt-get install bazel

克隆 BCR 仓库

克隆 Bazel Central Registry 仓库到本地：

$ git clone https://github.com/bazelbuild/bazel-central-registry.git
$ cd bazel-central-registry

使用 BCR 模块

在 Bazel 项目中使用 BCR 模块，可以在 MODULE.bazel 文件中添加依赖：

bazel_dep(name = "rules_python", version = "0.35.0")

构建项目

使用 Bazel 构建你的项目：

$ bazel build //your:target

3. 应用案例和最佳实践

应用案例

• Google 内部项目：Google 内部广泛使用 Bazel 和 BCR 来管理大型项目的依赖。
• 开源项目：许多开源项目如 TensorFlow 和 Angular 使用 Bazel 和 BCR 来管理构建和依赖。

最佳实践

• 模块版本管理：使用明确的版本号来管理模块依赖，避免版本冲突。
• 持续集成：在 CI/CD 流程中集成 Bazel，确保构建和测试的自动化。
• 社区贡献：积极参与 BCR 社区，贡献新的模块和改进现有模块。

4. 典型生态项目

主要生态项目

• rules_python：提供 Python 项目的构建规则。
• rules_nodejs：提供 Node.js 项目的构建规则。
• rules_docker：提供 Docker 镜像的构建规则。

使用示例

以下是如何在项目中使用 rules_python 模块的示例：

load("@rules_python//python:pip.bzl", "pip_install")

pip_install(
    name = "my_deps",
    requirements = "//:requirements.txt",
)

通过以上步骤，你可以快速上手 Bazel Central Registry，并利用其强大的模块管理功能来简化你的项目依赖管理。

bazel-central-registry The central registry of Bazel modules for the Bzlmod external dependency system. 项目地址: https://gitcode.com/gh_mirrors/ba/bazel-central-registry