Versionsbegrænsninger og lockfilen

En versionsbegrænsning fortæller pub, hvilke udgivelser af en pakke dit projekt accepterer. Den afvejer muligheden for at få rettelser mod risikoen for ændringer, der ødelægger noget. 🎯

Dart-pakker følger semantisk versionering: major.minor.patch. En ændring af major-versionen signalerer ændringer, der bryder kompatibiliteten; minor tilføjer funktioner, og patch retter fejl.

Caret-begrænsningen ^1.2.0 accepterer alt fra 1.2.0 til, men ikke inklusive, 2.0.0. Det er den venlige standard, som pub bruger.

Hvis du kun skriver et tal, betyder det præcis denne version og ingen anden. Brug det sparsomt, når du har brug for én bestemt, kendt udgivelse.

Du kan angive et interval med sammenligningsoperatorer. Det giver dig præcis kontrol over både den nedre og øvre grænse.

Hvis du bruger any, accepteres alle versioner. Det er risikabelt, fordi en fremtidig major-udgivelse kan ødelægge din kode, så foretræk i stedet caret.

Når pub løser dine afhængigheder, registrerer den de præcise valgte versioner i pubspec.lock. Denne fil fastlåser det, som alle faktisk installerer.

Lockfilen garanterer reproducerbare builds: En kollega, der kører pub get, får præcis de samme versioner, som du testede, og ikke uventede opgraderinger.

For apps skal du committe pubspec.lock til versionsstyringen. For genanvendelige pakker skal du udelade den, så brugerne selv løser versionerne.

Kør dart pub upgrade for at opdatere pubspec.lock til de nyeste versioner, som dine begrænsninger tillader. En almindelig get bevarer de eksisterende fastlåsninger.

Hvis to pakker kræver inkompatible versioner, rapporterer pub en konflikt. Derefter kan du gøre en begrænsning mindre stram eller vælge kompatible pakkeversioner.

Du kan nu læse begrænsninger som caret og intervaller, og du ved, at pubspec.lock fastlåser præcise versioner for reproducerbare builds uden konflikter. 🎉