Jak usunąć środowisko uruchomieniowe i zestaw SDK platformy .NET

Wraz z upływem czasu podczas instalowania zaktualizowanych wersji środowiska uruchomieniowego platformy .NET i zestawu SDK możesz usunąć nieaktualne wersje platformy .NET z maszyny. Usunięcie starszych wersji środowiska uruchomieniowego może zmienić środowisko uruchomieniowe wybrane do uruchamiania aplikacji platformy udostępnionej, zgodnie z opisem w artykule dotyczącym wyboru wersji platformy .NET.

Czy należy usunąć wersję?

Zachowania wyboru wersji platformy .NET i zgodność środowiska uruchomieniowego platformy .NET między aktualizacjami umożliwiają bezpieczne usuwanie poprzednich wersji. Aktualizacje środowiska uruchomieniowego platformy .NET są zgodne z głównym pasmem wersji, takim jak 6.x i 5.x. Ponadto nowsze wersje zestawu .NET SDK zwykle obsługują możliwość tworzenia aplikacji przeznaczonych dla poprzednich wersji środowiska uruchomieniowego w zgodny sposób.

Ogólnie rzecz biorąc, potrzebujesz tylko najnowszej wersji zestawu SDK i najnowszej wersji poprawek środowiska uruchomieniowego wymaganego dla aplikacji. Wystąpienia, w których można zachować starsze wersje zestawu SDK lub środowiska uruchomieniowego, obejmują obsługę aplikacji opartych na formacie project.json. Jeśli aplikacja nie ma określonych przyczyn wcześniejszych zestawów SDK lub środowisk uruchomieniowych, możesz bezpiecznie usunąć starsze wersje.

Określanie, co jest zainstalowane

Interfejs wiersza polecenia platformy .NET zawiera opcje umożliwiające wyświetlenie listy wersji zestawu SDK i środowiska uruchomieniowego zainstalowanego na komputerze. Użyj dotnet --list-sdks polecenia , aby wyświetlić listę zainstalowanych zestawów SDK i dotnet --list-runtimes listę środowisk uruchomieniowych. Aby uzyskać więcej informacji, zobacz Jak sprawdzić, czy platforma .NET jest już zainstalowana.

Odinstalowywanie platformy .NET

Platforma .NET używa okna dialogowego Funkcje aplikacji & systemu Windows do usuwania wersji środowiska uruchomieniowego platformy .NET i zestawu SDK. Na poniższej ilustracji przedstawiono okno dialogowe Funkcje aplikacji&. Możesz wyszukać rdzeń lub .net , aby filtrować i wyświetlać zainstalowane wersje platformy .NET.

Dodawanie/usuwanie programów w celu usunięcia platformy .NET

Wybierz wszystkie wersje, które chcesz usunąć z komputera, a następnie kliknij przycisk Odinstaluj.

Najlepszym sposobem odinstalowania platformy .NET jest dublowanie akcji użytej do zainstalowania platformy .NET. Specyfika zależy od wybranej dystrybucji systemu Linux i metody instalacji.

Ważne

W przypadku instalacji oprogramowania Red Hat zapoznaj się z dokumentacją produktu Red Hat dla platformy .NET.

Nie trzeba najpierw odinstalować zestawu SDK platformy .NET podczas uaktualniania go przy użyciu menedżera pakietów, chyba że uaktualniasz ją z wersji zapoznawczej, która została zainstalowana ręcznie. Menedżer update pakietów lub refresh polecenia automatycznie usunie starszą wersję po pomyślnej instalacji nowszej wersji. Jeśli masz zainstalowaną wersję zapoznawcza, odinstaluj ją.

Jeśli platforma .NET została zainstalowana przy użyciu menedżera pakietów, użyj tego samego menedżera pakietów, aby odinstalować zestaw .NET SDK lub środowisko uruchomieniowe. Instalacje platformy .NET obsługują najpopularniejszych menedżerów pakietów. Zapoznaj się z dokumentacją menedżera pakietów dystrybucji, aby uzyskać dokładną składnię w środowisku:

  • Apt-get(8) jest używany przez systemy oparte na debianie, w tym Ubuntu.
  • yum(8) jest używany w fedora, CentOS i Oracle Linux.
  • Program zypper(8) jest używany w systemach openSUSE i SUSE Linux Enterprise System (SLES).
  • System dnf(8) jest używany w usłudze Fedora.

W prawie wszystkich przypadkach polecenie usuwania pakietu to remove.

Nazwa pakietu instalacji zestawu .NET SDK dla większości menedżerów pakietów to dotnet-sdk, a następnie numer wersji. Począwszy od wersji 2.1.300 zestawu .NET SDK i wersji 2.1 środowiska uruchomieniowego, konieczne są tylko główne i pomocnicze numery wersji: na przykład zestaw .NET SDK w wersji 2.1.300 można odwoływać się jako pakiet dotnet-sdk-2.1. Wcześniejsze wersje wymagają całego ciągu wersji: na przykład dotnet-sdk-2.1.200 będzie wymagane dla wersji 2.1.200 zestawu .NET SDK.

W przypadku maszyn, które zainstalowały tylko środowisko uruchomieniowe, a nie zestaw SDK, nazwa pakietu jest dotnet-runtime-<version> przeznaczona dla środowiska uruchomieniowego platformy .NET i aspnetcore-runtime-<version> całego stosu środowiska uruchomieniowego.

Porada

Instalacje platformy .NET Core starsze niż 2.0 nie odinstalowywały aplikacji hosta, gdy zestaw SDK został odinstalowany przy użyciu menedżera pakietów. Za pomocą apt-getpolecenia polecenie to:

apt-get remove dotnet-host

Nie ma dołączonej wersji do dotnet-hostprogramu .

Jeśli zainstalowano przy użyciu narzędzia tarball, należy usunąć platformę .NET przy użyciu metody ręcznej.

W systemie Linux należy oddzielnie usunąć zestawy SDK i środowiska uruchomieniowe, usuwając katalogi z wersją. Te katalogi mogą się różnić w zależności od dystrybucji systemu Linux. Usunięcie ich powoduje usunięcie zestawu SDK i środowiska uruchomieniowego z dysku. Aby na przykład usunąć zestaw SDK 1.0.1 i środowisko uruchomieniowe, należy użyć następujących poleceń powłoki bash:

version="1.0.1"
sudo rm -rf /usr/share/dotnet/sdk/$version
sudo rm -rf /usr/share/dotnet/shared/Microsoft.NETCore.App/$version
sudo rm -rf /usr/share/dotnet/shared/Microsoft.AspNetCore.All/$version
sudo rm -rf /usr/share/dotnet/shared/Microsoft.AspNetCore.App/$version
sudo rm -rf /usr/share/dotnet/host/fxr/$version

Ważne

Foldery wersji mogą nie być zgodne z "wersją", którą odinstalowujesz. Poszczególne środowiska uruchomieniowe i zestawy SDK zainstalowane z pojedynczą wersją platformy .NET mogą mieć różne wersje. Na przykład być może zainstalowano środowisko uruchomieniowe ASP.NET Core 5, które zainstalowało środowisko uruchomieniowe 5.0.2 ASP.NET Core i środowisko uruchomieniowe 5.0.8 .NET. Każdy z nich ma inny folder z wersją. Aby uzyskać więcej informacji, zobacz Omówienie sposobu przechowywania wersji platformy .NET.

Katalogi nadrzędne dla zestawu SDK i środowiska uruchomieniowego są wyświetlane w danych wyjściowych polecenia dotnet --list-sdks i dotnet --list-runtimes , jak pokazano w poprzedniej tabeli.

Na komputerze Mac należy oddzielnie usunąć zestawy SDK i środowiska uruchomieniowe, usuwając katalogi z wersją. Usunięcie ich powoduje usunięcie zestawu SDK i środowiska uruchomieniowego z dysku. Aby na przykład usunąć zestaw SDK 1.0.1 i środowisko uruchomieniowe, należy użyć następujących poleceń powłoki bash:

version="1.0.1"
sudo rm -rf /usr/local/share/dotnet/sdk/$version
sudo rm -rf /usr/local/share/dotnet/shared/Microsoft.NETCore.App/$version
sudo rm -rf /usr/local/share/dotnet/shared/Microsoft.AspNetCore.All/$version
sudo rm -rf /usr/local/share/dotnet/shared/Microsoft.AspNetCore.App/$version
sudo rm -rf /usr/local/share/dotnet/host/fxr/$version

Ważne

Foldery wersji mogą nie być zgodne z "wersją", którą odinstalowujesz. Poszczególne środowiska uruchomieniowe i zestawy SDK zainstalowane na platformie .NET mogą mieć różne wersje. Na przykład można zainstalować środowisko uruchomieniowe platformy .NET 5, które zainstalowało środowisko uruchomieniowe 5.0.2 ASP.NET Core i środowisko uruchomieniowe 5.0.8 .NET. Aby uzyskać więcej informacji, zobacz Omówienie sposobu przechowywania wersji platformy .NET.

Ważne

Jeśli używasz komputera Mac opartego na usłudze Arm, takiego jak jeden z mikroukładem M1, zapoznaj się ze ścieżkami folderów opisanymi w temacie Instalowanie platformy .NET na komputerach Mac opartych na usłudze Arm.

Katalogi nadrzędne dla zestawu SDK i środowiska uruchomieniowego są wyświetlane w danych wyjściowych polecenia dotnet --list-sdks i dotnet --list-runtimes , jak pokazano w poprzedniej tabeli.

Narzędzie odinstalowywania platformy .NET

Narzędzie dezinstalacji platformy .NET (dotnet-core-uninstall) umożliwia usunięcie zestawów SDK i środowisk uruchomieniowych platformy .NET z systemu. Kolekcja opcji jest dostępna do określenia, które wersje mają zostać odinstalowane.

Zależność programu Visual Studio od wersji zestawu .NET SDK

Przed programem Visual Studio 2019 w wersji 16.3 instalatory programu Visual Studio nazywane instalatorem autonomicznego zestawu SDK dla platformy .NET Core w wersji 2.1 lub 2.2. W związku z tym wersje zestawu SDK są wyświetlane w oknie dialogowym Funkcje aplikacji & systemu Windows. Usunięcie zestawów SDK platformy .NET zainstalowanych przez program Visual Studio przy użyciu instalatora autonomicznego może spowodować przerwanie programu Visual Studio. Jeśli program Visual Studio ma problemy po odinstalowaniu zestawów SDK, uruchom polecenie Napraw dla tej konkretnej wersji programu Visual Studio. W poniższej tabeli przedstawiono niektóre zależności programu Visual Studio w wersjach zestawu .NET Core SDK:

Wersja programu Visual Studio Wersja zestawu SDK platformy .NET Core
Program Visual Studio 2019 w wersji 16.2 .NET Core SDK 2.2.4xx, 2.1.8xx
Visual Studio 2019 w wersji 16.1 .NET Core SDK 2.2.3xx, 2.1.7xx
Visual Studio 2019 w wersji 16.0 Zestaw .NET Core SDK 2.2.2xx, 2.1.6xx
Visual Studio 2017 w wersji 15.9 .NET Core SDK 2.2.1xx, 2.1.5xx
Visual Studio 2017 w wersji 15.8 Zestaw .NET Core SDK 2.1.4xx

Począwszy od programu Visual Studio 2019 w wersji 16.3, program Visual Studio jest odpowiedzialny za własną kopię zestawu .NET SDK. Z tego powodu te wersje zestawu SDK nie są już widoczne w oknie dialogowym Funkcje aplikacji&.

Usuwanie folderu rezerwowego Narzędzia NuGet

Przed zestawem SDK platformy .NET Core 3.0 instalatory zestawu SDK platformy .NET Core używały folderu o nazwie NuGetFallbackFolder do przechowywania pamięci podręcznej pakietów NuGet. Ta pamięć podręczna była używana podczas operacji, takich jak dotnet restore lub dotnet build /t:Restore. Folder NuGetFallbackFolder znajduje się w folderze C:\Program Files\dotnet\sdk w systemie Windows i w lokalizacji /usr/local/share/dotnet/sdk w systemie macOS.

Możesz usunąć ten folder, jeśli:

  • Programujesz tylko przy użyciu zestawu .NET Core 3.0 SDK lub .NET 5 lub nowszej wersji.
  • Programujesz przy użyciu zestawu .NET Core SDK w wersjach starszych niż 3.0, ale możesz pracować w trybie online.

Jeśli chcesz usunąć folder rezerwowy NuGet, możesz go usunąć, ale do tego celu będą potrzebne uprawnienia administracyjne.

Nie zaleca się usuwania folderu dotnet . Spowoduje to usunięcie wszystkich wcześniej zainstalowanych narzędzi globalnych. Ponadto w systemie Windows:

  • Przerwisz program Visual Studio 2019 w wersji 16.3 lub nowszej. Możesz uruchomić polecenie Napraw , aby odzyskać.
  • Jeśli w oknie dialogowym Funkcje funkcji & znajdują się wpisy zestawu .NET Core SDK, zostaną one oddzielone.