安装 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 版本之间可能会存在不向后兼容的更改。
请按照以下流程从一个主要版本迁移到另一个:
- 请阅读版本说明,获取有关如何迁移到下一版本的建议。
- 不兼容的重大更改应具有关联的
--incompatible_*
标志和相应的 GitHub 问题:- 您可以在相关的 GitHub 问题中找到迁移指南。
- 工具可用于一些不兼容的更改迁移。例如,buildifier。
- 在相关的 GitHub 问题上发表评论,以报告迁移问题。
迁移后,您可以继续构建项目,而无需担心向后兼容性,直到下一个主要版本发布。