Ograniczenia wersji i plik blokady

version constraint informuje pub, które wydania pakietu projekt akceptuje. Pozwala to równoważyć pobieranie poprawek z unikaniem zmian powodujących niezgodność. 🎯

Pakiety Dart stosują semantic versioning: major.minor.patch. Zwiększenie numeru major sygnalizuje zmiany powodujące niezgodność, minor oznacza dodanie funkcji, a patch — poprawki błędów.

Ograniczenie caret ^1.2.0 akceptuje dowolną wersję od 1.2.0 do wersji niższej niż 2.0.0. Jest to przyjazne ustawienie domyślne używane przez pub.

Podanie samego numeru oznacza exactly tę wersję i żadnej innej. Używaj tego oszczędnie, gdy potrzebujesz jednego konkretnego, sprawdzonego wydania.

Możesz określić range za pomocą operatorów porównania. Daje to precyzyjną kontrolę zarówno nad dolną, jak i górną granicą.

Użycie any akceptuje każdą wersję. Jest to ryzykowne, ponieważ przyszłe wydanie major może spowodować niezgodność, dlatego lepiej użyć caret.

Podczas rozwiązywania zależności pub zapisuje dokładnie wybrane wersje w pliku pubspec.lock. Ten plik przypina wersje faktycznie instalowane przez wszystkich.

Plik blokady gwarantuje reproducible kompilacje: osoba z zespołu uruchamiająca pub get otrzyma dokładnie te same wersje, które zostały przetestowane, a nie nieoczekiwane aktualizacje.

W przypadku aplikacji commit plik pubspec.lock do systemu kontroli wersji. W przypadku pakietów wielokrotnego użytku pomiń go, aby użytkownicy mogli samodzielnie rozwiązywać wersje.

Uruchom dart pub upgrade, aby odświeżyć pubspec.lock do najnowszych wersji dozwolonych przez ograniczenia. Zwykłe get zachowuje istniejące przypięte wersje.

Jeśli dwa pakiety wymagają niezgodnych wersji, pub zgłosi conflict. Następnie należy poluzować ograniczenie albo wybrać zgodne wersje pakietów.

Na jakie wersje pozwala ograniczenie ^1.2.0?

Potrafisz już odczytywać constraints, takie jak caret i zakresy, oraz wiesz, że pubspec.lock przypina dokładne wersje, zapewniając powtarzalne kompilacje bez konfliktów. 🎉