使用 Bazelisk 安装 / 更新 Bazel

报告问题 查看源代码

安装 Bazel

建议使用 Bazelisk 在 Ubuntu、Windows 和 macOS 上安装 Bazel。它会自动下载并安装适当版本的 Bazel。如果您需要根据当前工作目录在 Bazel 的不同版本之间切换，或者要让 Bazel 始终更新到最新版本，请使用 Bazelisk。

如需了解详情，请参阅官方 README。

更新 Bazel

Bazel 具有向后兼容性政策（如果您是某个政策的创建者，请参阅发布不兼容的更改指南）。该页面总结了有关如何测试和迁移项目（包含即将发生的不兼容更改）以及如何向不兼容的更改创建者提供反馈的最佳做法。

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可帮助您管理 Bazel 版本。

Bazelisk 可以：

• 将 Bazel 自动更新到最新的 LTS 或滚动版本。
• 使用 .bazelversion 文件中指定的 Bazel 版本构建项目。将该文件签入版本控制中，以确保 build 的可重现性。
• 帮助迁移项目以进行不兼容的更改（参见上文）
• 轻松试用候选版本

建议的迁移流程

在任何 LTS 版本的次要更新中，任何项目都可以为下一个版本做好准备，而不会破坏与当前版本的兼容性。但是，主要 LTS 版本之间可能会存在不向后兼容的更改。

请按照以下流程从一个主要版本迁移到另一个：

1. 请阅读版本说明，获取有关如何迁移到下一版本的建议。
2. 不兼容的重大更改应具有关联的 --incompatible_* 标志和相应的 GitHub 问题：
   • 您可以在相关的 GitHub 问题中找到迁移指南。
   • 工具可用于一些不兼容的更改迁移。例如，buildifier。
   • 在相关的 GitHub 问题上发表评论，以报告迁移问题。

迁移后，您可以继续构建项目，而无需担心向后兼容性，直到下一个主要版本发布。