Разрешение версий
Артефакты каталога — Components, Features, Recipes, FeatureRecipes, Plugins
и Aggregates — содержат metadata.version, и каталог может одновременно хранить несколько
версий одного и того же артефакта. Когда что-либо ссылается на артефакт,
ссылка определяет, какую версию использовать. На этой странице описано, как работает
этот выбор.
Ссылка на версию
Ссылка — это URI типа артефакта, при необходимости закреплённый за версией. Допускаются три формы:
| Форма | Пример | Выбирает |
|---|---|---|
| Точная | core/datastore/mariadb:1.2.0 | именно эту версию |
| Диапазон (каретка) | core/datastore/mariadb:^1.2.0 | наибольшую версию >= 1.2.0 и < 2.0.0 |
| Без версии | core/datastore/mariadb | наибольшую доступную версию |
Форма с кареткой следует соглашению о совместимости по мажорной версии, знакомому по npm, Cargo и модулям Go. В любой форме разрешение выбирает наибольшую версию, которая удовлетворяет ссылке, предпочитая стабильные выпуски предварительным. Точная ссылка — способ отказаться от автоматического выбора и закрепить одну версию.
Детерминированность
Выбор выполняется один раз, при фиксации зависимостей. Lock-файл записывает версию, выбранную ссылкой, — ссылка на диапазон записывается как версия, в которую она разрешилась, а не как диапазон, — вместе с отпечатком содержимого, снятым с собственного документа этой версии, и каждая последующая сборка воспроизводит в точности тот же артефакт по этой записи, поэтому появление в каталоге более новой версии никогда незаметно не изменяет уже зафиксированную сборку. Повторная фиксация — явное действие.
Одно и то же правило действует независимо от того, где находится каталог: локальная копия каталога и реестр разрешают ссылку в одну и ту же версию. Это же правило действует для каждой команды, читающей каталог. Pull, записывающий lock-файл, сборка, читающая его, validate, редактор и инструменты для ассистента выбирают из одного каталога одну и ту же версию, сколько бы версий одного имени ни содержали его каталоги, а проверка lock-файла при сборке сравнивает выбранную ею версию с той, которую записал pull.
Зависимости библиотек
Переиспользуемые библиотеки схем и сопоставлений (SchemaLibrary, MappingLibrary) разрешаются иначе: они используют выбор минимальной версии — наименьшую версию, которая удовлетворяет всем ограничениям в рабочем пространстве, — опять же как в модулях Go. Благодаря этому обновление библиотек остаётся осознанным, а не автоматическим.
Когда ссылке ничего не удовлетворяет
Если ссылка закрепляет версию или диапазон, которым не удовлетворяет ни одна доступная версия, —
например, :^2.0.0, когда существуют только версии 1.x, — разрешение останавливается с
ошибкой, называющей ссылку в том виде, в каком она написана, — артефакт и ограничение вместе, — а не
незаметно переключается на другую версию. Pull и validate одной и той же
сущности Release отклоняют её одними и теми же словами. При разрешении зависимостей сущности Release
артефакт, которого вообще не существует, сообщается теми же словами, поскольку ссылка
в обоих случаях ничему не соответствует, — поэтому проверяйте обе половины ссылки, названной в ошибке.