2023年12月13日に発表された変更

2023年12月13日に Protocol Buffers に対して発表された変更。

C++ 破壊的変更

v26 では、破壊的変更ポリシーバージョンサポートポリシーに従い、C++ のメジャーバージョンアップを計画しています。

以下のセクションでは、protocol buffers の 26.0 リリースに含める予定の破壊的変更のセットについて概説します。計画は変更される可能性があることに注意してください。これらは注意すべき潜在的な破壊的変更ですが、今回のリリースで発生するとは限らず、まったく発生しない可能性もあります。

非推奨の repeated フィールドの clear API を削除

以下の非推奨メソッドは削除されます

  • RepeatedPtrField::ReleaseCleared()
  • RepeatedPtrField::ClearedCount()
  • RepeatedPtrField::AddCleared()

C++ レガシー構文記述子 API を削除

エディションのリリースに伴い、ビジネスロジックで syntax はサポートされなくなりました。代わりに、C++ で機能をクエリするには、descriptor.h で定義されているさまざまな機能ヘルパー(has_presence など)を使用して、より的を絞った動作をクエリしてください。

非推奨の syntax アクセサーを削除

v26 で、非推奨の syntax アクセサーである FileDescriptor::Syntax を削除する予定です。代わりに、FileDescriptor::edition からゲッターを使用することをお勧めします。

非推奨の SupportsUnknownEnumValues メソッドを削除

SupportsUnknownEnumValues メソッドは、2023年3月に非推奨になりました。v26 で削除する予定です。

std::string エラーコレクターのオーバーライドを削除

エラーコレクターで非推奨の std::string メソッドを削除する予定です。

Python 破壊的変更

v26 では、破壊的変更ポリシーバージョンサポートポリシーに従い、Python のメジャーバージョンアップを計画しています。

タイムスタンプの有効性がチェックされる

v26 では、システムは Timestamp 値が有効かどうかをチェックします。秒は [-62135596800, 253402300799] の範囲内、ナノ秒は [0, 999999999] の範囲内である必要があります。これらの範囲外の値は例外を発生させます。

非推奨の syntax アクセサーを削除

v26 で、非推奨の syntax アクセサーである FileDescriptor.syntax を削除する予定です。代わりに FileDescriptor.edition を追加する予定です。

UnknownFields サポートの削除

v25 で、message.UnknownFields() は pure Python および C++ 拡張機能で非推奨になりました。v26 で削除する予定です。代替として、unknown_fields.py の新しい UnknownFieldSet(message) サポートを使用してください。

これらの変更に関する詳細は、対応するリリースノートで入手可能になります。