Sobre a versão semântica
On Dezembro 9, 2021 by adminPara manter o ecossistema JavaScript saudável, confiável e seguro, toda vez que você fizer atualizações significativas em um pacote npm que você possui, nós recomendamos publicar uma nova versão do pacote com um número de versão atualizado no arquivo package.json
que segue a especificação de versão semântica. Seguir as especificações de versionamento semântico ajuda outros desenvolvedores que dependem do seu código a entender a extensão das mudanças em uma determinada versão, e ajustar seu próprio código se necessário.
Incrementar versões semânticas em pacotes publicados
Para ajudar os desenvolvedores que confiam no seu código, recomendamos iniciar a versão do seu pacote em 1.0.0
e incrementar como a seguir:
Estado do código | Etapa | Regra | Versão de exemplo |
---|---|---|---|
Primeiro lançamento | Novo produto | Inicie com 1.0.0 | 1.0.0 |
Backward compatível com correcções de bugs | Lançamento do patch | Incrementar o terceiro dígito | 1.0.1 |
Backward compatível com novas características | Lançamento menor | Incrementar o dígito do meio e repor o último dígito a zero | 1.1.0 |
Alterações que quebram a compatibilidade para trás | Lançamento maior | Incrementar o primeiro dígito e zerar os dígitos do meio e último para zero | 2.0.0 |
Usando a versão semântica para especificar os tipos de atualização que seu pacote pode aceitar
Você pode especificar quais tipos de atualização seu pacote pode aceitar a partir das dependências em seu pacote package.json
file.
Por exemplo, para especificar intervalos de versão aceitáveis até 1.0.4, use a seguinte sintaxe:
- Lançamentos de patch:
1.0
ou1.0.x
ou~1.0.4
- Minor lançamentos:
1
ou1.x
ou^1.0.4
- Lançamentos maiores:
*
oux
Para mais informações sobre a sintaxe da versão semântica, veja a calculadora semver npm.
Exemplo
"dependências": {"minha_dep": "^1.0.0","outro_dep": "~2.2.0"},
Deixe uma resposta