Семантическое версионирование (SemVer) определяет формальную спецификацию присвоения и изменения номеров версий ПО: MAJOR.MINOR.PATCH.
Три компонента версии
$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$
- MAJOR (
1.0.0->2.0.0): Несовместимые изменения, ломающие обратную совместимость API. - MINOR (
1.0.0->1.1.0): Новая функциональность с сохранением обратной совместимости. - PATCH (
1.0.0->1.0.1): Исправления ошибок с сохранением обратной совместимости.
Пре-релизы и метаданные сборки
1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108 # Метаданные сборки (+игнорируются при сравнении старшинства версий)
Порядок старшинства: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Спецификаторы диапазонов в пакетных менеджерах
| Диапазон | Включенные версии | Описание |
|---|---|---|
1.2.3 |
1.2.3 |
Точное совпадение версии |
>1.2.3 |
1.2.4, 2.0.0, ... |
Строго больше |
>=1.2.0 <1.3.0 |
1.2.0 up to 1.2.9 |
Ограниченный диапазон |
~1.2.3 |
>=1.2.3 <1.3.0 |
Только обновления уровня patch |
^1.2.3 |
>=1.2.3 <2.0.0 |
Совместимые обновления (разрешены minor и patch) |
^0.2.3 |
>=0.2.3 <0.3.0 |
В версиях 0.x.x релиз minor считается ломающим совместимость |
* |
Any version | Любая версия (без ограничений) |