.NET Conf

Odinstalowywanie platformy .NET Framework oraz jej nowszych wersji – takich jak .NET Core czy .NET 5+ – wymaga szczególnej ostrożności, precyzji oraz znajomości unikalnych cech każdego systemu operacyjnego. Niewłaściwe działania mogą wpływać na stabilność lub działanie zainstalowanych aplikacji. Windows udostępnia wiele narzędzi i metod, od standardów systemowych po specjalistyczne narzędzia Microsoft i ręczną edycję komponentów. Z kolei na macOS procedura jest bardziej techniczna, z wykorzystaniem terminala i znajomości struktur katalogów, a na Linuxie, każdy z menedżerów pakietów wymaga osobnego podejścia. Każdy system potrzebuje dopasowanej metody usuwania oraz uwzględnienia zależności międzysystemowych.

Spis treści [odkryj]

Fundamenty platformy .NET i jej warianty

Rozwój platformy .NET przekształcił sposób instalowania i odinstalowywania komponentów na różnych systemach operacyjnych. Oto najważniejsze różnice w wariantach .NET:

  • .net framework głęboko zintegrowany z Windowsem,
  • .net core umożliwiający wieloplatformową równoległą instalację różnych wersji,
  • .net 5, 6, 7 i 8 skupione na jeszcze większej elastyczności.

Wyróżnienie między SDK (Software Development Kit) i Runtime jest kluczowe dla bezpiecznego usuwania:

  • sdk zawiera narzędzia programistyczne, kompilatory i biblioteki do pisania kodu,
  • runtime to minimum wymagane do uruchamiania aplikacji .NET,
  • niektóre wersje są instalowane wraz z Visual Studio lub narzędziami deweloperskimi.

Wielowersyjność jest dzisiaj standardem – często na jednym sprzęcie obecnych jest kilka wersji .NET. Do identyfikacji możesz użyć poleceń:

  • dotnet --list-sdks dla SDK,
  • dotnet --list-runtimes dla Runtime.

Dzięki temu podejmiesz świadomą decyzję, które składniki naprawdę możesz usunąć.

Odinstalowywanie .NET Framework na systemie Windows

Istnieje kilka metod usuwania .NET Framework w systemie Windows:

  • Panel sterowania – przejdź do „Programy i funkcje”/”Dodaj lub usuń programy”, odszukaj odpowiednią wersję .NET, rozpocznij jej odinstalowywanie kreatorem,
  • funkcje Windows – znajdź „Włącz lub wyłącz funkcje systemu Windows”, odznacz odpowiednie opcje związane z „.NET Framework”, zatwierdź i zrestartuj komputer,
  • Microsoft .NET Framework Cleanup Tool – narzędzie do gruntownego usuwania starych/uszkodzonych wersji .NET Framework wraz z czyszczeniem rejestru i systemu plików. Stosuj tylko, gdy inne metody zawiodły.

Zaawansowane narzędzia dla systemu Windows

Chcąc mieć więcej kontroli nad usuwaniem .NET Core/5+ użyj .NET Uninstall Tool:

  • kompatybilny z Windows i macOS,
  • obsługuje usuwanie SDK/Runtime instalowanych przez standardowe instalatory,
  • prosta instalacja (*.msi), wymaga uprawnień administratora.

Najważniejsze scenariusze użycia narzędzia:

  • dotnet-core-uninstall list – wyświetlanie dostępnych do usunięcia zestawów,
  • dotnet-core-uninstall dry-run – symulacja usuwania w celu sprawdzenia zmian,
  • dotnet-core-uninstall remove – rzeczywiste usunięcie składników.

Tryb dry-run pozwala uniknąć przypadkowego skasowania potrzebnych wersji!

Przykład masowego usuwania SDK starszych od .NET 7:

dotnet-core-uninstall dry-run --sdk --all-below 7.0.402

dotnet-core-uninstall remove --sdk --all-below 7.0.402

Odinstalowywanie .NET na systemie macOS

Usuwanie .NET na macOS to operacja wykonywana ręcznie, wymagająca dostępu administracyjnego:

  • identyfikacja wersji (dotnet --list-sdks i dotnet --list-runtimes),
  • ręczne usuwanie katalogów /usr/local/share/dotnet lub $HOME/.dotnet (np. sudo rm -rf /usr/local/share/dotnet),
  • edycja zmiennych PATH w ~/.bash_profile lub ~/.zshrc,
  • usuwanie pliku referencyjnego /etc/paths.d/dotnet (sudo rm /etc/paths.d/dotnet),
  • opcjonalnie użycie skryptu dotnet-uninstall-pkgs.sh od Microsoft,
  • restart Terminala/systemu.

Po manualnym kasowaniu, w razie problemów z aplikacjami, brakujące wersje można zawsze pobrać z oficjalnych archiwów Microsoft.

Przy instalacji przez Homebrew wystarczą komendy tego menedżera. Po usunięciu warto jeszcze:

  • wykonać dotnet --version dla weryfikacji,
  • oczyścić cache ~/.nuget, ~/.dotnet/, ~/.templateengine/,
  • ponownie uruchomić powłokę.

Odinstalowywanie .NET na systemach Linux

W świecie Linuksa odinstalowanie .NET zależy od użytego menedżera pakietów oraz sposobu wcześniejszej instalacji. Oto przykładowe polecenia dla popularnych dystrybucji:

Dystrybucja Polecenie usuwające
Debian / Ubuntu (APT) sudo apt remove --purge dotnet-sdk-6.0
Red Hat / CentOS / Fedora (YUM/DNF) sudo yum remove dotnet-runtime-6.0 / sudo dnf remove dotnet-sdk-6.0
Ubuntu – Host .NET sudo apt-get remove dotnet-host + sudo apt autoremove
  • identyfikację komponentów wykonasz poleceniem dotnet --list-runtimes lub przeszukując listę pakietów (apt list | grep dotnet, yum list installed | grep dotnet).

Ręczne odinstalowywanie na systemach Linux

Dla instalacji niezarządzanych przez systemowe menedżery pakietów (np. przez dotnet-install):

  • znajdź katalog /usr/share/dotnet/, /usr/lib/dotnet/ lub $HOME/.dotnet,
  • usuń odpowiednią wersję np. sudo rm -rf /usr/share/dotnet/sdk/6.0.406,
  • zweryfikuj efekt przez dotnet --list-sdks i dotnet --list-runtimes.

Pamiętaj, by pozostawić wersje wymagane przez inne, działające programy!

Głębokie oczyszczanie systemu Linux

Kiedy odinstalowanie przez menedżer nie wystarcza, wykonaj pełne czyszczenie z zależnościami i konfiguracją:

  • znajdź pakiety .NET: sudo apt list | grep "dotnet",
  • usuń wszystko jednym poleceniem: sudo apt-get purge --auto-remove dotnet-*,
  • zrób porządek z zaległymi zależnościami: sudo apt autoremove i sudo apt autoclean.

Używaj ostrożnie znaków wieloznacznych, by nie usunąć zbyt wielu pakietów na raz!

Najlepsze praktyki bezpieczeństwa przy odinstalowywaniu .NET

Przestrzegaj sprawdzonych zasad, aby uniknąć problemów systemowych:

  • kopie zapasowe lub punkt przywracania przed każdą operacją,
  • sprawdzenie zależności aplikacji od konkretnych wersji .NET,
  • testowanie zmian najpierw w środowisku testowym,
  • praca na uprawnieniach administratora tylko jeśli to niezbędne,
  • pobieranie narzędzi tylko ze źródeł Microsoft.

Bezpieczeństwo i zgodność z politykami

Odinstalowywanie przestarzałych wersji .NET zwiększa pewność środowiska IT oraz zgodność z wewnętrznymi i branżowymi normami.

  • usuwaj przestarzałe i dziurawe wersje .NET według planu,
  • stawiaj na skrupulatną dokumentację każdej czynności oraz użytych narzędzi,
  • dbaj o zgodność działań z lokalnymi regulacjami branżowymi,
  • testuj zmiany kolejno na środowiskach Dev/Test/Prod.

Rozwiązywanie problemów i diagnozowanie

Do najczęstszych problemów należą błędy deinstalacji i uszkodzenie plików lub rejestru.

  • najpierw uruchom ponownie system i spróbuj procesu raz jeszcze,
  • użyj Microsoft .NET Framework Cleanup Tool do naprawy rejestru,
  • w przypadku niedziałających aplikacji po deinstalacji, zainstaluj brakującą wersję .NET,
  • na macOS/Linux sprawdź prawa dostępu i czy pliki nie są używane przez uruchomione procesy.

Zaawansowana diagnostyka

Dla trudniejszych błędów wykorzystaj narzędzia do analizy procesów:

  • process Monitor (Windows) – monitorowanie aktywności plików i rejestru;
  • strace/dtruss (macOS/Linux) – śledzenie systemowych wywołań plików;
  • analiza logów systemowych w /var/log/ i podgląd Dziennika Zdarzeń Windows.

Ręczne usuwanie pozostałości po nieudanym odinstalowywaniu zalecane jest wyłącznie zaawansowanym użytkownikom i administratorom!

Weryfikacja i walidacja

Po zakończonym odinstalowywaniu skontroluj efekty:

  • polecenie dotnet --version powinno nie być rozpoznawane,
  • w Windows sprawdź obecność C:\Program Files\dotnet,
  • na macOS/Linux katalogi /usr/local/share/dotnet i ~/.dotnet muszą być puste lub nie istnieć,
  • testuj uruchomienie aplikacji zależnych od .NET – brak działania to sygnał, że należy przywrócić wersję.

Planowanie przyszłych instalacji

Wykorzystaj wiedzę z procesu odinstalowywania na przyszłość, dokumentując i automatyzując zarządzanie środowiskiem .NET:

  • standaryzuj wersje .NET w organizacji,
  • prowadź regularne audyty oraz wdrażaj automatyzację w zarządzaniu cyklem życia oprogramowania.

Podsumowanie kluczowych wniosków

Bezpieczne odinstalowywanie .NET Framework i jego nowszych wariantów opiera się na znajomości specyfiki systemu, wyborze właściwych narzędzi, analizie zależności oraz konsekwentnym przestrzeganiu dobrych praktyk administracyjnych.

Dokumentacja, testowanie oraz regularne aktualizacje stanowią najlepszą ochronę przed problemami po usunięciu wybranych komponentów .NET.

Poprawna realizacja procesu pozwala na optymalizację bezpieczeństwa, efektywności i skalowalności infrastruktury w każdym środowisku IT.