Ограничения версий и lock-файл

Ограничение версии сообщает pub, какие выпуски пакета принимает проект. Оно помогает получать исправления и одновременно избегать несовместимых изменений. 🎯

Пакеты Dart используют семантическое версионирование: major.minor.patch. Увеличение major означает несовместимые изменения, minor добавляет функции, а patch исправляет ошибки.

Каретка caret ^1.2.0 принимает любую версию от 1.2.0 включительно до 2.0.0 не включительно. Это стандартный удобный вариант, который использует pub.

Если записать только число, это означает точно указанную версию и никакую другую. Используйте такой вариант редко, когда нужен один конкретный проверенный выпуск.

Диапазон можно явно записать с помощью операторов сравнения. Это даёт точный контроль над нижней и верхней границами.

Использование any принимает любую версию. Это рискованно: будущий выпуск major может нарушить работу, поэтому лучше предпочесть каретку.

Когда pub разрешает зависимости, он записывает выбранные точные версии в pubspec.lock. Этот файл фиксирует то, что фактически устанавливают все пользователи.

Lock-файл гарантирует воспроизводимые сборки: участник команды, выполнивший pub get, получит те же версии, которые тестировали Вы, а не неожиданные обновления.

Для приложений добавляйте commit pubspec.lock в систему контроля версий. Для повторно используемых пакетов не добавляйте его, чтобы потребители разрешали версии самостоятельно.

Выполните dart pub upgrade, чтобы обновить pubspec.lock до самых новых версий, разрешённых ограничениями. Обычная команда get сохраняет существующие фиксации.

Если два пакета требуют несовместимые версии, pub сообщает о конфликте. Затем ослабьте ограничение или выберите совместимые версии пакетов.

Теперь Вы умеете читать ограничения, такие как каретка и диапазоны, и знаете, что pubspec.lock фиксирует точные версии для воспроизводимых сборок без конфликтов. 🎉