Bazel 4.0 及更高版本支持两个版本轨道:长期支持 (LTS) 版本和滚动版本。本页介绍了 Bazel 中的版本控制、版本类型,以及这些版本对 Bazel 用户和贡献者的益处。
了解 Bazel 上的版本控制
Bazel 使用 major.minor.patch 语义版本控制方案。
- 主要版本包含与上一个版本不向后兼容的功能。
- 次要版本包含新的向后兼容功能。
- 补丁版本包含次要更改和 bug 修复。
以版本 3.5.1 为例,每种类型的新版本都会生成以下版本号:
- 主要:4.0
- 次要:3.6
- 补丁:3.5.2
Bazel 的发布周期
Bazel 会持续发布滚动版本。每个主要版本都是 LTS 版本。您可以选择遵循以下任一发布节奏:从一个 LTS 版本更新到下一个 LTS 版本,或随着每个次要版本的发布进行更新。
此图显示了滚动版本和 LTS 版本,以及对 。
图 1. 滚动版和 LTS 版本。
发布分支
每个主要版本在发布后都会成为一个单独的开发分支。您可以接收该分支上关键 bug 的修复,而无需更新到最新的 Bazel 版本。主要版本分支上的其他功能变为 次要版本,并且分支上的最高版本是受支持的版本。
每个 Bazel 版本都与有效的推荐规则版本列表配对 并且每个分支内都有严格的向后兼容性。
LTS 版本
LTS 版本是支持 3 年的主要版本(如 4.0) 。 大约每 9 个月发布一个主要版本。
对版本分支进行持续开发会产生次要版本。
您可以选择将项目固定到某个主要版本,并更新到较新的版本 自己的版本。这样,您便有时间预览即将发生的更改 以适应这些变化。
滚动发布
滚动版本会定期从 Bazel 的主分支中删除。 此发布节奏涉及持续交付 Bazel 的下一个主要版本的预览版,这些版本与 Google 的内部 Blaze 版本保持同步。
请注意,新的滚动发布版本可能包含与之前的版本不兼容的破坏性更改。
在 Bazel CI 的 Bazel 测试套件上测试滚动版本,
Google 的内部测试套件。不兼容的标志
过去常常能够减轻迁移到新功能的负担,但其默认行为
可能会随着任何滚动版本而发生变化(您还可以使用滚动发布功能
可以预览下一个 LTS 版本。例如,5.0.0-pre.20210604.6
基于
候选版本将于 2021 年 6 月 4 日剪切,代表着实现 5.0 LTS 的一个里程碑
release.)
您可以从 GitHub 下载最新的滚动发布版本。或者,您也可以设置 Bazelisk v1.9.0 (或更高版本)来使用特定版本名称或 “rolling”标识符,它使用最新的滚动版本。如需了解详情,请参阅 Bazelisk 文档。
更新版本
- 如需详细了解如何更新 Bazel 版本,请参阅 更新 Bazel。
- 如需详细了解如何为新的 Bazel 版本贡献更新,请参阅 为 Bazel 贡献代码。