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.json
arquivo que segue a especificação de versionamento semântico:
major.minor.patch
Linguagem de código: JavaScript ( javascript )
Por exemplo:
4.17.1
Linguagem de código: JavaScript ( javascript )
Nesta versão:
- A
major
versão é 4. - A
minor
versão é 17. - O
patch
é 1.
Para uma versão especificada, você deve incrementar:
- A
major
versão quando você faz alterações que não são compatíveis com a versão anterior. - A
minor
versão quando você adiciona um recurso compatível com versões anteriores. - A
path
versã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.5
Linguagem 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.3
Linguagem de código: JavaScript ( javascript )
6) Use o x
símbolo
Use o x
símbolo para especificar qualquer versão. Por exemplo, 1.x
corresponde a qualquer versão com a versão principal, 1
como 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 install
comando:
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>@version
Linguagem de código: JavaScript ( javascript )
O exemplo a seguir instala o express
pacote com a versão 4.x
:
npm install express@4.x
Linguagem de código: JavaScript ( javascript )
Ele instalará o express
pacote com a versão mais recente, 4.x
por exemplo,4.17.1
Resumo
- npm usa a especificação de versionamento semântico com o formato
major.minor.patch
.