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 usunięcie 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 utrzymują 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 pliku project.json. Jeśli aplikacja nie ma określonych powodów dla wcześniejszych zestawów SDK lub środowisk uruchomieniowych, możesz bezpiecznie usunąć starsze wersje.

Określanie, co jest zainstalowane

Interfejs wiersza polecenia platformy .NET umożliwia wyświetlenie listy wersji zestawu SDK i środowiska uruchomieniowego zainstalowanych na komputerze. Użyj polecenia dotnet --list-sdks , 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 funkcji Windows Apps&, aby usunąć wersje środowiska uruchomieniowego platformy .NET i zestawu SDK. Na poniższej ilustracji przedstawiono okno dialogowe Funkcje aplikacji&. Aby filtrować i wyświetlać zainstalowane wersje platformy .NET, możesz wyszukać rdzeń lub platformę .net .

Add / Remove programs to remove .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. Szczegóły zależą 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 z wersji zapoznawczej, która została zainstalowana ręcznie. Menedżer update pakietów lub refresh polecenia automatycznie usuwają starszą wersję po pomyślnej instalacji nowszej wersji. Jeśli masz zainstalowaną wersję zapoznawcza, odinstaluj ją.

Jeśli zainstalowano platformę .NET 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 danym środowisku:

W prawie wszystkich przypadkach polecenie usunięcia pakietu to remove.

Nazwa pakietu instalacji zestawu .NET SDK dla większości menedżerów pakietów to dotnet-sdk, a po nim numer wersji. Począwszy od wersji 2.1.300 zestawu .NET SDK i wersji 2.1 środowiska uruchomieniowego, wymagane są tylko numery wersji głównej i pomocniczej: na przykład zestaw SDK platformy .NET 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 w wersji 2.1.200 zestawu .NET SDK.

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

Porada

Instalacje platformy .NET Core wcześniejsze 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 program został zainstalowany 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 wersji. 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 instalowane w jednej wersji 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 platformy .NET 5.0.8. Każdy z nich ma inny folder w wersji. 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 wersji. 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 instalowane przy użyciu platformy .NET mogą mieć różne wersje. Na przykład być może zainstalowano ś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 komputer 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 do odinstalowywania platformy .NET

Narzędzie do odinstalowywania platformy .NET (dotnet-core-uninstall) umożliwia usuwanie zestawów .NET SDK i środowisk uruchomieniowych z systemu. Dostępna jest kolekcja opcji umożliwiających określenie, które wersje mają zostać odinstalowane.

zależność Visual Studio od wersji zestawu SDK platformy .NET

Przed Visual Studio 2019 w wersji 16.3 instalatory Visual Studio nazywane autonomicznym instalatorem 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 funkcji Windows Apps&. Usunięcie zestawów SDK platformy .NET zainstalowanych przez Visual Studio przy użyciu autonomicznego instalatora może spowodować przerwanie Visual Studio. Jeśli Visual Studio występują problemy po odinstalowaniu zestawów SDK, uruchom polecenie Napraw dla tej konkretnej wersji Visual Studio. W poniższej tabeli przedstawiono niektóre zależności Visual Studio w wersjach zestawu .NET Core SDK:

Wersja programu Visual Studio Wersja zestawu .NET Core SDK
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 .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 wersji Visual Studio 2019 w wersji 16.3, Visual Studio jest odpowiedzialna za własną kopię zestawu .NET SDK. Z tego powodu nie widzisz już tych wersji zestawu SDK w oknie dialogowym Funkcje aplikacji&.

Usuwanie folderu rezerwowego 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 została użyta podczas operacji, takich jak dotnet restore lub dotnet build /t:Restore. Folder NuGetFallbackFolder znajduje się w folderze C:\Program Files\dotnet\sdk w 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 musisz mieć do tego uprawnienia administracyjne.

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

  • Przerwiesz Visual Studio 2019 w wersji 16.3 lub nowszej. Aby odzyskać odzyskiwanie, możesz uruchomić polecenie Napraw .
  • Jeśli w oknie dialogowym Funkcje aplikacji & znajdują się wpisy zestawu SDK platformy .NET Core, zostaną one oddzielone.