Referencia rápida

Chuleta de Versionado Semántico (SemVer)

Guía de referencia rápida de Semantic Versioning: incrementos MAJOR.MINOR.PATCH, etiquetas de pre-lanzamiento y rangos de gestores de paquetes.

· Publicado

Semantic Versioning (SemVer) define una especificación formal para asignar e incrementar números de versión de software: MAJOR.MINOR.PATCH.

Los Tres Componentes

$$\text{Version} = \text{MAJOR}.\text{MINOR}.\text{PATCH}$$

  1. MAJOR (1.0.0 -> 2.0.0): Cambios incompatibles que rompen la API.
  2. MINOR (1.0.0 -> 1.1.0): Nuevas funcionalidades compatibles hacia atrás.
  3. PATCH (1.0.0 -> 1.0.1): Correcciones de errores compatibles hacia atrás.

Pre-lanzamientos y Metadatos de Compilación

1.0.0-alpha
1.0.0-alpha.1
1.0.0-beta.2
1.0.0-rc.1
1.0.0+20261108   # Metadatos de compilación (+se ignoran en la precedencia)

Orden de precedencia: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.


Especificadores de Rango de Gestores de Paquetes

Rango Versiones Incluidas Descripción
1.2.3 1.2.3 Coincidencia exacta de versión
>1.2.3 1.2.4, 2.0.0, ... Mayor que
>=1.2.0 <1.3.0 1.2.0 up to 1.2.9 Rango acotado
~1.2.3 >=1.2.3 <1.3.0 Razonablemente cercano (permite solo parches)
^1.2.3 >=1.2.3 <2.0.0 Compatible (permite lanzamientos minor y patch)
^0.2.3 >=0.2.3 <0.3.0 En 0.x.x, un lanzamiento minor rompe compatibilidad
* Any version Comodín sin restricciones

Referencias

Temas relacionados