Vincoli di versione e lockfile

Un version constraint indica a pub quali release di un package il progetto accetta. Consente di bilanciare la ricezione delle correzioni con l'evitare modifiche incompatibili. 🎯

I package Dart seguono il semantic versioning: major.minor.patch. Un aumento della major segnala modifiche incompatibili, la minor aggiunge funzionalità e la patch corregge bug.

Il caret ^1.2.0 accetta qualsiasi versione da 1.2.0 fino, ma esclusa, alla 2.0.0. È l'impostazione predefinita flessibile usata da pub.

Scrivere un semplice numero significa indicare esattamente quella versione, e nessun'altra. Lo usi con moderazione quando serve una singola release nota.

Può specificare un range con gli operatori di confronto. In questo modo ottiene un controllo preciso sia sul limite inferiore sia su quello superiore.

Usare any accetta qualsiasi versione. È rischioso perché una futura release major potrebbe creare problemi; preferisca quindi un caret.

Quando pub risolve le dipendenze, registra le versioni esatte scelte in pubspec.lock. Questo file blocca ciò che viene effettivamente installato da tutti.

Il lockfile garantisce build reproducible: un collega che esegue pub get ottiene esattamente le stesse versioni da Lei testate, senza aggiornamenti imprevisti.

Per le app, esegua il commit di pubspec.lock nel controllo versione. Per i package riutilizzabili, lo escluda, così saranno i consumatori a risolvere le versioni.

Esegua dart pub upgrade per aggiornare pubspec.lock alle versioni più recenti consentite dai vincoli. Un semplice get mantiene i blocchi esistenti.

Se due package richiedono versioni incompatibili, pub segnala un conflict. Dovrà quindi allentare un vincolo o scegliere versioni compatibili dei package.

Ora sa leggere constraints come caret e intervalli e sa che pubspec.lock blocca le versioni esatte per build riproducibili e prive di conflitti. 🎉