Как правильно нумеровать версии программы?

Question

[Anonymous]

Здравствуйте! Я хочу узнать, как правильно нумеровать версии программы? Есть ли какие-то определенные правила?

Answer 1

[Василий Банников]

Есть ли какие-то определенные правила?

Правила есть разные. Из популярного - уже упомянутый https://semver.org/lang/ru

Но semver, как правило, не очень подходит для приложений - он больше заточен для библиотек, чтобы из номера версии было понятно, совместимы две разные версии между собой или нет.

Самая простая система нумерации - просто с каждым новым релизом увеличивать номер версии на 1.
Ещё вариант, который по сути даже и не является номером - брать в качестве версии хэш коммита из git.

как правильно

Правильно будет определить, какую проблему ты хочешь решить при помощи особой системы нумерации.
Если у тебя нет каких-то особых задач типа "номер версии должен сообщать, когда была выпущена версия программы" или "из номера версии должно быть очевидно, совместима ли новая версия со старой", то лучше остановиться на варианте с увеличивающимся номером.

Comments

[Anonymous]

Ок. Есть вопрос. Линус Торвальдс писал в своей книге: если твоя программа находится в стадии разработки и ты в ней не уверен, то первая цифра в версии должна быть ноль. Когда твоя программа готова, то переходи на 1.0. Это сейчас актуально?

[Василий Банников]

Никита Савченко, Для консольных программ, которые могут вызываться из скриптов semver как был, так и остаётся актуален.
Как пример - apt-get который из скриптов вызывается очень часто. И его противоположность - apt, который предназначен уже для человека.
apt-get строго должен следовать semver, так как от неправильной версии могут сломаться другие скрипты и программы.
apt же уже не обязан semver следовать. Но часто для понятности всё-равно делают 0 для того что ещё в активной разработке и 1 - для того что уже более-менее стабильно и глобально меняться не будет.

Для GUI - не очень, но нужно смотреть на конкретный случай.

Answer 2

[GavriKos]

Правил куча, единого стандарта нет.

Answer 3

[mayton2019]

Вот был документик. Про семантическое версионирование https://semver.org/lang/ru/

Comments

[Василий Банников]

Только вот semver не для программ, а для библиотек/пакетов/зависимостей придуман.

[Saboteur]

Для программ он тоже отлично подходит.

[Василий Банников]

Saboteur, только не совсем очевидно, что считать ломающим изменением

[mayton2019]

Василий Банников, тоже самое что и для библиотек. Если у вас приложение консольное (архиватор например), то ломающее изменение - это например удаление ключа командной строки или его переименование. Скрипты теряют возможность использовать вашу программу.

Стек использования библиотек и программ как видите принципиально не ограничен сверху.

[Василий Банников]

mayton2019, ну с консольными всё и так понятно, а если GUI ?)

[mayton2019]

Василий Банников, аналогично можно придумать. Новая версия файлового формата например которое GUI сохраняет и открывает. Новый API сетевого enpoint.

[Saboteur]

Василий Банников, у GUI Тоже могут быть изменения.
Например перевел на более новую версию vcredist
Другой формат конфигурационного файла или файла данных