Instalace .NET v systému macOS

• Nainstalovat na Windows
• Instalace v systému macOS
• Nainstalovat na Linux

V tomto článku se dozvíte, které verze .NET jsou podporované v systému macOS, jak nainstalovat .NET a jaký je rozdíl mezi sadou SDK a modulem runtime.

Nejnovější verze .NET je 10.

Stáhnout .NET

Podporované verze

Následující tabulka obsahuje seznam podporovaných verzí .NET a podporovaných verzí pro macOS. Tyto verze zůstanou podporované, dokud verze .NET nedosáhne konce podpory nebo verze macOS už není podporovaná.

Verze 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

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

• .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

Modul runtime nebo sada SDK

runtime slouží 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 nainstaloval správný modul runtime.

V systému macOS můžete nainstalovat dva moduly runtime a obě moduly jsou součástí sady SDK.

• ASP.NET Core Runtime
  Spouští ASP.NET Core aplikace. Zahrnuje .NET runtime. Není k dispozici jako instalační program.

• .NET Runtime
  To spouští normální .NET aplikace, ale ne specializované aplikace, jako jsou aplikace založené na ASP.NET Core.

Sada SDK slouží k vytváření a publikování aplikací a knihoven .NET. Nejnovější sada SDK podporuje vytváření aplikací pro předchozí verze .NET. Za normálních okolností byste potřebovali jenom nejnovější nainstalovanou sadu SDK.

Instalace sady SDK zahrnuje standardní .NET Runtime i ASP.NET Core Runtime. Pokud máte například nainstalovanou .NET SDK 9.0, nainstalují se oba moduly .NET Runtime 9.0 a ASP.NET Core 9.0 Runtime. S sadou SDK by se ale nenainstalovala žádná jiná verze modulu runtime a vyžadovala by, abyste ji nainstalovali samostatně.

Volba způsobu instalace .NET

Existují různé způsoby instalace .NET a některé produkty můžou spravovat vlastní verzi .NET. Pokud instalujete .NET prostřednictvím softwaru, který spravuje vlastní verzi .NET, nemusí být povolená pro celý systém. Ujistěte se, že rozumíte důsledkům instalace .NET prostřednictvím jiného softwaru.

Pokud si nejste jistí, kterou metodu byste měli zvolit po kontrole seznamů v následujících částech, pravděpodobně chcete použít balíček instalačního programu .NET.

Vývojáři

• Visual Studio Code - C# Dev Kit

  Nainstalujte rozšíření C# Dev Kit pro Visual Studio Code pro vývoj aplikací .NET. Rozšíření může použít již nainstalovanou sadu SDK nebo ji nainstalovat za vás.

Uživatelé a vývojáři

• Instalační program .NET

  K instalaci .NET použijte samostatný instalační program. Tato metoda představuje typický způsob instalace .NET na vývojářský nebo uživatelský počítač.

• Instalujte .NET pomocí skriptu

  Skript Bash, který dokáže automatizovat instalaci sady SDK nebo modulu runtime. Můžete zvolit, kterou verzi .NET nainstalovat.

• Install .NET ručně

  Tuto metodu instalace použijte, když potřebujete nainstalovat .NET do konkrétní složky a spustit ji kromě jiných kopií .NET.

Instalace .NET

Instalační balíčky jsou k dispozici pro macOS, jednoduchý způsob instalace .NET.

1. Otevřete prohlížeč a přejděte na adresu https://dotnet.microsoft.com/download/dotnet.

2. Vyberte odkaz na verzi .NET, kterou chcete nainstalovat, například .NET 10.0.

   

   Tento odkaz vás přenese na stránku s odkazy ke stažení této verze .NET.

   Pokud chcete nainstalovat sadu SDK, zvolte nejnovější .NET verzi. Sada SDK podporuje vytváření aplikací pro předchozí verze .NET.

   Návod

   Pokud si nejste jistí, kterou verzi si můžete stáhnout, zvolte verzi označenou jako nejnovější.

3. Tato stránka obsahuje odkazy ke stažení sady SDK a modulu runtime. Zde stáhnete .NET SDK nebo .NET Runtime.

   

   Na předchozím obrázku jsou zvýrazněné dva oddíly. Pokud stahujete sadu SDK, přečtěte si část 1. Informace o modulu .NET Runtime najdete v části 2.

   • Oddíl 1 (SDK)

     Tato část je oblast pro stažení sady SDK. Pod sloupcem Instalační programy pro řádek macOS jsou uvedeny dvě architektury: Arm64 a x64.

     • Pokud používáte procesor Apple, například M1 nebo M3 Pro, vyberte Arm64.
     • Pokud používáte procesor Intel, vyberte x64.

   • Oddíl 2 (modul runtime)

     Tato část obsahuje soubory runtime ke stažení. Všimněte si, že odkazy na sloupec Instalační programy na řádku macOS jsou prázdné. Tato část je prázdná, protože modul runtime ASP.NET Core je k dispozici pouze v sadě SDK nebo prostřednictvím binární instalace.

     Posuňte se dolů a vyhledejte standardní .NET Runtime ke stažení.

     

     • Pokud používáte procesor Apple, například M1 nebo M3 Pro, vyberte Arm64.
     • Pokud používáte procesor Intel, vyberte x64.

4. Jakmile se stahování dokončí, otevřete ho.

5. Postupujte podle kroků v instalačním programu.

   snímek obrazovky zobrazující jenom instalační program .NET spuštěný na macOS.

Ruční instalace .NET

Jako alternativu k instalačním programům pro macOS můžete stáhnout a ručně nainstalovat sadu SDK a modul runtime. Ruční instalace se obvykle provádí jako součást automatizace ve scénáři kontinuální integrace. Vývojáři a uživatelé obvykle chtějí použít instalační program.

Návod

Pomocí skriptu install-dotnet.sh proveďte tyto kroky automaticky.

1. Otevřete prohlížeč a přejděte na adresu https://dotnet.microsoft.com/download/dotnet.

2. Vyberte odkaz na verzi .NET, kterou chcete nainstalovat, například .NET 8.0.

   Tento odkaz vás přenese na stránku s odkazy pro stažení této verze .NET.

   Pokud chcete nainstalovat sadu SDK, zvolte nejnovější .NET verzi. Sada SDK podporuje vytváření aplikací pro předchozí verze .NET.

   Návod

   Pokud si nejste jistí, kterou verzi si můžete stáhnout, zvolte verzi označenou jako nejnovější.

   

3. Vyberte odkaz na sadu SDK nebo modul runtime, který chcete nainstalovat. Na řádku macOS vyhledejte sloupec Binárky.

   

   • Pokud používáte procesor Apple, například M1 nebo M3 Pro, vyberte Arm64.
   • Pokud používáte procesor Intel, vyberte x64.

4. Otevřete terminál a přejděte do umístění, kam se stáhl binární soubor .NET.

5. Extrahujte tarball do umístění, kam chcete nainstalovat .NET na vašem systému. Následující příklad používá HOME adresář ~/Applications/.dotnet.

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

Otestujte, že .NET funguje, a to tak, že změníte adresář na místo, kde byl nainstalován .NET, a spusťte příkaz dotnet --info:

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

Instalace .NET pomocí skriptu

Skripty dotnet-install se používají pro automatizaci a neelevatované instalace modulu runtime. Skript si můžete stáhnout z https://dot.net/v1/dotnet-install.sh.

Skript standardně nainstaluje nejnovější verzi long term support (LTS) verze, která je .NET 8. Zadáním přepínače channel můžete zvolit konkrétní verzi. Zahrňte runtime přepínač pro instalaci modulu runtime. Jinak skript nainstaluje sadu SDK.

Návod

Na konci tohoto postupu je k dispozici úryvek skriptového kódu s těmito příkazy.

1. Otevřete terminál.

2. Přejděte do složky, do které chcete skript stáhnout, například ~/Stažené soubory.

3. Pokud nemáte příkaz wget, nainstalujte ho pomocí nástroje Brew.

   brew install wget
   

4. Spuštěním následujícího příkazu stáhněte skript:

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

5. Udělení oprávnění ke spuštění skriptu

   chmod +x dotnet-install.sh
   

6. Spuštěním skriptu nainstalujte .NET.

   Skript ve výchozím nastavení nainstaluje nejnovější sadu SDK do ~/.dotnet adresáře.

   ./dotnet-install.sh
   

Tady jsou všechny příkazy jako jeden skript Bash:

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

Otestujte .NET tak, že přejdete do složky ~/.dotnet a spustíte příkaz dotnet --info:

chdir ~/.dotnet
./dotnet --info

Důležité

Některé programy můžou pomocí proměnných prostředí najít .NET v systému a při otevření nového terminálu nemusí fungovat příkaz dotnet. Pokud potřebujete pomoc s řešením tohoto problému, přečtěte si část Make .NET dostupnou pro celý systém.

Instalace .NET pro Visual Studio Code

Visual Studio Code je výkonný a jednoduchý editor zdrojového kódu, který běží na ploše. Visual Studio Code může využít již nainstalovanou sadu SDK ve vašem systému. Rozšíření C# Dev Kit vám navíc nainstaluje .NET, pokud ještě není nainstalované.

Pokyny k instalaci .NET prostřednictvím Visual Studio Code najdete v tématu Getting Started with C# in VS Code.

Notarizace

Software vytvořený pro macOS, který je distribuovaný pomocí ID vývojáře, musí být notarizován, včetně aplikací vytvořených pomocí .NET.

Pokud spustíte neověřenou aplikaci, zobrazí se okno chyby podobné následujícímu obrázku:

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

Ověřování

Po stažení instalačního programu nebo binární verze ověřte, že nedošlo ke změně nebo poškození souboru. 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 soubor z oficiální stránky pro stažení, kontrolní součet souboru se zobrazí v textovém poli. Vyberte tlačítko Kopírovat pro zkopírování hodnoty kontrolního součtu do schránky.

shasum -a 512 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-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

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

K ověření použijte soubor s kontrolním součtem

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í postup stažení souboru kontrolního součtu a ověření instalačního binárního souboru .NET.

1. Stránka poznámky k verzi pro .NET 9 na GitHub na adrese https://github.com/dotnet/core/tree/main/release-notes/9.0#releases obsahuje oddíl s názvem Releases. Tabulka v této části obsahuje odkazy ke stažení a soubory kontrolních součtů pro každé vydání .NET 9. Následující obrázek ukazuje tabulku verze .NET 8 jako referenci:

   

2. Vyberte odkaz pro verzi .NET, kterou jste stáhli.

   Předchozí část používala .NET SDK 9.0.306, která je ve verzi .NET 9.0.10.

3. Na stránce vydané verze se zobrazí verze .NET Runtime a .NET SDK a odkaz na soubor kontrolního součtu. Následující obrázek ukazuje tabulku verze .NET 8 jako referenci:

   

4. Klikněte pravým tlačítkem myši na odkaz Kontrolní součet a zkopírujte ho do schránky.

5. Otevřete terminál.

6. Použijte curl -O {link} ke stažení souboru kontrolního součtu.

   Nahraďte odkaz v následujícím příkazu odkazem, který jste zkopírovali.

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

7. Stáhněte kontrolní soubor i soubor verze .NET do stejného adresáře a pomocí příkazu shasum -a 512 -c {file} ověřte stažený soubor.

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

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-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.

   $ 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
   

Počítače Mac s architekturou ARM

Následující části popisují, co byste měli zvážit při instalaci .NET na Mac s procesorem Arm.

Rozdíly v cestě

Na Macu založeném na Arm jsou všechny verze .NET Arm64 nainstalované do normální složky /usr/local/share/dotnet/. Když ale nainstalujete x64 verzi sady .NET SDK, nainstaluje se do složky /usr/local/share/dotnet/x64/dotnet/.

Proměnné cesty

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

Řešení problému

K dispozici jsou následující části, které vám pomůžou s řešením potíží:

• Mac s procesorem ARM
• Zpřístupnit .NET na úrovni celého systému

Zpřístupnění .NET pro celý systém

Někdy aplikace ve vašem systému, včetně terminálu, potřebují najít, kde je nainstalovaná .NET. Instalační balíček .NET macOS by měl automaticky nakonfigurovat váš systém. Pokud jste však použili metodu manuální instalace nebo .NET instalační skript, musíte k proměnné PATH přidat adresář, do kterého byl nainstalován .NET.

Některé aplikace můžou při pokusu o určení, kde je nainstalovaná .NET, hledat proměnnou DOTNET_ROOT.

Pro macOS je dostupno mnoho různých shellů a každý má svůj vlastní profil. Příklad:

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

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

• DOTNET_ROOT

  Tato proměnná je nastavená na složku, do které byl nainstalován .NET, 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
  

Související obsah

• Jak zkontrolovat, zda je .NET již nainstalován
• Práce s notářkou Catalina pro macOS
• Tutorial: Vytvořte konzolovou aplikaci .NET.
• Tutorial: Kontejnerizace aplikace .NET