Instalowanie .NET w systemie macOS

• Zainstaluj w systemie Windows
• Instalowanie w systemie macOS
• Instalowanie w systemie Linux

W tym artykule opisano, które wersje .NET są obsługiwane w systemie macOS, jak zainstalować .NET i jaka jest różnica między zestawem SDK i środowiskiem uruchomieniowym.

Najnowsza wersja .NET to 10.

Pobierz .NET

Obsługiwane wersje

W poniższej tabeli wymieniono obsługiwane wersje .NET oraz systemy macOS, na których są one wspierane. Te wersje pozostają obsługiwane do momentu, aż wersja .NET osiągnie koniec wsparcia lub wersja systemu macOS nie jest już obsługiwana.

Wersja systemu macOS	.NET
macOS 26 "Tahoe"	10.0, 9.0, 8.0
macOS 15 "Sequoia"	10.0, 9.0, 8.0
macOS 14 "Sonoma"	9.0, 8.0

Następujące wersje .NET nie są już obsługiwane ❌:

• .NET 7
• .NET 6
• .NET 5
• .NET Core 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Środowisko uruchomieniowe lub zestaw SDK

runtime0 służy do uruchamiania aplikacji utworzonych za pomocą .NET. Gdy autor aplikacji publikuje aplikację, może dołączyć środowisko uruchomieniowe do swojej aplikacji. Jeśli nie zawierają środowiska uruchomieniowego, użytkownik musi zainstalować poprawne środowisko uruchomieniowe.

Istnieją dwa środowiska uruchomieniowe, które można zainstalować w systemie macOS, a oba są dołączone do zestawu SDK.

• ASP.NET Core Runtime
  Uruchamia aplikacje ASP.NET Core. Obejmuje środowisko uruchomieniowe .NET. Niedostępny jako instalator.

• .NET Runtime
  Działa to na normalne aplikacje .NET, ale nie na wyspecjalizowane aplikacje, takie jak zbudowane na ASP.NET Core.

Zestaw SDK służy do tworzenia i publikowania aplikacji i bibliotek .NET. Najnowszy zestaw SDK obsługuje tworzenie aplikacji dla poprzednich wersji .NET. W normalnych okolicznościach konieczne byłoby zainstalowanie tylko najnowszego zestawu SDK.

Zainstalowanie zestawu SDK obejmuje zarówno standardowe środowisko uruchomieniowe .NET, jak i środowisko uruchomieniowe ASP.NET Core. Jeśli na przykład masz zainstalowany zestaw .NET SDK 9.0, .NET Runtime 9.0 i ASP.NET Core 9.0 Runtime są zainstalowane. Jednak każda inna wersja środowiska uruchomieniowego nie zostałaby zainstalowana z zestawem SDK i wymagałaby jej oddzielnego zainstalowania.

Wybieranie sposobu instalowania .NET

Istnieją różne sposoby instalowania .NET, a niektóre produkty mogą zarządzać własną wersją .NET. Jeśli zainstalujesz .NET za pomocą oprogramowania, które zarządza własną wersją .NET, może nie być włączone dla całego systemu. Upewnij się, że rozumiesz konsekwencje instalowania .NET za pośrednictwem innego oprogramowania.

Jeśli nie masz pewności, którą metodę należy wybrać po przejrzeniu list w poniższych sekcjach, prawdopodobnie chcesz użyć pakietu instalatora .NET.

Deweloperzy

• Visual Studio Code — C# Dev Kit

  Zainstaluj rozszerzenie C# Dev Kit dla Visual Studio Code w celu tworzenia aplikacji .NET. Rozszerzenie może używać już zainstalowanego zestawu SDK lub zainstalować go.

Użytkownicy i deweloperzy

• Instalator .NET

  Zainstaluj .NET za pomocą autonomicznego instalatora. Ta metoda jest typowym sposobem instalowania .NET na komputerze dewelopera lub użytkownika.

• Install .NET za pomocą skryptu

  Skrypt powłoki bash, który może zautomatyzować instalację zestawu SDK lub środowiska uruchomieniowego. Możesz wybrać wersję .NET do zainstalowania.

• Install .NET ręcznie

  Użyj tej metody instalacji, jeśli musisz zainstalować .NET do określonego folderu i uruchomić go poza innymi kopiami .NET.

Instalowanie .NET

Pakiety instalatora są dostępne dla systemu macOS— łatwy sposób instalowania .NET.

1. Otwórz przeglądarkę i przejdź pod adres https://dotnet.microsoft.com/download/dotnet.

2. Wybierz link do wersji .NET, którą chcesz zainstalować, na przykład .NET 10.0.

   

   Ten link umożliwia wyświetlenie strony z linkami umożliwiającymi pobranie tej wersji .NET

   Jeśli zamierzasz zainstalować zestaw SDK, wybierz najnowszą wersję .NET. Zestaw SDK obsługuje tworzenie aplikacji dla poprzednich wersji .NET.

   Wskazówka

   Jeśli nie masz pewności, która wersja ma być pobierana, wybierz wersję oznaczoną jako najnowszą.

3. Na tej stronie przedstawiono linki pobierania dla zestawu SDK i środowiska uruchomieniowego. W tym miejscu pobierzesz zestaw SDK .NET lub środowisko uruchomieniowe .NET.

   

   Na poprzedniej ilustracji wyróżniono dwie sekcje. Jeśli pobierasz zestaw SDK, zapoznaj się z sekcją 1. W przypadku środowiska uruchomieniowego .NET zapoznaj się z sekcją 2.

   • Sekcja 1 (SDK)

     Ta sekcja to obszar pobierania zestawu SDK. W kolumnie Instalatory dla wiersza systemu macOS są wymienione dwie architektury: Arm64 i x64.

     • Jeśli używasz procesora firmy Apple, takiego jak M1 lub M3 Pro, wybierz pozycję Arm64.
     • Jeśli używasz procesora Intel, wybierz pozycję x64.

   • Sekcja 2 (środowisko uruchomieniowe)

     Ta sekcja zawiera pliki do pobrania środowiska uruchomieniowego. Zwróć uwagę, że linki dla kolumny Instalatory w wierszu systemu macOS są puste! Ta sekcja jest pusta, ponieważ środowisko uruchomieniowe ASP.NET Core jest dostępne tylko w zestawie SDK lub za pośrednictwem instalacji binarnej.

     Przewiń dalej w dół, aby znaleźć standardowe .NET Runtime do pobrania.

     

     • Jeśli używasz procesora firmy Apple, takiego jak M1 lub M3 Pro, wybierz pozycję Arm64.
     • Jeśli używasz procesora Intel, wybierz pozycję x64.

4. Po zakończeniu pobierania otwórz go.

5. Wykonaj kroki opisane w instalatorze.

   

Ręczne instalowanie .NET

Alternatywą dla instalatorów systemu macOS jest pobranie i ręczne zainstalowanie zestawu SDK i środowiska uruchomieniowego. Instalacja ręczna jest zwykle wykonywana jako część automatyzacji w scenariuszu ciągłej integracji. Deweloperzy i użytkownicy zwykle chcą używać instalatora.

Wskazówka

Użyj skryptu install-dotnet.sh, aby wykonać te kroki automatycznie.

1. Otwórz przeglądarkę i przejdź pod adres https://dotnet.microsoft.com/download/dotnet.

2. Wybierz link do wersji .NET, którą chcesz zainstalować, na przykład .NET 8.0.

   Ten link umożliwia wyświetlenie strony z linkami umożliwiającymi pobranie tej wersji .NET

   Jeśli zamierzasz zainstalować zestaw SDK, wybierz najnowszą wersję .NET. Zestaw SDK obsługuje tworzenie aplikacji dla poprzednich wersji .NET.

   Wskazówka

   Jeśli nie masz pewności, która wersja ma być pobierana, wybierz wersję oznaczoną jako najnowszą.

   

3. Wybierz link do zestawu SDK lub środowiska uruchomieniowego, który chcesz zainstalować. Wyszukaj kolumnę Binaries (Pliki binarne) w wierszu systemu macOS.

   

   • Jeśli używasz procesora firmy Apple, takiego jak M1 lub M3 Pro, wybierz pozycję Arm64.
   • Jeśli używasz procesora Intel, wybierz pozycję x64.

4. Otwórz terminal i przejdź do lokalizacji pobierania pliku binarnego .NET.

5. Wyodrębnij plik tarball do wybranego miejsca, w którym chcesz korzystać z .NET na swoim systemie. W poniższym przykładzie użyto katalogu HOME~/Applications/.dotnet.

   mkdir -p ~/Applications/.dotnet
   tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
   

Przetestuj, że .NET działa, zmieniając katalog na miejsce, w którym zainstalowano .NET, i uruchom polecenie dotnet --info:

chdir ~/Applications/.dotnet/
./dotnet --info

Instalowanie .NET za pomocą skryptu

Skrypty dotnet-install są używane do automatyzacji instalacji środowiska uruchomieniowego bez podwyższonych uprawnień. Skrypt można pobrać z witryny https://dot.net/v1/dotnet-install.sh.

Skrypt domyślnie instaluje najnowszą wersję long term support (LTS), która jest .NET 8. Możesz wybrać określoną wersję, określając channel przełącznik. Dołącz przełącznik runtime do instalacji środowiska uruchomieniowego. W przeciwnym razie skrypt instaluje zestaw SDK.

Wskazówka

Te polecenia są przedstawione jako fragment kodu skryptu pod koniec tej procedury.

1. Otwórz terminal.

2. Przejdź do folderu, w którym chcesz pobrać skrypt, na przykład ~/Downloads.

3. Jeśli nie masz wget polecenia, zainstaluj je za pomocą aplikacji Brew

   brew install wget
   

4. Uruchom następujące polecenie, aby pobrać skrypt:

   wget https://dot.net/v1/dotnet-install.sh
   

5. Nadaj skryptowi uprawnienia do wykonywania

   chmod +x dotnet-install.sh
   

6. Uruchom skrypt, aby zainstalować .NET.

   Skrypt domyślnie instaluje najnowszy zestaw SDK w ~/.dotnet katalogu.

   ./dotnet-install.sh
   

Oto wszystkie polecenia jako pojedynczy skrypt bash.

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

Przetestuj .NET, przechodząc do folderu ~/.dotnet i uruchamiając polecenie dotnet --info:

chdir ~/.dotnet
./dotnet --info

Ważne

Niektóre programy mogą używać zmiennych środowiskowych do znajdowania .NET w systemie, a użycie polecenia dotnet może nie działać podczas otwierania nowego terminalu. Aby uzyskać pomoc dotyczącą rozwiązywania tego problemu, zobacz sekcję Make .NET dostępne dla całego systemu.

Instalowanie .NET dla Visual Studio Code

Visual Studio Code to zaawansowany i lekki edytor kodu źródłowego, który działa na pulpicie. Visual Studio Code może używać zestawu SDK zainstalowanego już w systemie. Ponadto rozszerzenie C# Dev Kit zainstaluje .NET, jeśli nie jest jeszcze zainstalowane.

Aby uzyskać instrukcje dotyczące instalowania .NET za pośrednictwem Visual Studio Code, zobacz Pobierz wprowadzenie do języka C# w programie VS Code.

Notaryzacja

Oprogramowanie utworzone dla systemu macOS dystrybuowane za pomocą identyfikatora dewelopera musi być notarowane, w tym aplikacje utworzone przy użyciu .NET.

Jeśli uruchamiasz nieararyzowaną aplikację, zostanie wyświetlone okno błędu podobne do poniższego obrazu:

Aby uzyskać więcej informacji na temat wpływu wymuszanej notaryzacji na .NET (i aplikacji .NET), zobacz Working with macOS Catalina Notarization (Praca z notaryzacji systemu macOS Catalina

Walidacja

Po pobraniu instalatora lub wydania binarnego sprawdź, czy plik nie został zmieniony ani uszkodzony. Możesz sprawdzić sumę kontrolną na komputerze, a następnie porównać ją z wartością podaną na stronie pobierania.

Po pobraniu pliku ze strony oficjalnego pobierania, wyświetlana jest suma kontrolna pliku w polu tekstowym. Wybierz przycisk Kopiuj, aby skopiować wartość sumy kontrolnej do schowka.

shasum -a 512 Użyj polecenia , aby wyświetlić sumę kontrolną pobranego pliku. Na przykład następujące polecenie zgłasza sumę kontrolną pliku dotnet-sdk-9.0.306-osx-x64.tar.gz :

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

Porównaj sumę kontrolną z wartością podaną przez witrynę pobierania.

Sprawdzanie poprawności za pomocą pliku sumy kontrolnej

Informacje o wersji .NET zawierają link do pliku sumy kontrolnej, którego można użyć do zweryfikowania pobranego pliku. W poniższych krokach opisano sposób pobierania pliku sumy kontrolnej i weryfikowania instalacyjnego pliku binarnego .NET:

1. Strona informacji o wersji dla .NET 9 w GitHub o https://github.com/dotnet/core/tree/main/release-notes/9.0#releases zawiera sekcję o nazwie Releases. Tabela w tej sekcji zawiera linki do plików do pobrania i sum kontrolnych dla każdej wersji .NET 9. Na poniższej ilustracji przedstawiono tabelę wersji .NET 8 jako odniesienie.

   Tabela notatek o wersji GitHub dla .NET

2. Wybierz link dla pobranej wersji .NET.

   W poprzedniej sekcji użyto zestawu .NET SDK 9.0.306, który znajduje się w wersji .NET 9.0.10.

3. Na stronie wydania można zobaczyć wersję .NET Runtime, .NET SDK oraz link do pliku sum kontrolnych. Na poniższej ilustracji przedstawiono tabelę wersji .NET 8 jako odniesienie.

   

4. Kliknij prawym przyciskiem myszy link Suma kontrolna i skopiuj go do schowka.

5. Otwórz terminal.

6. Użyj curl -O {link} aby pobrać plik sumy kontrolnej.

   Zastąp link w poniższym poleceniu skopiowanym linkiem.

   curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
   

7. W przypadku zarówno pliku sumy kontrolnej, jak i pliku wydania .NET pobranego do tego samego katalogu, użyj polecenia shasum -a 512 -c {file}, aby zweryfikować pobrany plik.

   Po pomyślnym zakończeniu walidacji zostanie wyświetlony plik wydrukowany ze stanem OK :

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
   

   Jeśli zobaczysz plik oznaczony jako NIEPOWODZENIE, pobrany plik nie jest prawidłowy i nie powinien być używany.

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

Maki z procesorami ARM

W poniższych sekcjach opisano kwestie, które należy wziąć pod uwagę podczas instalowania .NET na komputerze Mac opartym na usłudze Arm.

Różnice ścieżki

Na komputerze Mac opartym na usłudze Arm wszystkie wersje arm64 .NET są instalowane w normalnym folderze /usr/local/share/dotnet/. Jednak po zainstalowaniu x64 wersji zestawu .NET SDK jest ona zainstalowana w folderze /usr/local/share/dotnet/x64/dotnet/.

Zmienne ścieżki

Zmienne środowiskowe, które dodają .NET do ścieżki systemowej, takie jak zmienna PATH, mogą wymagać zmiany, jeśli zainstalowane są zarówno wersje x64, jak i Arm64 pakietu .NET SDK. Ponadto niektóre narzędzia korzystają z zmiennej środowiskowej DOTNET_ROOT, która również musi zostać zaktualizowana, aby wskazać odpowiedni folder instalacyjny zestawu SDK .NET.

Rozwiązywanie problemów

Dostępne są następujące sekcje ułatwiające rozwiązywanie problemów:

• Komputery Mac z architekturą ARM
• Make .NET dostępne dla całego systemu

Uczyń .NET dostępnym dla całego systemu

Czasami aplikacje w systemie, w tym terminal, muszą znaleźć miejsce instalacji .NET. Pakiet instalatora .NET macOS0 powinien automatycznie skonfigurować system. Jeśli jednak użyto metody instalacji manual lub .NET skrypt instalacji należy dodać katalog, w którym zainstalowano .NET do zmiennej PATH.

Niektóre aplikacje mogą szukać zmiennej DOTNET_ROOT podczas próby określenia miejsca instalacji .NET.

Istnieje wiele różnych powłok dostępnych dla systemu macOS i każdy z nich ma inny profil. Na przykład:

• Powłoka Bash: ~/.profile, /etc/profile
• Korn Shell: ~/.kshrc lub .profile
• Zsh: ~/.zshrc lub .zprofile

Ustaw następujące dwie zmienne środowiskowe w profilu powłoki:

• DOTNET_ROOT

  Ta zmienna jest ustawiona na folder, do którego zainstalowano .NET, na przykład $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Ta zmienna powinna zawierać zarówno folder DOTNET_ROOT jak i folder DOTNET_ROOT/tools.

  export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
  

Powiązana zawartość

• Jak sprawdzić, czy .NET jest już zainstalowana.
• Praca przy notaryzacji w systemie macOS Catalina.
• Tutorial: tworzenie aplikacji konsolowej .NET.
• Tutorial: Konteneryzowanie aplikacji .NET.