Versionamento Semântico (SemVer) define uma especificação formal para atribuir e incrementar números de versão de software: MAJOR.MINOR.PATCH.
Os Três Componentes
$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$
- MAJOR (
1.0.0->2.0.0): Mudanças incompatíveis que quebram a API. - MINOR (
1.0.0->1.1.0): Novas funcionalidades retrocompatíveis. - PATCH (
1.0.0->1.0.1): Correções de bugs retrocompatíveis.
Pré-lançamentos e Metadados de Compilação
1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108 # Metadados de compilação (+são ignorados na precedência de versões)
Ordem de precedência: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.
Especificadores de Intervalo de Gerenciadores de Pacotes
| Intervalo | Versões Incluídas | Descrição |
|---|---|---|
1.2.3 |
1.2.3 |
Correspondência exata de versão |
>1.2.3 |
1.2.4, 2.0.0, ... |
Maior que |
>=1.2.0 <1.3.0 |
1.2.0 up to 1.2.9 |
Intervalo delimitado |
~1.2.3 |
>=1.2.3 <1.3.0 |
Razoavelmente próximo (permite apenas patches) |
^1.2.3 |
>=1.2.3 <2.0.0 |
Compatível (permite versões minor e patch) |
^0.2.3 |
>=0.2.3 <0.3.0 |
Em 0.x.x, uma versão minor quebra a compatibilidade |
* |
Any version | Curinga irrestrito |