Restricciones de versión y lockfile

Una version constraint indica a pub qué versiones de un paquete acepta el proyecto. Equilibra la obtención de correcciones con la prevención de cambios incompatibles. 🎯

Los paquetes de Dart siguen el semantic versioning: major.minor.patch. Un incremento de major indica cambios incompatibles; minor añade funciones y patch corrige errores.

El caret ^1.2.0 acepta cualquier versión desde 1.2.0 hasta antes de 2.0.0. Es la opción predeterminada flexible que utiliza pub.

Escribir únicamente un número significa exactly esa versión, y ninguna otra. Utilícelo con moderación cuando necesite una única versión conocida.

Puede especificar un range mediante operadores de comparación. Esto le proporciona un control preciso sobre los límites inferior y superior.

Usar any acepta todas las versiones. Es arriesgado porque una futura versión major podría romper el código, así que es preferible utilizar caret.

Cuando pub resuelve sus dependencias, registra las versiones exactas elegidas en pubspec.lock. Este archivo fija lo que realmente instala cada persona.

El lockfile garantiza compilaciones reproducible: cuando un compañero ejecuta pub get, obtiene exactamente las mismas versiones que usted probó, sin actualizaciones inesperadas.

En las aplicaciones, incluya commit pubspec.lock en el control de versiones. En los paquetes reutilizables, omítalo para que los consumidores resuelvan las versiones por su cuenta.

Ejecute dart pub upgrade para actualizar pubspec.lock a las versiones más recientes permitidas por sus restricciones. Un get normal conserva las versiones fijadas existentes.

Si dos paquetes exigen versiones incompatibles, pub informa de un conflict. Entonces deberá flexibilizar una restricción o elegir versiones compatibles de los paquetes.

Ahora puede interpretar constraints como caret e intervalos, y sabe que pubspec.lock fija versiones exactas para obtener compilaciones reproducibles y sin conflictos. 🎉