Instalowanie platformy .NET w systemie macOS
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.
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 6 (LTS) |
---|---|---|
macOS 14.0 "Sonoma" | ✔️ 8.0 | ✔️ 6.0 |
macOS 13.0 "Ventura" | ✔️ 8.0 | ✔️ 6.0 |
macOS 12.0 "Monterey" | ✔️ 8.0 | ✔️ 6.0 |
macOS 11.0 "Big Sur" | ❌ | ✔️ 6.0 |
macOS 10.15 "Catalina" | ❌ | ✔️ 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 7
- .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.
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:
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:
- ✔️ Pliki do pobrania platformy .NET 8
- ✔️ Pliki do pobrania platformy .NET 6
- Wszystkie pliki do pobrania platformy .NET
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.
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:
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:
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.
Na stronie wydania zobaczysz wersję środowiska uruchomieniowego platformy .NET i zestawu .NET SDK oraz link do pliku sumy kontrolnej:
Skopiuj link do pliku sumy kontrolnej.
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
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_ROOT
DOTNET_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 | SDK | Środowisko uruchomieniowe | Konflikt ścieżki |
---|---|---|---|
8 | Tak | Tak | Nie. |
8 | Tak | Tak | Nie. |
6 | Tak | Tak | Nie. |
6 | Tak | Tak | Nie. |
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
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). |
6.0 | Program Visual Studio 2022 dla komputerów Mac w wersji 17.0 lub nowszej. |
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ą:
- Program Visual Studio Code z zestawem deweloperskim języka C# i powiązanymi rozszerzeniami, takimi jak .NET MAUI i Unity.
- Program Visual Studio uruchomiony w systemie Windows na maszynie wirtualnej na komputerze Mac.
- Program Visual Studio uruchomiony w systemie Windows na maszynie wirtualnej w chmurze.
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.
- Pobierz i zainstaluj program Visual Studio Code.
- Pobierz i zainstaluj zestaw .NET SDK.
- 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
Aby dowiedzieć się, jak używać interfejsu wiersza polecenia platformy .NET, zobacz Omówienie interfejsu wiersza polecenia platformy .NET.
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.
Firma Microsoft udostępnia obrazy dostosowane do konkretnych scenariuszy. 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ć. 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.