Fijar versiones y rangos

Un manifiesto declara rangos: «cualquier versión compatible con esta». Un archivo de bloqueo fija la versión exacta que se instaló la última vez. Cuando alguien instala desde el bloqueo, obtiene siempre lo mismo; cuando se instala sin él, el gestor puede resolver versiones nuevas dentro del rango.

Por eso, en una aplicación, la versión que de verdad corre en producción es la del bloqueo, no la del rango. Y por eso un PR de actualización suele cambiar el archivo de bloqueo (y, si el rango ya no admite la versión nueva, también el manifiesto).

En npm y en gestores con la misma notación: una versión exacta (1.4.2) admite solo esa; el acento circunflejo (^2.3.0) admite cambios que no modifican la primera cifra distinta de cero, es decir, hasta antes de la 3.0.0 para ese rango y hasta antes de la 0.10.0 para un ^0.9.0; la tilde (~3.1.0) admite solo cambios de parche, hasta antes de la 3.2.0; y >=1.0.0 admite todo lo que sea igual o superior, sin tope.

Con esa regla, compara el rango declarado de cada paquete con la última versión publicada. Un rango que no admite la última publicada significa que el robot tendrá que cambiar el manifiesto, no solo el bloqueo.

Un rango con >= y sin límite superior admite cualquier versión futura, incluidos los saltos mayores que pueden romper compatibilidad. En una aplicación con bloqueo el daño queda contenido, porque la versión real es la del archivo. Pero el manifiesto deja de decir qué versiones se han probado, y cualquier instalación sin bloqueo puede traer un salto mayor sin que nadie lo haya decidido.

Cuando hablas de qué versión usa un servicio, la respuesta honesta sale del archivo de bloqueo, no del manifiesto. Esa es la versión que se instala y la que hay que cruzar con un aviso de seguridad.

Consulta la tabla y averigua qué versión exacta de cliente-flota queda instalada.

La tabla de proyectos distingue dos tipos. Una aplicación se despliega tal cual, con su bloqueo, así que le conviene fijar con precisión y actualizar con intención. Una biblioteca la instalan otros proyectos: si fija versiones exactas, obliga a todos sus consumidores a usar exactamente esas, y puede provocar conflictos entre dependencias; por eso suele declarar rangos más amplios y probar contra varias versiones.