Resumo : neste tutorial, você aprenderá sobre o versionamento semântico para especificar a versão do seu pacote ou para instalar uma versão especificada de um pacote externo.
Introdução ao versionamento semântico em npm
Para tornar o ecossistema JavaScript mais confiável e seguro, você deve atualizar o número da versão no package.jsonarquivo que segue a especificação de versionamento semântico:
major.minor.patchLinguagem de código: JavaScript ( javascript )Por exemplo:
4.17.1Linguagem de código: JavaScript ( javascript )Nesta versão:
- A
majorversão é 4. - A
minorversão é 17. - O
patché 1.
Para uma versão especificada, você deve incrementar:
- A
majorversão quando você faz alterações que não são compatíveis com a versão anterior. - A
minorversão quando você adiciona um recurso compatível com versões anteriores. - A
pathversão quando você faz correções de bugs que são compatíveis com versões anteriores.
Se você desenvolver um novo pacote, a versão inicial deverá ser 1.0.0.
Ao fazer uma ou mais correções de bugs compatíveis com versões anteriores 1.0.0, você aumenta o terceiro dígito 1.0.1.
Ao introduzir novos recursos compatíveis com versões anteriores, você aumenta o dígito do meio e redefine o terceiro dígito para zero, como1.1.0
No entanto, quando você faz alterações que não são compatíveis com versões anteriores, você aumenta o primeiro dígito e redefine os dígitos do meio e do último para zero, por exemplo,2.0.0
versionamento semântico npm
A seguir explica-se como calcular o versionamento semântico.
1) Símbolo de quilate (também conhecido como chapéu) ^
Para incluir qualquer versão que seja superior a uma versão específica na mesma faixa principal , use o símbolo de quilate ( ^):
^1.10.1
Linguagem de código: JavaScript ( javascript )2) Símbolo til ~
Para incluir qualquer versão que seja superior a uma versão específica no mesmo intervalo menor , você usa o símbolo de til (~):
~1.5.12
Linguagem de código: JavaScript ( javascript )3) Operadores de comparação
Para especificar um intervalo de versões estáveis, você usa um dos operadores de comparação >, <, =, >=, <= :
>1.5Linguagem de código: JavaScript ( javascript )Ou você pode usar o hífen ( -) para especificar um intervalo:
1.0.0 - 1.5.0
Linguagem de código: JavaScript ( javascript )Observe que existem espaços em ambos os lados do hífen.
4) Versões de pré-lançamento
Para incluir uma versão de pré-lançamento, por exemplo, alfa e beta, você usa a tag de pré-lançamento:
1.0.0-alpha.1
Linguagem de código: JavaScript ( javascript )Para especificar um intervalo de versões de pré-lançamento, use a comparação como se >fosse uma tag de pré-lançamento:
>=1.0.0-alpha.0 <1.0.5
Linguagem de código: JavaScript ( javascript )5) Incluir vários conjuntos de versões
Para incluir vários conjuntos de versões, você usa || combinar. Por exemplo:
<1.2.0 || > 1.2.3Linguagem de código: JavaScript ( javascript )6) Use o xsímbolo
Use o xsímbolo para especificar qualquer versão. Por exemplo, 1.xcorresponde a qualquer versão com a versão principal, 1como 1.0.0, 1.1.2, 1.10.20, etc.
Instale um pacote com uma versão específica
Para instalar um pacote você usa o npm installcomando:
npm install <package_name>Linguagem de código: JavaScript ( javascript )Para instalar um pacote de versão especificada, você usa o @sinal:
npm install <package_name>@versionLinguagem de código: JavaScript ( javascript )O exemplo a seguir instala o expresspacote com a versão 4.x:
npm install express@4.xLinguagem de código: JavaScript ( javascript )Ele instalará o expresspacote com a versão mais recente, 4.xpor exemplo,4.17.1
Resumo
- npm usa a especificação de versionamento semântico com o formato
major.minor.patch.
