What are the best practices for versioning Protocol Buffers?

Некоторые лучшие практики для версиирования Protocol Buffers:

• Присваивать уникальные числовые идентификаторы каждому полю в сообщении. thetechartist.com Это позволит плавно обрабатывать разные версии и обеспечивать обратную и прямую совместимость обновлений. thetechartist.com
• Не изменять значение поля. toxigon.com Если нужно изменить смысл поля, следует создать новое поле с другим именем и объявить устаревшее старое поле. toxigon.com
• Не использовать повторно теги полей. toxigon.com protobuf.dev После того как тег поля использован, его нельзя использовать для другого поля. toxigon.com
• При удалении полей резервировать их номера. app.studyraid.com Это предотвратит случайное повторное использование. app.studyraid.com
• При добавлении новых полей к существующим сообщениям: app.studyraid.com
• назначать новые номера полей, которые не использовались раньше; app.studyraid.com
• предоставлять значения по умолчанию для обратной совместимости; app.studyraid.com
• рассматривать возможность использования необязательных полей для новых дополнений. app.studyraid.com

Также рекомендуется регулярно просматривать и рефакторить файлы .proto, удалять устаревшие поля, объединять похожие типы сообщений и по возможности упрощать структуры. geekgrove.net