Sobre el versionado semántico
On diciembre 9, 2021 by adminPara mantener el ecosistema de JavaScript sano, fiable y seguro, cada vez que realice actualizaciones significativas en un paquete npm de su propiedad, recomendamos publicar una nueva versión del paquete con un número de versión actualizado en el archivo package.json
que sigue la especificación de versionado semántico. Seguir la especificación semántica de versiones ayuda a otros desarrolladores que dependen de su código a entender el alcance de los cambios en una versión dada, y a ajustar su propio código si es necesario.
Incrementar las versiones semánticas en los paquetes publicados
Para ayudar a los desarrolladores que dependen de su código, recomendamos comenzar la versión de su paquete en 1.0.0
e incrementarla como sigue:
Estado del código | Etapa | Regla | Versión de ejemplo |
---|---|---|---|
Primera versión | Nuevo producto | Comienza con 1.0.0 | 1.0.0 |
Corrección de errores compatibles con la versión anterior | Lanzamiento de un parche | Aumentar el tercer dígito | 1.0.1 |
Nuevas características compatibles con la versión anterior | Lanzamiento menor | Aumentar el dígito del medio y poner a cero el último dígito | 1.1.0 |
Cambios que rompen la compatibilidad con versiones anteriores | Lanzamiento mayor | Aumentar el primer dígito y poner a cero los dígitos centrales y el último | 2.0.0 |
Utilizar el versionado semántico para especificar los tipos de actualización que su paquete puede aceptar
Puede especificar los tipos de actualización que su paquete puede aceptar de las dependencias en el archivo package.json
de su paquete.
Por ejemplo, para especificar rangos de versiones aceptables hasta la 1.0.4, utilice la siguiente sintaxis:
- Lanzamientos de parches:
1.0
o1.0.x
o~1.0.4
- Las versiones menores:
1
o1.x
o^1.0.4
- Lanzamientos mayores:
*
ox
Para más información sobre la sintaxis del versionado semántico, consulte la calculadora npm semver.
Ejemplo
"dependencias": {"mi_dep": "^1.0.0","otro_dep": "~2.2.0"},
Deja una respuesta