安装 Bazel
Bazelisk 是在 Ubuntu、Windows 和 macOS 上安装 Bazel 的 推荐方式。它会自动 下载并安装相应版本的 Bazel。如果您需要根据当前 工作目录在不同版本的 Bazel 之间切换,或者始终将 Bazel 更新到最新版本,请使用 Bazelisk。
如需了解详情,请参阅 官方自述文件。
更新 Bazel
Bazel 具有 向后兼容性政策 (如果您 是作者,请参阅推出不兼容 更改的指南)。该页面总结了有关如何测试和 迁移具有即将推出的不兼容更改的项目,以及如何向不兼容更改作者提供 反馈的最佳实践。
使用 Bazelisk 管理 Bazel 版本
Bazelisk 可帮助您管理 Bazel 版本。
Bazelisk 可以:
- 将 Bazel 自动更新到最新的 LTS 或滚动发布版本。
- 使用 .bazelversion 文件中指定的 Bazel 版本构建项目。将该文件签入版本控制系统,以确保构建的可重现性 。
- 帮助迁移项目以适应不兼容的更改(见上文)
- 轻松试用候选版本
推荐的迁移流程
在对任何 LTS 版本进行次要更新时,任何 项目都可以为下一个版本做好准备,而不会破坏 与当前版本的兼容性。不过,主要 LTS 版本之间可能会存在 向后不兼容的更改。
请按照以下流程从一个主要版本迁移到另一个主要版本:
- 阅读版本说明,获取有关如何迁移到下一个版本的建议。
- 主要不兼容的更改应具有关联的
--incompatible_*标志 和相应的 GitHub 问题:- 关联的 GitHub 问题中提供了迁移指南。
- 某些不兼容的更改迁移提供了工具。例如,buildifier。
- 通过评论关联的 GitHub 问题来报告迁移问题。
迁移后,您可以继续构建项目,而无需担心 向后兼容性,直到下一个主要版本发布。