Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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:

FormaPrzykładWybiera
Dokładnacore/datastore/mariadb:1.2.0dokładnie tę wersję
Zakres (daszek)core/datastore/mariadb:^1.2.0najwyższą wersję >= 1.2.0 i < 2.0.0
Bez wersjicore/datastore/mariadbnajwyż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.