Aktualizowanie śledzonych instalacji .NET za pomocą narzędzia dotnetup

Uwaga

dotnetup jest dostępna w publicznej wersji zapoznawczej. Jego funkcje i zachowanie mogą ulec zmianie przed ogólną dostępnością.

dotnetup przechowuje żądany kanał oddzielnie od ustalonej wersji. Aktualizacja ponownie naprawia każdy kanał aktualizacji.

Wybieranie zakresu aktualizacji

Użyj jednego z następujących poleceń:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

Aktualizacje środowiska uruchomieniowego obejmują środowiska uruchomieniowe .NET Core i ASP.NET Core. W systemie Windows obejmują one również wymagania środowiska uruchomieniowego Windows Desktop.

Ogranicz katalog główny instalacji

Domyślnie aktualizacja może przetwarzać wymagania dotyczące wszystkich korzeni w wybranym manifeście. Użyj --install-path, aby ograniczyć operację:

dotnetup update --install-path D:\tools\dotnet

Zaktualizuj pliki repozytorium

Wymagania dotyczące zestawu SDK mogą pochodzić z global.json. Aby zapisać nowo określoną wersję zestawu SDK z powrotem do każdego pliku źródłowego, uruchom polecenie:

dotnetup sdk update --update-global-json

Bez tej opcji dotnetup instaluje aktualizację, ale nie edytuje pliku repozytorium.

Aktualizacja przetwarza przechowywane wymagania, zanim odśmiecanie odświeży zmienione global.json źródła. Po zmianie global.json repozytorium uruchom polecenie dotnetup sdk install z tego repozytorium przed zaktualizowaniem przechowywanych wymagań. W przeciwnym razie pierwsza aktualizacja może nadal przetwarzać poprzednie wymaganie.

Zrozum działanie aktualizacji

  • Dokładne wersje zestawu SDK i środowiska uruchomieniowego są pomijane — zostały jawnie żądane, więc nigdy nie można ich zaktualizować.
  • Każde wymaganie instalacji jest przetwarzane niezależnie.
  • Przetwarzanie wszystkich wymagań dotyczących instalacji jest kontynuowane po wystąpieniu pojedynczego błędu.
  • Polecenie zgłasza błąd po przetworzeniu wszystkich pozostałych wymagań dotyczących instalacji.
  • Pomyślne aktualizacje uruchamiają odśmiecanie pamięci — proces oczyszczania, który usuwa wszystkie zainstalowane składniki, których nie wymagają żadne ze skonfigurowanych wymagań instalacyjnych.
  • Zainstalowana wersja pozostaje, jeśli inne wymaganie nadal jej wymaga.

Przejrzyj wynik

Sprawdź stan śledzony i instalacje na dysku:

dotnetup list

Dane wyjściowe czytelne maszynowo:

dotnetup list --format json

Informacje dodatkowe

  • Ostatnia aktualizacja o