Instalowanie platformy .NET w systemie macOS

  • Artykuł

Z tego artykułu dowiesz się, jak zainstalować platformę .NET w systemie macOS. Platforma .NET składa się ze środowiska uruchomieniowego i zestawu SDK. Środowisko uruchomieniowe służy do uruchamiania aplikacji platformy .NET i może być dołączone do aplikacji lub może nie być dołączone do tej aplikacji. Zestaw SDK służy do tworzenia aplikacji i bibliotek platformy .NET. Środowisko uruchomieniowe platformy .NET jest zawsze instalowane wraz z zestawem SDK.

Najnowsza wersja platformy .NET to 8.

Pobierz platformę .NET

Obsługiwane wersje

Istnieją dwa typy obsługiwanych wersji: wersje long term support (LTS) i standardowe wersje pomocy technicznej (STS). Jakość wszystkich wydań jest taka sama. Jedyną różnicą jest długość wsparcia. Wersje LTS otrzymują bezpłatną pomoc techniczną i poprawki przez trzy lata. Wersje stS otrzymują bezpłatną pomoc techniczną i poprawki przez 18 miesięcy. Aby uzyskać więcej informacji, zobacz Zasady pomocy technicznej platformy .NET.

Poniższa tabela zawiera listę aktualnie obsługiwanych wersji platformy .NET i obsługiwanych wersji systemu macOS:

System operacyjny .NET 8 (LTS) .NET 7 (STS) .NET 6 (LTS)
macOS 14.0 "Sonoma" ✔️ 8.0 ✔️ 7.0 ✔️ 6.0
macOS 13.0 "Ventura" ✔️ 8.0 ✔️ 7.0 ✔️ 6.0
macOS 12.0 "Monterey" ✔️ 8.0 ✔️ 7.0 ✔️ 6.0
macOS 11.0 "Big Sur" ❌ ✔️ 7.0 ✔️ 6.0
macOS 10.15 "Catalina" ❌ ✔️ 7.0 ✔️ 6.0

Aby uzyskać pełną listę wersji platformy .NET i ich cyklu życia pomocy technicznej, zobacz Zasady pomocy technicznej platformy .NET.

Nieobsługiwane wersje

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

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

Informacje o środowisku uruchomieniowym

Środowisko uruchomieniowe służy do uruchamiania aplikacji utworzonych za pomocą platformy .NET. Gdy autor aplikacji publikuje aplikację, może dołączyć środowisko uruchomieniowe do swojej aplikacji. Jeśli nie zawierają środowiska uruchomieniowego, do użytkownika należy zainstalowanie środowiska uruchomieniowego.

Istnieją dwa różne środowiska uruchomieniowe, które można zainstalować w systemie macOS:

  • środowisko uruchomieniowe ASP.NET Core
    Uruchamia aplikacje ASP.NET Core. Obejmuje środowisko uruchomieniowe platformy .NET.

  • Środowisko uruchomieniowe platformy .NET
    To środowisko uruchomieniowe jest najprostszym środowiskiem uruchomieniowym i nie obejmuje żadnego innego środowiska uruchomieniowego. Zdecydowanie zaleca się zainstalowanie środowiska uruchomieniowego ASP.NET Core w celu uzyskania najlepszej zgodności z aplikacjami platformy .NET.

Pobierz środowisko uruchomieniowe platformy .NET

Informacje o zestawie SDK

Zestaw SDK służy do kompilowania i publikowania aplikacji i bibliotek platformy .NET. Zainstalowanie zestawu SDK obejmuje oba środowiska uruchomieniowe: ASP.NET Core i .NET.

Notaryzacja

Począwszy od systemu macOS Catalina (wersja 10.15), wszystkie oprogramowanie utworzone po 1 czerwca 2019 r. dystrybuowane przy użyciu identyfikatora dewelopera musi być notaryzowane. To wymaganie dotyczy środowiska uruchomieniowego platformy .NET, zestawu .NET SDK i oprogramowania utworzonego za pomocą platformy .NET.

Instalatory środowiska uruchomieniowego i zestawu SDK dla platformy .NET zostały notarowane od 18 lutego 2020 r. Wcześniejsze wersje wydane nie są notaryzowane. Jeśli uruchamiasz niezararyzowaną aplikację, zostanie wyświetlony błąd podobny do poniższego obrazu:

Alert notaryzacji systemu macOS Catalina

Aby uzyskać więcej informacji na temat wpływu wymuszanej notaryzacji na platformę .NET (i aplikacje platformy .NET), zobacz Praca z notaryzacji systemu macOS Catalina.

libgdiplus

Aplikacje .NET korzystające z zestawu System.Drawing.Common wymagają zainstalowania biblioteki libgdiplus.

Łatwym sposobem uzyskania libgdiplus jest użycie menedżera pakietów Homebrew ("brew") dla systemu macOS. Po zainstalowaniu brew zainstaluj libgdiplus, wykonując następujące polecenia w wierszu polecenia terminalu (polecenie):

brew update
brew install mono-libgdiplus

Automatyczna instalacja

System macOS ma autonomiczne instalatory, których można użyć do zainstalowania platformy .NET:

Instalacja ręczna

Alternatywą dla instalatorów systemu macOS dla platformy .NET jest pobranie i ręczne zainstalowanie zestawu SDK i środowiska uruchomieniowego. Instalacja ręczna jest zwykle wykonywana w ramach testowania ciągłego integracji. W przypadku dewelopera lub użytkownika zazwyczaj lepiej jest użyć instalatora.

Pobierz wersję binarną dla zestawu SDK lub środowiska uruchomieniowego z jednej z następujących witryn. Zestaw .NET SDK zawiera odpowiednie środowisko uruchomieniowe:

Wyodrębnij pobrany plik i użyj export polecenia , aby ustawić DOTNET_ROOT lokalizację wyodrębnionego folderu, a następnie upewnij się, że platforma .NET znajduje się w ścieżce . Eksportowanie DOTNET_ROOT udostępnia polecenia interfejsu wiersza polecenia platformy .NET w terminalu. Aby uzyskać więcej informacji na temat zmiennych środowiskowych platformy .NET, zobacz Zmienne środowiskowe zestawu .NET SDK i interfejsu wiersza polecenia.

Różne wersje platformy .NET można wyodrębnić do tego samego folderu, który współistnieje obok siebie.

Przykład

Następujące polecenia używają powłoki Bash, aby ustawić zmienną środowiskową DOTNET_ROOT na bieżący katalog roboczy, a następnie ..dotnet Ten katalog jest tworzony, jeśli nie istnieje. Zmienna DOTNET_FILE środowiskowa to nazwa pliku wersji binarnej platformy .NET, którą chcesz zainstalować. Ten plik jest wyodrębniany do DOTNET_ROOT katalogu. Zarówno katalog, jak DOTNET_ROOT i jego tools podkatalog są dodawane do zmiennej środowiskowej PATH .

Ważne

Jeśli uruchomisz te polecenia, pamiętaj, aby zmienić DOTNET_FILE wartość na nazwę pobranego pliku binarnego platformy .NET.

DOTNET_FILE=dotnet-sdk-8.0.100-osx-x64.tar.gz
export DOTNET_ROOT=$(pwd)/.dotnet

mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"

export PATH=$PATH:$DOTNET_ROOT

W tym samym folderze można zainstalować więcej niż jedną wersję platformy .NET.

Możesz również zainstalować platformę .NET w katalogu głównym zidentyfikowanym przez zmienną lub ~ ścieżkęHOME:

export DOTNET_ROOT=$HOME/.dotnet

Weryfikowanie pobranych plików binarnych

Po pobraniu instalatora sprawdź, czy plik nie został zmieniony ani uszkodzony. Możesz sprawdzić sumę kontrolną na komputerze, a następnie porównać ją z raportami w witrynie internetowej pobierania.

Po pobraniu instalatora lub pliku binarnego z oficjalnej strony pobierania zostanie wyświetlona suma kontrolna pliku. Wybierz przycisk Kopiuj, aby skopiować wartość sumy kontrolnej do schowka.

Strona pobierania platformy .NET z sumą kontrolną

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

$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  dotnet-sdk-8.0.100-linux-x64.tar.gz

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

Ważne

Mimo że plik systemu Linux jest pokazany w tych przykładach, te informacje są jednakowo stosowane do systemu macOS.

Sprawdzanie poprawności przy użyciu pliku sumy kontrolnej

Informacje o wersji platformy .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 pliku binarnego instalacji platformy .NET:

  1. Strona informacji o wersji dla platformy .NET 8 w witrynie GitHub zawiera https://github.com/dotnet/core/tree/main/release-notes/8.0 sekcję o nazwie Wydania. Tabela w tej sekcji zawiera linki do plików pobierania i sumy kontrolnej dla każdej wersji platformy .NET 8:

    Tabela wersji informacji o wersji usługi GitHub dla platformy .NET

  2. Wybierz link dla pobranej wersji platformy .NET. W poprzedniej sekcji użyto zestawu .NET SDK 8.0.100, który znajduje się w wersji .NET 8.0.0.

  3. Na stronie wydania zobaczysz wersję środowiska uruchomieniowego platformy .NET i zestawu .NET SDK oraz link do pliku sumy kontrolnej:

    Tabela pobierania z sumami kontrolnymi dla platformy .NET

  4. Skopiuj link do pliku sumy kontrolnej.

  5. Użyj następującego skryptu, ale zastąp link, aby pobrać odpowiedni plik sumy kontrolnej:

    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt

  6. W przypadku zarówno pliku sumy kontrolnej, jak i pliku wydania platformy .NET pobranego do tego samego katalogu, użyj sha512sum -c {file} --ignore-missing polecenia , aby zweryfikować pobrany plik.

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

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: OK

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

    $ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 8.0.0-sha.txt: no file was verified

Ustawianie zmiennych środowiskowych dla całego systemu

Jeśli użyto instrukcji w sekcji Przykład instalacji ręcznej, zmienne ustawione tylko dla bieżącej sesji terminalu. Dodaj je do profilu powłoki. 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
  • Powłoka Z: ~/.zshrc lub .zprofile

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

  • DOTNET_ROOT

    Ta zmienna jest ustawiona na folder .NET, na który został zainstalowany, na przykład $HOME/.dotnet:

    export DOTNET_ROOT=$HOME/.dotnet

  • PATH

    Ta zmienna powinna zawierać zarówno folder, jak DOTNET_ROOTDOTNET_ROOT/tools i folder:

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

Komputery Mac oparte na arm

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

Co jest obsługiwane

W poniższej tabeli opisano, które wersje platformy .NET są obsługiwane na komputerze Mac opartym na usłudze Arm:

Wersja platformy .NET Architektura SDK Środowisko uruchomieniowe Konflikt ścieżki
8 Arm64 Tak Tak Nie.
8 x64 Tak Tak Nie.
7 Arm64 Tak Tak Nie.
7 x64 Tak Tak Nie.
6 Arm64 Tak Tak Nie.
6 x64 Tak Tak Nie.

Począwszy od platformy .NET 6, wersje x64 i Arm64 zestawu .NET SDK istnieją niezależnie od siebie. Jeśli zostanie wydana nowa wersja, należy uaktualnić każdą instalację.

Różnice ścieżki

Na komputerze Mac opartym na usłudze Arm wszystkie wersje platformy .NET są instalowane w normalnym folderze /usr/local/share/dotnet/ . Jednak podczas instalowania wersji x64 zestawu .NET SDK jest on zainstalowany w folderze /usr/local/share/dotnet/x64/dotnet/ .

Konflikty ścieżek

Począwszy od platformy .NET 6, zestaw SDK platformy .NET x64 jest instalowany we własnym katalogu, zgodnie z opisem w poprzedniej sekcji. Dzięki temu wersje zestawu .NET SDK arm64 i x64 mogą istnieć na tej samej maszynie. Jednak każdy zestaw SDK x64 przed platformą .NET 6 nie jest obsługiwany i instalowany w tej samej lokalizacji co wersja arm64 , folder /usr/local/share/dotnet/ . Jeśli chcesz zainstalować nieobsługiwany zestaw SDK x64, musisz najpierw odinstalować wersję arm64. Odwrotnie jest również prawdą, należy odinstalować nieobsługiwany zestaw SDK x64, aby zainstalować wersję arm64.

Zmienne ścieżki

Zmienne środowiskowe, które dodają platformę .NET do ścieżki systemowej, takie jak PATH zmienna, mogą być konieczne zmiany, jeśli masz zainstalowane wersje zestawu SDK platformy .NET 6 i x64. Ponadto niektóre narzędzia korzystają ze zmiennej DOTNET_ROOT środowiskowej, która również musi zostać zaktualizowana w celu wskazania odpowiedniego folderu instalacyjnego zestawu .NET 6 SDK.

Instalowanie przy użyciu Visual Studio dla komputerów Mac

Visual Studio dla komputerów Mac instaluje zestaw .NET SDK po wybraniu obciążenia platformy .NET. Aby rozpocząć tworzenie aplikacji dla platformy .NET w systemie macOS, zobacz Instalowanie programu Visual Studio 2022 dla komputerów Mac.

Ważne

Visual Studio dla komputerów Mac jest wycofywana. Aby uzyskać więcej informacji, zobacz Co się dzieje z Visual Studio dla komputerów Mac?.

Wersja zestawu .NET SDK Wersja programu Visual Studio
8.0 Program Visual Studio 2022 dla komputerów Mac w wersji 17.6.1 lub nowszej. (Dostępne tylko jako funkcja w wersji zapoznawczej).
7.0 Program Visual Studio 2022 dla komputerów Mac w wersji 17.4 lub nowszej.
6.0 Program Visual Studio 2022 dla komputerów Mac w wersji 17.0 lub nowszej.

MacOS Visual Studio 2022 dla komputerów Mac z wybranym obciążeniem platformy .NET.

Ważne

Firma Microsoft ogłosiła wycofanie Visual Studio dla komputerów Mac. Visual Studio dla komputerów Mac nie będą już obsługiwane od 31 sierpnia 2024 r. Alternatywy obejmują:

Aby uzyskać więcej informacji, zobacz Visual Studio dla komputerów Mac ogłoszenie o wycofaniu.

Instalowanie wraz z programem Visual Studio Code

Visual Studio Code to zaawansowany i lekki edytor kodu źródłowego, który działa na pulpicie. Program Visual Studio Code jest dostępny dla systemów Windows, macOS i Linux.

Chociaż program Visual Studio Code nie jest wyposażony w zautomatyzowanego instalatora platformy .NET, takiego jak program Visual Studio, dodanie obsługi platformy .NET jest proste.

  1. Pobierz i zainstaluj program Visual Studio Code.
  2. Pobierz i zainstaluj zestaw .NET SDK.
  3. Zainstaluj rozszerzenie języka C# z witryny Marketplace programu Visual Studio Code.

Instalowanie przy użyciu automatyzacji powłoki bash

Skrypty dotnet-install są używane do automatyzacji i instalacji środowiska uruchomieniowego poza administratorem. Skrypt można pobrać ze strony referencyjnej skryptu dotnet-install.

Skrypt domyślnie instaluje najnowszą wersję wsparcia długoterminowego (LTS ), czyli platformę .NET 8. Możesz wybrać określoną wersję, określając channel przełącznik. Dołącz przełącznik, runtime aby zainstalować środowisko uruchomieniowe. W przeciwnym razie skrypt instaluje zestaw SDK.

Następujące polecenie instaluje środowisko uruchomieniowe ASP.NET Core w celu zapewnienia maksymalnej zgodności. Środowisko uruchomieniowe ASP.NET Core obejmuje również standardowe środowisko uruchomieniowe platformy .NET.

./dotnet-install.sh --channel 8.0 --runtime aspnetcore

Docker

Kontenery zapewniają lekki sposób odizolowania aplikacji od pozostałej części systemu hosta. Kontenery na tym samym komputerze współużytkować tylko jądro i używać zasobów przydzielonych aplikacji.

Platforma .NET może działać w kontenerze platformy Docker. Oficjalne obrazy platformy Docker platformy .NET są publikowane w usłudze Microsoft Container Registry (MCR) i można je odnaleźć w repozytorium Microsoft .NET Docker Hub. Każde repozytorium zawiera obrazy dla różnych kombinacji platformy .NET (zestawu SDK lub środowiska uruchomieniowego) i systemu operacyjnego, którego można użyć.

Firma Microsoft udostępnia obrazy dostosowane do konkretnych scenariuszy. Na przykład repozytorium ASP.NET Core udostępnia obrazy utworzone na potrzeby uruchamiania aplikacji ASP.NET Core w środowisku produkcyjnym.

Aby uzyskać więcej informacji na temat korzystania z platformy .NET w kontenerze platformy Docker, zobacz Wprowadzenie do platformy .NET i platformy Docker i przykłady.

Następne kroki