使用 Bazelisk 安装 / 更新 Bazel

报告问题 查看源代码

安装 Bazel

Bazelisk 是推荐在 Ubuntu、Windows 和 macOS 上安装 Bazel 的方法。它会自动下载并安装合适的 Bazel 版本。如果您需要根据当前工作目录在不同的 Bazel 版本之间切换,请使用 Bazelisk,或始终将 Bazel 保持为最新版本。

如需了解详情,请参阅官方 README 文件

正在更新 Bazel

Bazel 具有向后兼容性政策(如果您是作者,请参阅关于发布不兼容的更改的指南)。本页面总结了有关如何在即将推出的不兼容更改中测试和迁移项目的最佳做法,以及如何向不兼容的变更作者提供反馈。

使用 Bazelisk 管理 Bazel 版本

Bazelisk 可帮助您管理 Bazel 版本。

Bazelisk 可以:

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

推荐的迁移过程

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

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

  1. 请阅读版本说明,获取有关如何迁移到下一个版本的建议。
  2. 主要不兼容的更改应具有关联的 --incompatible_* 标志和相应的 GitHub 问题:
    • 您可以在相关的 GitHub 问题中找到迁移指南。
    • 工具可用于迁移某些不兼容的更改。例如,构建器
    • 通过评论关联的 GitHub 问题报告迁移问题。

迁移后,您可以继续构建项目,而无需担心下一个主要版本之前的向后兼容性。