Instalace .NET v systému macOS

• Instalovat do Windows
• Instalace v systému macOS
• Instalace v Linuxu

V tomto článku se dozvíte, jak nainstalovat .NET v systému macOS. .NET se skládá z modulu runtime a sady SDK. Modul runtime se používá ke spuštění aplikace .NET a může nebo nemusí být součástí aplikace. Sada SDK se používá k vytváření aplikací a knihoven .NET. Modul runtime .NET se vždy instaluje se sadou SDK.

Nejnovější verze .NET je 8.

Stáhnout .NET

Podporované verze

Existují dva typy podporovaných verzí: verze dlouhodobé podpory (LTS) a verze standardní podpory (STS). Kvalita všech verzí je stejná. Jediným rozdílem je délka podpory. Verze LTS získají bezplatnou podporu a opravy po dobu tří let. Verze stS získají bezplatnou podporu a opravy po dobu 18 měsíců. Další informace najdete v tématu Zásady podpory .NET.

Následující tabulka obsahuje seznam aktuálně podporovaných verzí .NET a verzí macOS, na kterých jsou podporované:

Operační systém	.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

Úplný seznam verzí .NET a jejich životního cyklu podpory najdete v tématu Zásady podpory .NET.

Nepodporované verze

Následující verze rozhraní .NET se ❌ už nepodporují:

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

Informace o modulu runtime

Modul runtime se používá ke spouštění aplikací vytvořených pomocí .NET. Když autor aplikace publikuje aplikaci, může do aplikace zahrnout modul runtime. Pokud modul runtime nezahrnou, je na uživateli, aby modul runtime nainstaloval.

V systému macOS můžete nainstalovat dva různé moduly runtime:

• modul runtime ASP.NET Core
  Spouští aplikace ASP.NET Core. Zahrnuje modul runtime .NET.

• Modul runtime .NET
  Tento modul runtime je nejjednodušší modul runtime a nezahrnuje žádný jiný modul runtime. Důrazně doporučujeme nainstalovat modul runtime ASP.NET Core, abyste měli nejlepší kompatibilitu s aplikacemi .NET.

Stažení modulu runtime .NET

Informace o sadě SDK

Sada SDK se používá k vytváření a publikování aplikací a knihoven .NET. Instalace sady SDK zahrnuje moduly runtime: ASP.NET Core i .NET.

Notarizace

Počínaje macOS Catalina (verze 10.15) musí být notarizován veškerý software vytvořený po 1. červnu 2019, který je distribuovaný s ID vývojáře. Tento požadavek platí pro modul runtime .NET, sadu .NET SDK a software vytvořený pomocí .NET.

Od 18. února 2020 se nevybrali instalační programy modulu runtime a sady SDK pro .NET. Předchozí vydané verze nejsou notarizovány. Pokud spustíte neověřenou aplikaci, zobrazí se chyba podobná následujícímu obrázku:

Další informace o tom, jak vynucená notarizace ovlivňuje .NET (a vaše aplikace .NET), naleznete v tématu Práce s macOS Catalina Notarization.

libgdiplus

Aplikace .NET, které používají sestavení System.Drawing.Common , vyžadují instalaci knihovny libgdiplus.

Snadný způsob, jak získat libgdiplus, je pomocí Správce balíčků Homebrew ("brew") pro macOS. Po instalaci brew nainstalujte knihovnu libgdiplus spuštěním následujících příkazů na příkazovém řádku terminálu (příkaz):

brew update
brew install mono-libgdiplus

Automatizovaná instalace

macOS má samostatné instalační programy, které je možné použít k instalaci .NET:

• ✔️ Stažení .NET 8
• ✔️ Stažení .NET 7
• ✔️ Stažení .NET 6

Ruční instalace

Jako alternativu k instalačním programům systému macOS pro .NET můžete stáhnout a ručně nainstalovat sadu SDK a modul runtime. Ruční instalace se obvykle provádí jako součást průběžného testování integrace. Pro vývojáře nebo uživatele je obecně lepší použít instalační program.

Stáhněte binární verzi sady SDK nebo modulu runtime z některého z následujících webů. Sada .NET SDK obsahuje odpovídající modul runtime:

• ✔️ Stažení .NET 8
• ✔️ Stažení .NET 7
• ✔️ Stažení .NET 6
• Všechny soubory ke stažení .NET

Extrahujte stažený soubor a pomocí export příkazu nastavte DOTNET_ROOT umístění extrahované složky a pak se ujistěte, že je .NET v cestě PATH. Při exportu DOTNET_ROOT jsou příkazy rozhraní příkazového řádku .NET dostupné v terminálu. Další informace oproměnných

Různé verze rozhraní .NET je možné extrahovat do stejné složky, která spoluexistuje vedle sebe.

Příklad

Následující příkazy používají Bash k nastavení proměnné DOTNET_ROOT prostředí na aktuální pracovní adresář následovaný .dotnet. Tento adresář se vytvoří, pokud neexistuje. DOTNET_FILE Proměnná prostředí je název souboru binární verze .NET, kterou chcete nainstalovat. Tento soubor se extrahuje do DOTNET_ROOT adresáře. Adresář DOTNET_ROOT i jeho tools podadresář se přidají do PATH proměnné prostředí.

Důležité

Pokud tyto příkazy spustíte, nezapomeňte změnit DOTNET_FILE hodnotu na název binárního souboru .NET, který jste stáhli.

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

Do stejné složky můžete nainstalovat více než jednu verzi .NET.

.NET můžete také nainstalovat do domovského adresáře identifikovaného proměnnou HOME nebo ~ cestou:

export DOTNET_ROOT=$HOME/.dotnet

Ověření stažených binárních souborů

Po stažení instalačního programu ověřte, že soubor nebyl změněn nebo poškozen. Kontrolní součet můžete ověřit ve vašem počítači a pak ho porovnat s tím, co bylo hlášeno na webu pro stahování.

Když si stáhnete instalační program nebo binární soubor z oficiální stránky pro stažení, zobrazí se kontrolní součet souboru. Výběrem tlačítka Kopírovat zkopírujte hodnotu kontrolního součtu do schránky.

sha512sum Pomocí příkazu vytiskněte kontrolní součet souboru, který jste stáhli. Například následující příkaz hlásí kontrolní součet souboru 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

Porovnejte kontrolní součet s hodnotou poskytnutou webem pro stahování.

Důležité

I když se v těchto příkladech zobrazuje soubor s Linuxem, platí tyto informace stejně pro macOS.

Ověření pomocí souboru kontrolního součtu

Poznámky k verzi .NET obsahují odkaz na soubor kontrolního součtu, který můžete použít k ověření staženého souboru. Následující kroky popisují, jak stáhnout soubor kontrolního součtu a ověřit binární soubor instalace .NET:

1. Stránka s zprávami k vydání verze pro .NET 8 na GitHubu na webu https://github.com/dotnet/core/tree/main/release-notes/8.0 obsahuje oddíl s názvem Vydané verze. Tabulka v této části odkazuje na soubory stahovaných souborů a kontrolních součtů pro každou verzi .NET 8:

   

2. Vyberte odkaz pro verzi rozhraní .NET, kterou jste stáhli. Předchozí část používala sadu .NET SDK 8.0.100, která je ve verzi .NET 8.0.0.

3. Na stránce vydané verze můžete zobrazit verzi .NET Runtime a .NET SDK a odkaz na soubor kontrolního součtu:

   

4. Zkopírujte odkaz na soubor kontrolního součtu.

5. Použijte následující skript, ale nahraďte odkaz ke stažení příslušného souboru kontrolního součtu:

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

6. S kontrolním součtem i souborem verze .NET staženým do stejného adresáře ověřte stažený soubor pomocí sha512sum -c {file} --ignore-missing příkazu.

   Po úspěšném ověření se zobrazí vytištěný soubor se stavem OK :

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

   Pokud se zobrazí soubor označený jako neúspěšný, stažený soubor není platný a neměl by se používat.

   $ 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
   

Nastavení systémových proměnných prostředí

Pokud jste použili pokyny v části Příklad ruční instalace, proměnné nastavené pouze pro aktuální relaci terminálu. Přidejte je do profilu prostředí. Pro macOS je k dispozici mnoho různých prostředí a každý má jiný profil. Příklad:

• Prostředí Bash: ~/.profile, /etc/profile
• Korn Shell: ~/.kshrc nebo .profile
• Z Shell: ~/.zshrc nebo .zprofile

Nastavte v profilu prostředí následující dvě proměnné prostředí:

• DOTNET_ROOT

  Tato proměnná je nastavená na složku .NET byla nainstalována, například $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Tato proměnná by měla obsahovat DOTNET_ROOT složku i DOTNET_ROOT/tools složku:

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

Počítače Mac založené na armech

Následující části popisují věci, které byste měli zvážit při instalaci .NET na Macu založeném na Arm.

Co je podporováno

Následující tabulka popisuje, které verze rozhraní .NET jsou podporovány na Macu založeném na Arm:

Verze .NET	Architektura	Sada SDK	Šablona běhového prostředí	Konflikt cesty
8	Arm64	Ano	Ano	No
8	x64	Ano	Ano	No
7	Arm64	Ano	Ano	No
7	x64	Ano	Ano	No
6	Arm64	Ano	Ano	No
6	x64	Ano	Ano	No

Od verze .NET 6 existují verze x64 a Arm64 sady .NET SDK nezávisle na sobě. Pokud je vydána nová verze, je potřeba upgradovat každou instalaci.

Rozdíly v cestě

Na Macu založeném na Arm se všechny verze .NET Arm64 nainstalují do normální složky /usr/local/share/dotnet/ . Při instalaci sady .NET SDK verze x64 se ale nainstaluje do složky /usr/local/share/dotnet/x64/dotnet/ .

Konflikty cest

Počínaje rozhraním .NET 6 se sada . NET SDK nainstaluje do vlastního adresáře, jak je popsáno v předchozí části. To umožňuje, aby na stejném počítači existovaly verze sady .NET SDK arm64 a x64. Jakákoli sada x64 SDK před .NET 6 se ale nepodporuje a nainstaluje se do stejného umístění jako verze Arm64, což je složka /usr/local/share/dotnet/ . Pokud chcete nainstalovat nepodporovanou sadu x64 SDK, musíte nejprve odinstalovat verzi Arm64. Opak je také pravdivý, k instalaci verze Arm64 je potřeba odinstalovat nepodporovanou sadu SDK x64.

Proměnné cesty

Proměnné prostředí, které přidávají .NET do systémové cesty, jako PATH je například proměnná, může být potřeba změnit, pokud máte nainstalované verze sady .NET SDK pro platformu x64 i Arm64. Některé nástroje navíc spoléhají na proměnnou DOTNET_ROOT prostředí, která by se také musela aktualizovat tak, aby odkazovala na příslušnou instalační složku sady .NET 6 SDK.

Instalace pomocí Visual Studio pro Mac

Visual Studio pro Mac nainstaluje sadu .NET SDK při výběru úlohy .NET. Pokud chcete začít s vývojem v .NET v systému macOS, přečtěte si téma Instalace sady Visual Studio 2022 pro Mac.

Důležité

Visual Studio pro Mac se vyřadí z důchodu. Další informace najdete v tématu Co se děje s Visual Studio pro Mac?.

Verze sady .NET SDK	Verze sady Visual Studio
8.0	Visual Studio 2022 pro Mac 17.6.1 nebo novější (K dispozici pouze jako funkce Ve verzi Preview.)
7.0	Visual Studio 2022 pro Mac 17.4 nebo novější
6.0	Visual Studio 2022 pro Mac 17.0 nebo novější

Důležité

Společnost Microsoft oznámila vyřazení Visual Studio pro Mac. Visual Studio pro Mac již nebudou podporovány od 31. srpna 2024. Mezi alternativy patří:

• Visual Studio Code se sadou C# Dev Kit a souvisejícími rozšířeními, jako jsou .NET MAUI a Unity.
• Visual Studio spuštěné ve Windows na virtuálním počítači na Macu
• Visual Studio spuštěné ve Windows na virtuálním počítači v cloudu

Další informace najdete v tématu Visual Studio pro Mac oznámení o vyřazení z provozu.

Instalace společně se sadou Visual Studio Code

Visual Studio Code je výkonný a jednoduchý editor zdrojového kódu, který běží na ploše. Visual Studio Code je k dispozici pro Windows, macOS a Linux.

I když Visual Studio Code nepřichází s automatizovaným instalačním programem .NET, jako je Visual Studio, přidání podpory .NET je jednoduché.

1. Stáhněte a nainstalujte Visual Studio Code.
2. Stáhněte a nainstalujte sadu .NET SDK.
3. Nainstalujte rozšíření C# z marketplace editoru Visual Studio Code.

Instalace s využitím automatizace Bash

Skripty dotnet-install se používají pro automatizaci a neinstalované instalace modulu runtime. Skript si můžete stáhnout z referenční stránky skriptu dotnet-install.

Skript ve výchozím nastavení nainstaluje nejnovější verzi dlouhodobé podpory (LTS), což je .NET 8. Konkrétní verzi můžete zvolit zadáním channel přepínače. Zahrňte runtime přepínač pro instalaci modulu runtime. Jinak skript nainstaluje sadu SDK.

Následující příkaz nainstaluje modul runtime ASP.NET Core pro zajištění maximální kompatibility. Modul runtime ASP.NET Core zahrnuje také standardní modul runtime .NET.

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

Docker

Kontejnery poskytují jednoduchý způsob izolace aplikace od zbytku hostitelského systému. Kontejnery na stejném počítači sdílejí jenom jádro a používají prostředky poskytnuté vaší aplikaci.

.NET může běžet v kontejneru Dockeru. Oficiální image Dockeru .NET se publikují do služby Microsoft Container Registry (MCR) a jsou zjistitelné v úložišti Microsoft .NET Docker Hub. Každé úložiště obsahuje image pro různé kombinace .NET (SDK nebo runtime) a operačního systému, které můžete použít.

Microsoft poskytuje obrázky přizpůsobené konkrétním scénářům. Úložiště ASP.NET Core například poskytuje image vytvořené pro spouštění aplikací ASP.NET Core v produkčním prostředí.

Další informace o používání .NET v kontejneru Dockeru najdete v tématu Úvod do .NET a Dockeru a ukázek.

Další kroky

• Postup kontroly, jestli už je .NET nainstalovaný.
• Práce s notářkou Catalina pro macOS
• Kurz: Začínáme s macOS
• Kurz: Vytvoření nové aplikace pomocí editoru Visual Studio Code
• Kurz: Kontejnerizace aplikace .NET