Как организовать поддержку и версионирование общей библиотеки компонентов?

Question

Поддержка библиотеки строится вокруг версионирования и обратной совместимости. Обычно используется semantic versioning. Изменения документируются и публикуются через релизы. Потребляющие проекты обновляют версию осознанно. Это позволяет контролировать влияние изменений на продукты.

YeaHub · Accepted Answer

ОпределениеВерсионирование библиотеки — это процесс управления изменениями пакета так, чтобы потребляющие проекты понимали, безопасно ли обновляться.Semantic VersioningЧаще всего применяется semver:major — ломающие измененияminor — новые возможности без поломокpatch — исправления баговПоддержка и развитиеДля стабильной работы библиотеки обычно:ведётся changelogописываются breaking changesиспользуются pull request и code reviewдобавляются визуальные или unit-тесты компонентовСовместимость с проектамиЧтобы минимизировать проблемы:ломающие изменения выпускаются редкоустаревшие API сначала помечаются как deprecatedдаётся время на миграциюКраткий выводГрамотное версионирование и прозрачные релизы делают общую библиотеку безопасной и удобной для использования в нескольких проектах.