.NET Conf

Ten obszerny przewodnik przedstawia szczegółowe, krok po kroku instrukcje instalacji .NET na trzech najważniejszych systemach operacyjnych: Windows, Linux (szczególnie Ubuntu) oraz macOS. Platforma .NET przeszła znaczącą ewolucję – od zamkniętego narzędzia Windows po otwarty, wieloplatformowy framework, umożliwiając deweloperom tworzenie aplikacji uruchamianych na różnych systemach bez dodatkowych barier. .NET Core, a obecnie nowoczesny .NET, to dowód na zaangażowanie Microsoft w otwarty kod, modularność i częste aktualizacje, co odróżnia go od starszego .NET Framework. Bez względu na doświadczenie, poniżej dowiesz się, jak wykorzystać graficzne instalatory, narzędzia wiersza poleceń i metody automatyzowane do prawidłowej konfiguracji środowiska .NET na dowolnej platformie.

Spis treści [odkryj]

Metody instalacji i konfiguracji .NET na Windows

Windows oferuje wielorakie sposoby instalacji .NET, dopasowane do różnych potrzeb użytkowników: od prostych instalatorów graficznych po narzędzia dla administratorów i deweloperów automatyzujących wdrożenia.

Korzystanie z instalatora Windows

Aby zainstalować .NET z graficznym kreatorem, postępuj zgodnie z poniższą procedurą:

  • odwiedź stronę https://dotnet.microsoft.com/download/dotnet i wybierz odpowiednią wersję .NET,
  • pobierz dedykowany instalator dla swojej architektury (np. x64 lub ARM64),
  • uruchom pobrany plik, wybierz opcjonalną ścieżkę instalacji i podążaj za wskazówkami kreatora,
  • po zakończeniu instalacji system automatycznie ustawi zmienną PATH oraz skojarzenia plików.

Wybierając instalator SDK, uzyskujesz pełne środowisko deweloperskie: .NET Runtime, Desktop Runtime oraz ASP.NET Core Runtime, co umożliwia budowanie i testowanie każdego typu aplikacji .NET.

Instalacja z linii poleceń

Windows umożliwia również instalację .NET poprzez wiersz poleceń, co pozwala na cichą automatyzację procesu:

  • instalacja cicha: dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart,
  • usuwanie wersji: /uninstall, naprawa: /repair,
  • zwracane kody: 0 – sukces, 3010 – wymagany restart systemu.

Ta metoda sprawdza się w środowiskach korporacyjnych, gdzie .NET instaluje się masowo lub w procesach CI/CD.

Wybrane pakiety runtime na Windows

Dla różnych potrzeb aplikacji dostępne są pakiety runtime:

  • .NET Runtime – dla aplikacji konsolowych i usług,
  • .NET Desktop Runtime – dla aplikacji WPF i Windows Forms z interfejsem graficznym,
  • ASP.NET Core Runtime – dla aplikacji webowych i serwerowych.

Zalecana jest instalacja SDK na stanowiskach programistycznych oraz wybranego runtime na serwerach produkcyjnych lub u końcowych użytkowników.

Strategie instalacji .NET na Linux (Ubuntu)

W przypadku Ubuntu można instalować .NET z różnych źródeł:

  • oficjalne repozytoria systemowe z wykorzystaniem apt,
  • repozytorium Microsoft z najnowszymi paczkami,
  • pakiety Snap zapewniające izolację,
  • dedykowany skrypt instalacyjny dla środowisk niestandardowych lub automatyzacji.

Instalacja przez apt z repozytoriów Ubuntu

Najprostszy wariant instalacji .NET SDK na Ubuntu:

  • zaktualizuj bazę pakietów: sudo apt update,
  • instaluj SDK .NET 9.0: sudo apt install dotnet-sdk-9.0,
  • apt sam pobierze zależności i zapewni bieżące aktualizacje przy cyklicznych poprawkach systemowych.

Instalacja z oficjalnego kanału Microsoft

Aby uzyskać najnowsze wydania .NET od Microsoft:

  • dodaj klucz GPG Microsoft oraz repozytorium,
  • zaktualizuj bazę pakietów i zainstaluj: sudo apt-get install dotnet-sdk-9.0,
  • metoda dostępna wyłącznie dla architektury x64.

Gwarantuje to dostęp do najświeższych aktualizacji bezpośrednio z Microsoft.

Instalacja Snap

.NET można też zainstalować w formie Snapa:

  • upewnij się, że masz zainstalowane snap,
  • zainstaluj SDK: sudo snap install dotnet-sdk --classic,
  • snap tworzy własne aliasy, a instalacja jest odizolowana od systemu głównego.

Wariant snap oferuje bezpieczeństwo, jednak należy pamiętać o ewentualnych ograniczeniach ze względu na piaskownicę.

Instalacja przy pomocy skryptu

Dla zaawansowanych użytkowników, środowisk testowych, CI/CD:

  • pobierz skrypt: wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh,
  • nadaj uprawnienia: chmod +x ./dotnet-install.sh,
  • uruchom skrypt z odpowiednimi parametrami (np. --version latest),
  • w razie potrzeby, ręcznie dodaj nową ścieżkę do zmiennej PATH.

Instalacja .NET na macOS: kluczowe metody

Na platformie macOS kluczowe jest dobranie odpowiedniego wariantu pod architekturę sprzętu (Intel/x64 lub Apple Silicon/ARM64), znajomość polityki bezpieczeństwa Apple i integracji z narzędziami środowiska programistycznego.

Oficjalny instalator .NET na macOS

Aby skorzystać z dedykowanego instalatora:

  • odwiedź stronę dotnet, pobierz plik dla swojej architektury,
  • wybierz SDK dla pełnego środowiska programistycznego,
  • pliki zostaną zainstalowane w /usr/local/share/dotnet, a programy dodane do PATH.

Instalacja przez Homebrew

Za pomocą najpopularniejszego na macOS menedżera pakietów:

  • zainstaluj Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)",
  • zainstaluj .NET SDK: brew install --cask dotnet-sdk,
  • Homebrew sam dopasuje paczkę i zadba o integrację środowiskową.

Instalacja manualna

W scenariuszach wymagających niestandardowej lokalizacji lub wersji wybierz instalację z archiwum tar.gz:

  • pobierz archiwum ze strony dotnet,
  • rozpakuj do wybranego katalogu,
  • dodaj ścieżkę do PATH w pliku konfiguracyjnym powłoki (np. .zshrc),
  • sprawdź instalację poleceniem ./dotnet --info.

SDK a runtime .NET – najważniejsze różnice

Wybór między SDK a runtime to kluczowa kwestia dla prawidłowej instalacji, konfiguracji i zarządzania środowiskiem .NET.

  • .NET SDK – kompletny pakiet programistyczny z narzędziami CLI, szablonami, debugowaniem i pełnym zestawem runtimów;
  • .NET Runtime – środowisko do uruchamiania aplikacji, bez możliwości kompilacji czy debugowania;
  • .NET Desktop Runtime – specjalnie do programów desktopowych na Windows;
  • ASP.NET Core Runtime – środowisko uruchomieniowe aplikacji webowych;
  • Macierz decyzyjna:
    • stanowiska deweloperskie – SDK;
    • serwery produkcyjne – runtime;
    • komputery użytkowników końcowych – wybrany runtime.

Dla środowisk złożonych (CI/CD, konteneryzacja) konieczne może być jednoczesne wdrożenie kilku komponentów w zależności od roli maszyny.

Pokonfiguracyjne ustawienia i weryfikacja działania .NET

Konfiguracja i weryfikacja po instalacji są kluczowe dla bezpieczeństwa i niezawodności środowiska .NET.

Zmienne środowiskowe i ich konfiguracja

Najważniejsze zmienne:

  • DOTNET_ROOT – wskazuje lokalizację instalacji .NET,
  • PATH – decyduje o globalnej widoczności polecenia dotnet,
  • DOTNET_CLI_TELEMETRY_OPTOUT – umożliwia wyłączenie przesyłania danych telemetrycznych,
  • DOTNET_SKIP_FIRST_TIME_EXPERIENCE – przyspiesza pierwsze użycie CLI oraz wyklucza zbędne komunikaty powitalne.

Sprawdzanie poprawności instalacji

  • dotnet –version – wyświetla zainstalowaną wersję SDK,
  • dotnet –info – szczegółowe informacje o środowisku,
  • dotnet –list-sdks oraz dotnet –list-runtimes – zestawienie dostępnych składników .NET.

Wskazówki dotyczące wydajności i bezpieczeństwa

  • Wyłączanie telemetryki – ustaw DOTNET_CLI_TELEMETRY_OPTOUT jeśli liczy się dla ciebie poufność danych,
  • Odpowiedni wybór miejsca instalacji – globalnie wyłącznie z uprawnieniami administratora lub lokalnie dla użytkownika,
  • Ustawienie zmiennych optymalizujących wydajność i kompilację środowiska (np. DOTNET_ReadyToRun, DOTNET_TieredCompilation).

Tworzenie pierwszego projektu .NET

By uruchomić swój pierwszy projekt, przejdź przez następujące kroki:

  • utwórz aplikację konsolową: dotnet new console -n MojaPierwszaAplikacja – generuje strukturę projektu i plik Program.cs,
  • budowanie: dotnet build,
  • uruchamianie: dotnet run,
  • wykorzystaj dodatkowe polecenia: dotnet add package, dotnet add reference oraz odpowiednie parametry do zarządzania konfiguracją, środowiskiem lub katalogiem wyjściowym.

Rozwiązywanie typowych problemów z instalacją .NET

Poniżej znajdziesz najczęściej spotykane trudności oraz propozycje ich rozwiązania dla każdej platformy:

  • Windows:
    • niedziałająca usługa Windows Installer – sprawdź systemowe usługi i pliki,
    • brak uprawnień – uruchom instalator jako administrator,
    • konflikty wersji – usuń zbędne wersje, używaj narzędzia naprawy dotnet.
  • Linux:
    • konflikty wersji/źródeł – nie łącz metody apt, snap i skryptów,
    • błędy repozytoriów – sprawdź konfigurację kluczy i źródeł,
    • braki zależności – doinstaluj biblioteki zgodnie z komunikatami błędów.
  • macOS:
    • problemy z Gatekeeperem – zmień ustawienia bezpieczeństwa lub użyj Control+klik,
    • nieprawidłowa architektura – pobierz odpowiedni pakiet dla swojego procesora,
    • brak uprawnień – instaluj lokalnie lub jako administrator; uzupełnij PATH zgodnie z lokalizacją instalacji.

Zaawansowane metody wdrożeń i automatyzacji .NET

W nowoczesnych środowiskach deweloperskich i produkcyjnych, kluczowe są automatyzacja, konteneryzacja oraz centralne zarządzanie instalacjami.

  • Skrypt instalacyjny .NET – automatyzuje instalację w systemach CI/CD i obrazach Docker dzięki parametrom takim jak --version, --channel;
  • Strategie kontenerowe (Docker): wykorzystaj etap multi-stage build – pozostaw tylko niezbędny runtime w obrazie końcowym;
  • Korporacyjne wdrożenia Windows:
    • centralna dystrybucja System Center Configuration Manager lub GPO,
    • wewnętrzne repozytoria pakietów w celu zabezpieczenia zgodności i wersji,
    • platformy konfiguracyjne (Ansible, Chef, Puppet) do deklaratywnego zarządzania środowiskiem .NET.

Świadome planowanie i właściwe wykorzystanie narzędzi umożliwia szybkie, bezpieczne i elastyczne wdrożenie .NET w każdym środowisku – od stanowisk deweloperskich po infrastrukturę produkcyjną w chmurze lub na wielu serwerach jednocześnie.