Przywracanie nie wyszukuje folderu pakietów globalnych dla nowszej wersji pakietu

Gdy element PackageReference lub zależność pakietu żąda wersji pakietu, która nie istnieje, mechanizm przywracania NuGet wyszukuje najniższą wersję wyższą niż żądana. Przywracanie pakietów NuGet nie uwzględnia już wersji w folderze pakietów globalnych podczas tego wyszukiwania.

Wersja wprowadzona

.NET 11 RC 1

Poprzednie zachowanie

Wcześniej, gdy przywracanie nie może odnaleźć żądanej wersji, przeszukało zarówno źródła pakietów, jak i folder pakietów globalnych dla "następnej najlepszej" wersji, czyli najniższą wersję, która jest wyższa niż żądana wersja. Przywrócono tę wybraną wersję i zostało zgłoszone ostrzeżenie NU1603. Jeśli nie znaleziono wyższej wersji, przywracanie zgłosiło błąd NU1102.

Źródło pakietu Folder pakietów globalnych Żądana wersja Wybrana wersja Rezultat przywracania
1.0.0, 2.0.0 1.5.0 1.1.0 1.5.0 Ostrzeżenie NU1603
1.0.0 1.5.0 1.1.0 1.5.0 Ostrzeżenie NU1603

Nowe zachowanie

Począwszy od .NET 11, przywracanie wyszukuje tylko źródła pakietów dla "następnej najlepszej" wersji. Ponieważ folder pakietów globalnych jest wykluczony z wyszukiwania, przywracanie może wybrać wyższą wersję niż poprzednio lub zakończyć się niepowodzeniem z powodu błędu NU1102 , jeśli żadne źródło pakietu nie ma wyższej wersji.

Źródło pakietu Folder pakietów globalnych Żądana wersja Wybrana wersja Wynik przywracania
1.0.0, 2.0.0 1.5.0 1.1.0 2.0.0 Ostrzeżenie NU1603
1.0.0 1.5.0 1.1.0 n/a Błąd NU1102

Jeśli folder pakietów globalnych zawiera dokładnie żądaną wersję, operacja przywracania używa tej wersji, nawet jeśli żadne źródło pakietów nie zawiera tej wersji. To zachowanie pozostaje niezmienione.

Typ zmiany przełamującej

Ta zmiana może mieć wpływ na zgodność źródła.

Przyczyna zmiany

Przywracanie jest teraz bardziej deterministyczne i powtarzalne. Ze względu na wydajność pakiet NuGet nie weryfikuje, czy pakiety w folderze pakietów globalnych są zgodne z pakietami w źródłach pakietów. Jednak przywracanie teraz wybiera tę samą wersję pakietu na różnych komputerach, na których folder pakietów globalnych może zawierać różne wersje.

Odwołuj się tylko do wersji pakietów, które istnieją w źródłach pakietów. Dzięki temu wersja wybrana podczas przywracania nie zmienia się wraz z upływem czasu, ponieważ nowe wersje są publikowane w źródłach pakietów.

Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące bezpiecznego łańcucha dostaw oprogramowania.

Interfejsy API, których dotyczy problem

None.