使用 Bazelisk 安装 / 更新 Bazel

报告问题open_in_new 查看源代码open_in_new 每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

安装 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 问题上发表评论来报告迁移问题。

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