2023年12月13日に発表された変更
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)
サポートを使用してください。
これらの変更に関する詳細は、対応するリリースノートで入手可能になります。