Referência rápida

Folha de Cola de Versionamento Semântico (SemVer)

Guia de referência rápida para Semantic Versioning: incrementos MAJOR.MINOR.PATCH, tags de pré-lançamento e intervalos de gerenciadores de pacotes.

· Publicado

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}$$

  1. MAJOR (1.0.0 -> 2.0.0): Mudanças incompatíveis que quebram a API.
  2. MINOR (1.0.0 -> 1.1.0): Novas funcionalidades retrocompatíveis.
  3. 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

Referências

Temas relacionados