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