Rozwiązywanie wersji
Artefakty katalogu — Components, Features, Recipes, FeatureRecipes, Plugins
i Aggregates — mają pole metadata.version, a katalog może jednocześnie zawierać więcej niż
jedną wersję tego samego artefaktu. Gdy coś odwołuje się do artefaktu,
odwołanie wybiera, której wersji użyć. Ta strona opisuje, jak działa
ten wybór.
Odwoływanie się do wersji
Odwołanie to URI typu artefaktu, opcjonalnie przypięte do wersji. Akceptowane są trzy formy:
| Forma | Przykład | Wybiera |
|---|---|---|
| Dokładna | core/datastore/mariadb:1.2.0 | dokładnie tę wersję |
| Zakres (daszek) | core/datastore/mariadb:^1.2.0 | najwyższą wersję >= 1.2.0 i < 2.0.0 |
| Bez wersji | core/datastore/mariadb | najwyższą dostępną wersję |
Forma z daszkiem stosuje konwencję zgodności w obrębie wersji głównej, znaną z npm, Cargo i modułów Go. W każdej formie rozwiązywanie wybiera najwyższą wersję, która spełnia odwołanie, preferując wersje stabilne przed przedpremierowymi. Dokładne odwołanie pozwala zrezygnować z automatycznego wyboru i przypiąć jedną wersję.
Determinizm
Wybór odbywa się raz, podczas blokowania zależności. Plik blokady zapisuje wersję wybraną przez odwołanie — odwołanie zakresowe jest zapisywane jako wersja, do której zostało rozwiązane, nigdy jako zakres — wraz z odciskiem treści obliczonym na podstawie własnego dokumentu tej wersji, a każda późniejsza kompilacja odtwarza dokładnie ten sam artefakt z tego zapisu — dzięki temu pojawienie się nowszej wersji w katalogu nigdy po cichu nie zmienia kompilacji, która została już zablokowana. Ponowne blokowanie jest jawną czynnością.
Ta sama reguła obowiązuje niezależnie od tego, gdzie znajduje się katalog: lokalna kopia katalogu i rejestr rozwiązują odwołanie do tej samej wersji. Jest to też ta sama reguła dla każdego polecenia, które odczytuje katalog. Pobranie, które zapisuje plik blokady, kompilacja, która go odczytuje, walidacja, edytor i narzędzia dla asystenta wybierają tę samą wersję z jednego katalogu, bez względu na to, ile wersji danej nazwy zawierają jego katalogi, a sprawdzenie pliku blokady podczas kompilacji porównuje wybraną wersję z wersją zapisaną przy pobraniu.
Zależności bibliotek
Biblioteki schematów i mapowań wielokrotnego użytku (SchemaLibrary, MappingLibrary) są rozwiązywane inaczej: stosują minimalny wybór wersji — najniższą wersję, która spełnia wszystkie ograniczenia w całym obszarze roboczym — ponownie zgodnie z modułami Go. Dzięki temu aktualizacje bibliotek są przemyślane, a nie automatyczne.
Gdy nic nie spełnia odwołania
Jeśli odwołanie przypina wersję lub zakres, którego nie spełnia żadna dostępna wersja —
na przykład :^2.0.0, gdy istnieją tylko wersje 1.x — rozwiązywanie kończy się
błędem podającym odwołanie w zapisanej postaci, artefakt wraz z ograniczeniem, zamiast
po cichu przejść na inną wersję. Pobranie i walidacja tej samej
encji Release odrzucają je tymi samymi słowami. Rozwiązywanie zależności encji Release zgłasza
artefakt, który w ogóle nie istnieje, również tymi samymi słowami, ponieważ odwołanie
i tak niczego nie dopasowało — dlatego należy przeczytać obie części odwołania podanego w błędzie.