版本 29.x 新闻公告

宣布 Protocol Buffers 版本 29.x 的变更。

以下公告专属于 2024 年 11 月 27 日发布的 29.x 版本。有关按时间顺序排列的信息,请参阅新闻

Bazel 和 Proto 规则

Bazel 在 protobuf 构建中的工作方式即将发生变更。这些变更要求项目所有者在第一阶段知晓,并在第二阶段之前采取行动。

第一阶段

随着 Bazel 8 的发布,proto 规则(proto_librarycc_proto_libraryjava_proto_libraryjava_lite_proto_librarypy_proto_library)将从 Bazel 项目中移除,并被添加到 v29 版本的 Protocol Buffers 项目中。Bazel 将更新为自动使用 protobuf 项目中的规则,因此对于项目所有者来说,此变更在初期无需任何操作。

在 Bazel 8 发布之后、Bazel 9 发布之前,用户需要从 Protocol Buffers 项目仓库中显式 load(加载)这些规则。规则的自动使用只是为了支持迁移而采取的临时措施。

用户应在使用这些 proto 规则的任何 BUILD.bzl 文件中添加以下 load() 语句。请注意,这需要 Protobuf v29.0 或更高版本。

load("@protobuf//bazel:proto_library.bzl", "proto_library")

load("@protobuf//bazel:cc_proto_library.bzl", "cc_proto_library")
load("@protobuf//bazel:java_proto_library.bzl", "java_proto_library")
load("@protobuf//bazel:java_lite_proto_library.bzl", "java_lite_proto_library")
load("@protobuf//bazel:py_proto_library.bzl", "py_proto_library")

第二阶段

当 Bazel 9 发布时,protobuf 库规则的自动加载功能将被移除。届时,您的 Bazel 构建文件中必须包含 load 语句。

最终目标

一旦规则迁移到 protobuf 仓库中,我们计划解决一些常见的用户请求,例如在可能的情况下为 proto 编译器使用预构建版本。