v32.0: Protocol Buffers v32.0

Compare Source

Announcements

• Protobuf News may include additional announcements or pre-announcements for upcoming changes.

Bazel

• Migrates some Java test protos using java_features.proto to edition 2024 (6f4a990)
• Add generated message reflection unittest for import option and option_deps test proto in edition 2024. (c51df73)
• Replace the usage of cc_info.debug_context with _debug_context (776c5f2)
• Generate .pyi files in py_proto_library (#​10366) (#​21567) (e3e56c7)
• Introduce denylisted_protos as a preferred replacement for blacklisted_protos attribute. (795ab9d)
• Use native.proto_library for Bazel 7 and explicitly error for Bazel 6 which is incompatible and out of support. (da0077e)
• Require ProtoInfo provider instead of proto_library rule for bazel cc_proto_library deps. (639f1c9)

Compiler

• Strip extensions from option imports that are known in CollectExtensions due to polluted pool from protoc parse when used with protoc full + java built in generator. (ef3f9ca)
• Deprecate google.protobuf.Method.syntax and google.protobuf.Method.edition (9ec241e)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Ban import weak and weak field option in edition 2024 in protoc (parser and c++ runtime). (a2a0511)

C++

• Strip extensions from option imports that are known in CollectExtensions due to polluted pool from protoc parse when used with protoc full + java built in generator. (ef3f9ca)
• Manually migrate top-level protobuf unittest protos from edition 2023 to edition 2024. (7359f75)
• Add generated message reflection unittest for import option and option_deps test proto in edition 2024. (c51df73)
• Remove the flag requirement for Bazel+MSVC users. (c6ba697)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Cast GetCachedTID() to unsigned to prevent left-shifting a negative number. (3e935cf)
• Update comment at the top of message.h and message_lite.h to document that it should only be extended by gencode and not user code. (6a6ba52)
• Treat warnings encountered in chromium builds as errors. (21c3c53)
• Ban import weak and weak field option in edition 2024 in protoc (parser and c++ runtime). (a2a0511)

Java

• Strip extensions from option imports that are known in CollectExtensions due to polluted pool from protoc parse when used with protoc full + java built in generator. (ef3f9ca)
• Remove CollectExtensions check banning unknown custom options since unknown custom options are now expected when using import option and option_deps which exclude the options from the "builder" pool (aka "import" pool). (694eedd)
• Manually migrate top-level protobuf unittest protos from edition 2023 to edition 2024. (7359f75)
• Migrates some Java test protos using java_features.proto to edition 2024 (6f4a990)
• Restore compatibility of runtime with pre-3.22.x gencode impacted by CVE-2022-3171 (adf556f)
• Update our compiled_edition_default's maximum_edition to 2024 (#​22870) (6216ae4)
• Restore the long-deprecated static functions on TextFormat. (5777d3b)
• Add Kotlin class name helpers to names.h (527b2ab)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Update Java gencode base class documentation to clarify that it is not supported to extend them. (c3177fb)
• Add a FieldMaskUtil#trim overload that accepts TrimOptions and allows retaining unset primitive field state. (84c5b63)

Csharp

• Update staleness (0014173)
• Manually migrate top-level protobuf unittest protos from edition 2023 to edition 2024. (7359f75)
• Update our compiled_edition_default's maximum_edition to 2024 (#​22870) (6216ae4)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Include also ARM build of protoc in nuget package (#​21568) (c2b4040)
• Improve C# handling of Any JSON serialization/deserialization (dc4e429)

Objective-C

• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)

Rust

• Rust: remove DEP_UPB_VERSION check in codegen crate (#​22764) (6f6012a)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Update Rust generator to output minidescriptors instead of C minitables (1b4b5fc)
• Add [clear_and_]parse_dont_enforce_required() to Rust protobuf. (e2fd7a0)
• Add #[non_exhaustive] on the oneof-case enum (aba2075)
• Impl Clone for RepeatedIter (aca1ed5)
• See also UPB changes below, which may affect Rust.

Python

• Strip extensions from option imports that are known in CollectExtensions due to polluted pool from protoc parse when used with protoc full + java built in generator. (ef3f9ca)
• Manually migrate top-level protobuf unittest protos from edition 2023 to edition 2024. (7359f75)
• Raise warnings for float_precision from python json_format. (#​23042) (1a7e012)
• Raise warnings when assign bool to int/enum (#​23030) (0b25f7b)
• Update python edition default maximum edition to 2024 (#​22889) (72abf95)
• Make protobuf codebase compatible with --incompatible_config_setting_private_default_visibility (#​22745) (5e2838e)
• Add Python deprecation warnings for Descriptor Label. (64a76e6)
• Updating setuptools to patch CVE-2025-47273 (#​22094) (508aba1)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Extend gencode compatibility support back to 3.20.0 (1af7fd4)
• Change proto_api work with custom pool for upb and pure python. (49d9e2d)
• Python pyi print "import datetime" for Duration/Timestamp field (f59b84a)
• Add reference leak check to Python well_known_types_test. Fix two refleak bugs. (e5f9ab4)
• Add reference leak check to Python timestamp_test and duration_test. Fix a refleak bug when assign datetime/duration to Timestamp/Duration (e004c8b)
• Add recursion depth limits to pure python (17838be)
• Remove calls to Label within Protobuf Python. (f69180a)
• Change Python .pyi stubs to generated _Optional[] for bool fields same with (6972464)
• Remove internal/api_implementation.Version() (cbad456)
• Fix python proto_api to work with messages that required fields are not set. (f63ed55)
• Fix python upb crashes on map/repeated reference stub destructor (4274909)
• Mark Py JSON float_precision deprecated. (727a8ed)

PHP

• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Fix(php): use count instead of ->count() to avoid bug in c-extension (9fbce62)
• [php][compiler][ext] - Add missing has* methods and other well known types (#​20636) (01a7429)
• Fix PHP 8.4 deprecation in GPBDecodeException (#​21232) (676666e)

PHP C-Extension

• Update our compiled_edition_default's maximum_edition to 2024 (#​22870) (6216ae4)
• Change 'getLabel is deprecated' to E_USER_DEPRECATED (158d8ac)
• [php][compiler][ext] - Add missing has* methods and other well known types (#​20636) (01a7429)
• See also UPB changes below, which may affect PHP C-Extension.

Ruby

• Make protobuf codebase compatible with --incompatible_config_setting_private_default_visibility (#​22745) (5e2838e)
• Enable edition 2024 support in protoc and language generators for cpp, hpb, java, kotlin, objectivec, php, python, pyi, rust. (26843b3)
• Fix silent failure of rb_test rules to run test (#​21733) (4f74764)

Ruby C-Extension

• Update our compiled_edition_default's maximum_edition to 2024 (#​22870) (6216ae4)
• Removed wrap_memcpy.c compatibility shim for pre-2.14 glibc (4ba9733)
• See also UPB changes below, which may affect Ruby C-Extension.

UPB (Python/PHP/Ruby C-Extension)

• Update our compiled_edition_default's maximum_edition to 2024 (#​22870) (6216ae4)
• Make protobuf codebase compatible with --incompatible_config_setting_private_default_visibility (#​22745) (5e2838e)
• Add upb_Message_SetExtensionMessage as a helper for setting a extension field that is a message. This is the extension equivalent of upb_Message_SetBaseFieldMessage. (f15d28a)

Other

• Update github major version tags to be formatted v..- for clarity (e001d57)
• Upgrade Abseil dependency to 2025051.1 (ee68ed1)
• Patch rules_ruby to apply neverlink = True to the jars rule (#​21416) (88e11bd)

v31.1: Protocol Buffers v31.1

Compare Source

Announcements

• Protobuf News may include additional announcements or pre-announcements for upcoming changes.

Compiler

• Support allowing late injection of language feature set defaults from FeatureSet extensions while getting feature set extension values. (3419598)

C++

• Support allowing late injection of language feature set defaults from FeatureSet extensions while getting feature set extension values. (3419598)

Java

• Add missing copts attribute (#​21982) (bec5b5a)
• Support allowing late injection of language feature set defaults from FeatureSet extensions while getting feature set extension values. (3419598)

Python

• Support allowing late injection of language feature set defaults from FeatureSet extensions while getting feature set extension values. (3419598)
• Python pyi print "import datetime" for Duration/Timestamp field (#​21885) (0fe099a)
• Add recursion depth limits to pure python (a3921fb)

Other

• Fix cmake staleness test (96a9ef6)

v31.0: Protocol Buffers v31.0

Compare Source

Announcements

• Protobuf News may include additional announcements or pre-announcements for upcoming changes.

Bazel

• Loosen py_proto_library check to be on the import path instead of full directory (i.e. excluding external/module-name prefix). (a4be867)

Compiler

• Add support for import option for protoc.(9901db6)
• Add notices.h with information about our dependencies' licenses and add --notices flag to protoc to print the contents of that file. (7a26486)
• Move upb minitable code generator into protoc (dce6b0f)
• Upgrade abseil-cpp to 2025012 and use @​com_google_absl -> @​abseil-cpp and com_google_googletest -> @​googletest canonical BCR names. (ba6b54d)

C++

• Remove fast-path check for non-clang compilers in MessageCreator. (aa5410d)
• Add missing include. (d390631)
• Add weak attribute to GetClassData to speed up clang builds. (d896480)
• Add nontemporal software prefetcher to repeated ptr field dtor to improve performance. (73f3469)
• Warn on unused RepeatedPtrField. (683e9d2)
• Add notices.h with information about our dependencies' licenses and add --notices flag to protoc to print the contents of that file. (7a26486)
• Fix a bug in handling of implicit-presence string_view fields. (bd70a7c)
• Control bounds checks via BUILD flags. (d21e8ef)
• Upgrade abseil-cpp to 2025012 and use @​com_google_absl -> @​abseil-cpp and com_google_googletest -> @​googletest canonical BCR names. (ba6b54d)
• Create hardened versions of Get and Mutable for repeated_field. (ffade4a)

Java

• Add weak attribute to GetClassData to speed up clang builds. (d896480)
• Use ProtobufToStringOutput to control the output format of AbstractMessage.Builder.toString. (f5cb162)
• Implement Protobuf Java Immutable API nest_in_file_class feature for Edition 2024. (0416c3e)
• Introduce a Generated annotation to eventually replace javax.annotation.Generated (31e57fc)
• Add volatile to featuresResolved (9e03ca5)
• Fix Java concurrency issue in feature resolution for old <=3.25.x gencode using lazy feature resolution. (fafb0fd)
• Remove Java runtime classes from kotlin release. (079be27)
• Split maven dependencies into dev vs local (#​20549) (e045fc6)
• Improve error messaging when detecting and erroring out on integer overflow of byte count limit variables. (097fdb8)

Kotlin

• Remove Java runtime classes from kotlin release. (079be27)

Csharp

• Remove "experimental API" warnings from members in the .NET protobuf runtime. (afea52f)
• Improve performace of repeated packed fixedSize fields (#​19667) (85507b9)

Objective-C

• [ObjC] Deprecate GPBFieldDescriptor.isOptional. (86ab252)
• [ObjC] Raise the library version and enable new generated code. (a639cf8)

Rust

• Cherry-pick Rust fix to 31.x (#​21617) (01b42bb)
• Add upb_Map_GetMutable API to upb (dd5bf5e)
• See also UPB changes below, which may affect Rust.

Python

• Update GetCurrentTime to use datetime.datetime.now (01b154c)
• Make Py JSON float_precision apply to both float and double fields. (5b54ee3)
• -Add '+' and '-' annotations for Timestamp and Duration in Python (fff783e)
• Bug fix for FieldMask.MergeFrom() with unset fields. (1c87ac3)
• Make python text_format able to skip unknown fields for repeated messages (dcafca2)
• Fix segment fault for UPB Pyhon 'in' method of empty repeated extensions (da04261)
• Fix upb to escape DefinitelyNeedsEscape (like " and ') for bytes field (b234305)
• Check with fallback descriptorDB for FindExtensionByNumber()/FindAllExtensions in UPB python pool. (9fd28d9)
• Add clear() method to repeated fields in Python. (0324f39)
• Register Scalar/MessageMapContainerTypes as virtual subclasses of (9a0b591)
• Fix python codegen crash when C++ features are used. (308aaf4)
• Add more detail to the comment for GetMessageClassesForFiles (9befb58)
• Add constructing unpack routine to Python Protobuf Any API. (fb78c09)
• Implement typing for proto Timestamp/Duration assignments. (0e3326b)

PHP

• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (d82de8f)
• Feat(php): improve return typehint when repeatedfield (#​11734) (e04fe69)

PHP C-Extension

• Automated rollback of commit f9863df. (#​21355) (a59988c)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (d82de8f)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (c398592)
• Feat(php): improve return typehint when repeatedfield (#​11734) (e04fe69)
• See also UPB changes below, which may affect PHP C-Extension.

Ruby

• Fix silent failure of rb_test rules to run test (#​21733) (0cf5489)
• Ruby | Add support for a protobuf debug build (#​21060) (59e1f0f)
• Ruby | Support installing the gem via git and some other small build tweaks (#​21061) (d3560e7)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (d82de8f)
• [Ruby]Implement #to_hash for message classes (#​20866) (5596f6d)
• Drop Ruby 3.0 (5de7c80)
• Fixes #​18726 by backslash escaping descriptor data containing # if the hashmark appears immediately before any of $, {, or @. (fffa3da)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (c398592)
• Ruby: fix bug in Map.hash (b968d0d)

Ruby C-Extension

• Ruby | Add support for a protobuf debug build (#​21060) (59e1f0f)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (d82de8f)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (c398592)
• Ruby: fix bug in Map.hash (b968d0d)
• See also UPB changes below, which may affect Ruby C-Extension.

UPB (Python/PHP/Ruby C-Extension)

• Fixed LTO-only linker error in upb linker arrays. (3434a21)
• Deprecate Descriptor Label. As an alternative, add helper methods for checking whether a field is required or repeated. (d82de8f)
• Add upb_Map_GetMutable API to upb (dd5bf5e)
• Fix upb to escape DefinitelyNeedsEscape (like " and ') for bytes field (b234305)
• Upb: delete functions in map_gencode_util. They're unused after the Map iterator API change. (f398807)
• Upb: Update _upb_map_next signature to return a boolean and remove the _nextmutable Map iterator API. (e4cdf44)
• Change upb C generated map iteration function to not hand out MapEntry pointers. (3a3d697)
• Ruby: Allow to get a file descriptor by a file name (#​20287) (c398592)
• Expose the upb_ByteSize function to upb clients. Note that the current naive implementation is no more efficient than serializing the message yourself and noting the resulting size. (121fdaa)
• Move upb minitable code generator into protoc (dce6b0f)
• Tolerate message set extensions encoded as normal deliminited submessages (c63fd56)
• Automated rollback of commit 6bde8c4. (8ef81fb)
• Fix UPB fast table build. (46f9e29)

Other

• Patch rules_ruby to apply neverlink = True to the jars rule (#​21416) (#​21505) (664d94a)
• Restore JDK8 compatibility in Bazel for libraries with dependencies from Maven (e.g. //java/util) (e8edc5d)
• Protobuf: add //:go_features_proto Bazel alias (f79be3e)
• Fixes -lpthread problem when building with android_arm64 config (#​20337) (4f5968a)

v30.2: Protocol Buffers v30.2

Compare Source

Announcements

• Protobuf News may include additional announcements or pre-announcements for upcoming changes.

Compiler

• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)

C++

• Remove dllexport attribute on variable definition. (#​20833) (7831669)
• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)
• Change how we decide which empty string implementation to use. (#​20708) (221b2a0)

Java

• Remove dllexport attribute on variable definition. (#​20833) (7831669)
• Add protobuf_maven artifacts to protobuf_maven_dev as well so they can still be referenced correctly using the dev namespace for dev-only targets. (#​20771) (09b5078)
• Add volatile to featuresResolved (#​20766) (b7f06f1)
• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)
• Restore custom protobuf maven namespaces to avoid polluting main maven namespace for non-dev dependencies as well. (#​20739) (f4b0a79)
• Fix Java concurrency issue in feature resolution for old <=3.25.x gencode using lazy feature resolution. (#​20751) (2dc9f35)
• Fix lite classes in the protobuf-java Maven release to be JDK8 compatible. (#​20843) (7a4c63b)

Kotlin

• Restore custom protobuf maven namespaces to avoid polluting main maven namespace for non-dev dependencies as well. (#​20739) (f4b0a79)

Csharp

• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)

Objective-C

• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)

Python

• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)

Ruby

• Restore generator headers in cmake install until the next breaking C++ release (#​20749) (b69f653)

Other

• Restore JDK8 compatibility in Bazel for libraries with dependencies from Maven (e.g. //java/util) (#​20832) (da9cadc)

v30.1: Protocol Buffers v30.1

Compare Source

Announcements

• Protobuf News may include additional announcements or pre-announcements for upcoming changes.

Bazel

• Loosen py_proto_library check to be on the import path instead of full directory (i.e. excluding external/module-name prefix). (#​20569) (3576a1f)

Compiler

• Fix python codegen crash when C++ features are used. (#​20577) (250c550)

C++

• Fix python codegen crash when C++ features are used. (#​20577) (250c550)

Java

• Remove Java runtime classes from kotlin release. (#​20607) (4747628)

Kotlin

• Remove Java runtime classes from kotlin release. (#​20607) (4747628)

Python

• Fix python codegen crash when C++ features are used. (#​20577) (250c550)

Other

• Re-add system_python repo alias to MODULE.bazel (#​20662) (ebb5224)

v30.0: Protocol Buffers v30.0

Compare Source

Announcements

• This version includes breaking changes to: Objective-C, Python, C++.
  • [Objective-C] Remove legacy WKT headers. (d9caebc)
  • [Objective-C] Remove deprecated apis. (2a52b90)
  • [Objective-C] Remove support for older generated code. (cffa590)
  • [Objective-C] Remove GPBUnknownFieldSet. (2b93422)
  • [Python] Fix closed enum validation under editions (72b3eda)
  • [Python] Remove deprecated GetDebugString() from protobuf python cpp extension. (721a452)
  • [Python] Remove deprecated reflection methods (292f964)
  • [Python] Remove deprecated GetPrototype MessageFactory.GetPrototype(), (c261b49)
  • [Python] Python nested message class qualname now contains the outer message name. (Previous qualname has the same result with name for nested message that outer message name was not included) (0720536)
  • [Python] Remove deprecated Python RPC Service Interfaces (5ba74b1)
  • [Python] Python setdefault behavior change for map field. (81da6b9)
  • [Python] Remove deprecated py_proto_library macro.
  • [C++] Prohibit using Bazel+MSVC to build protobuf (117e7bb)
  • [C++] Remove deprecated Arena::CreateMessage. (d83a536)
  • [C++] Remove CMake submodule support in favor of fetched or installed dependencies. (3f06ca4)
  • [C++] Flip default behavior for handling cmake dependencies. (9cc685e)
  • [C++] Add ASAN poisoning after clearing oneof messages on arena. (54d068e)
  • [C++] Upgrade return type of type_name() and cpp_type_name() from const char* to absl::string_view. (a9ad51f)
  • [C++] Remove deprecated RepeatedPtrField::ClearedCount(). (e8e3253)
  • [C++] Upgrade return type of several string returning functions to absl::string_view. (d1990d9)
  • [C++] Strip ctype from options in C++ (aebf8b9)
  • [C++] Remove MutableRepeatedFieldRef::Reserve() in reflection (913f7b0)
  • [C++] Remove deprecated JsonOptions alias. (e2eb0a1)
  • [C++] Remove deprecated Arena::GetArena. (30ed452)
• Protobuf News may include additional announcements or pre-announcements for upcoming changes.
• Migration Guide includes migration instructions for breaking changes for this release.

Bazel

• Remove reference to cc_proto_aspect (fa02f76)
• Remove deprecated bazel/system_python.bzl alias. (00f108c)

Compiler

• Add notices.h with information about our dependencies' licenses and add --notices flag to protoc to print the contents of that file. (a7df327)
• Have the protoc CLI properly report any parser warnings. (cafeaa4)
• Split protoc apart from libprotoc in our cmake configs. (b4b93b3)
• Begin adding extension numbers to SourceCodeInfo and FileDescriptorSet for tooling purposes. (9d7236b)
• Fix various unsigned to signed comparison warnings. (#​17212) (67de087)

C++

• Fixing staleness tests (6abaf77)
• Add notices.h with information about our dependencies' licenses and add --notices flag to protoc to print the contents of that file. (a7df327)
• Backport: Remove if_constexpr usage for future Abseil compatibility (#​20488) (450ee76)
• Add tests for older gcc versions we still support (#​20463) (0778473)
• Fix a bug in handling of implicit-presence string_view fields. (#​20403) (81196ac)
• Remove rules_rust dependency from MODULE.bazel for 30.x (#​20310) (b8248f6)
• Upgrade abseil-cpp to 2025012 and use @​com_google_absl -> @​abseil-cpp and com_google_googletest -> @​googletest canonical BCR names. (#​20295) (df849cc)
• Replace std::any with a custom solution. (#​20251) (6250d09)
• Make DebugString print debug output, enable debug markers for debug output (9a03332)
• Fix missing port_undef (#​20052) (0644388)
• Use __builtin_expect_with_probability for proto field presence checks. (e958419)
• Enable meta-tagging for redaction purposes ([1f48795](https://re