Sdílet prostřednictvím


Instalace .NET na Windows

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

Na rozdíl od .NET Framework není .NET svázaná s vaší verzí Windows. Na Windows můžete mít nainstalovanou jenom jednu verzi .NET Framework. Ale .NET je samostatný a dá se nainstalovat kamkoli do počítače. Některé aplikace můžou obsahovat vlastní kopii .NET.

Ve výchozím nastavení se .NET nainstaluje do adresáře Program Files\dotnet v počítači, pokud metoda instalace nevolí jiný adresář.

Důležité

Pokud instalujete .NET pro celý systém, instalujte s oprávněními správce.

.NET se skládá z modulu runtime a sady SDK. Modul runtime spouští .NET aplikace a sada SDK se používá k vytváření aplikací.

Zvolte správné runtime

Existují tři různé moduly runtime pro Windows, které umožňují spouštění různých typů aplikací. SDK zahrnuje všechna tři běhová prostředí a instalační program pro běhové prostředí může obsahovat další běhové prostředí. Následující tabulka popisuje, který modul runtime je součástí konkrétního instalačního programu .NET:

Instalační program Zahrnuje .NET Runtime Zahrnuje .NET Desktop Runtime. Zahrnuje ASP.NET Core runtime modul
.NET Runtime Ano Ne Ne
.NET Desktop Runtime Ano Ano Ne
ASP.NET Core Runtime Ne Ne Ano
.NET SDK Ano Ano Ano

Abyste měli jistotu, že na Windows můžete spouštět všechny aplikace .NET, nainstalujte ASP.NET Core Runtime i .NET Desktop Runtime. Modul ASP.NET Core Runtime spouští webové aplikace a .NET Desktop Runtime spouští desktopové aplikace, jako je Windows Presentation Foundation (WPF) nebo aplikace Windows Forms.

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 instalační program .NET Instalační program.

Vývojáři

  • Visual Studio

    Pokud chcete vyvíjet aplikace .NET pomocí Visual Studia, použijte Visual Studio. Visual Studio spravuje vlastní kopii .NET. Tato metoda nainstaluje SDK, Runtime a šablony pro Visual Studio.

  • 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 sadu SDK, která už je nainstalovaná, nebo ji nainstalovat za vás.

Uživatelé a vývojáři

  • Instalační program .NET

    Nainstalujte .NET s balíčkem instalačního programu Windows, což je spustitelný soubor, který spustíte. Tato metoda může nainstalovat sadu SDK a modul runtime. Instalace se provádějí v celém systému.

  • Windows Package Manager (WinGet)

    Pomocí WinGet nainstalujte .NET, když chcete spravovat .NET přes příkazový řádek. Tato metoda může nainstalovat sadu SDK a modul runtime. Instalace se provádějí v celém systému.

  • PowerShell

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

Podporované verze

Následující tabulka obsahuje seznam aktuálně podporovaných verzí .NET a verzí Windows, na kterých jsou podporované. Tyto verze zůstanou podporovány, dokud verze .NET nedosáhne konce podpory nebo verze Windows dosáhne konce životnosti.

Návod

Připomínáme, že tato tabulka se vztahuje na moderní .NET (na rozdíl od .NET Framework). Pokud chcete nainstalovat .NET Framework, přečtěte si průvodce instalací .NET Framework.

Data ukončení služeb verzí Windows 10 jsou dělená podle edice. V následující tabulce jsou považovány pouze edice Home, Pro, Pro Education a Pro for Workstations . Konkrétní podrobnosti najdete v seznamu faktů o životním cyklu Windows.

Operační systém .NET 10 (Architektury) .NET 9 (architektury) .NET 8 (Architektury)
Windows 11 (24H2, 23H2, 22H2 Ent/Edu) ✔️ x64, Arm64 ✔️ x64, Arm64 ✔️ x64, Arm64
Windows 10 (22H2) ✔️ x64, Arm64 ✔️ x64, Arm64 ✔️ x64, Arm64
Windows Server 2025
Windows Server 2022
Windows Server 2019
Windows Server, verze 1903 nebo novější
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
✔️ x64, x86 ✔️ x64, x86 ✔️ x64, x86
Windows Server Core 2012 (a také R2) ✔️ x64, x86 ✔️ x64, x86 ✔️ x64, x86
Nano Server (2025, 2022, 2019) ✔️ x64 ✔️ x64 ✔️ x64
Windows 8.1
Windows 7 SP1 ESU

Návod

Symbol + představuje minimální verzi.

Windows 7 / 8.1 / Server 2012

Na Windows 7 a Windows 8.10 už není podporovaná verze .NET. Poslední podporované verze byly .NET 6 a podpora skončila 12. listopadu 2024.

Windows Server 2012 je stále podporovaná libovolnou verzí .NET, která je stále podporovaná.

Všechny tři z těchto verzí Windows vyžadují instalaci dalších závislostí:

Operační systém Požadavky
Windows 7 SP1 ESU – Microsoft Visual C++ 2015-2019 Redistributable 64bitová / 32bitová verze
– KB3063858 64bitové / 32bitové
- Microsoft Root Certificate Authority 2011 (jenom offline instalační program .NET Core 2.1)
Windows 8.1 Microsoft Visual C++ 2015-2019 Redistributable 64bitová / 32bitová verze
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redistributable 64bitová / 32bitová verze
Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 Redistributable 64bitová / 32bitová verze

Pokud se zobrazí chyba související s některou z následujících knihoven DLL, vyžadují se také předchozí požadavky:

  • api-ms-win-crt-runtime-l1-1-0.dll
  • api-ms-win-cor-timezone-l1-1-0.dll
  • hostfxr.dll

Počítače s Windows na architektuře ARM

.NET se podporuje na počítačích s Windows arm. Následující části popisují, co byste měli při instalaci .NET zvážit.

Rozdíly v cestě

Na počítači Windows založeném na arm se všechny verze .NET Arm64 nainstalují do normální složky C:\Program Files\dotnet\. Verze x64 sady .NET SDK je však nainstalovaná do složky C:\Program Files\dotnet\x64\.

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.

Instalace s využitím Visual Studio

Visual Studio nainstaluje vlastní kopii .NET odděleně od ostatních kopií .NET. Různé verze Visual Studio podporují různé verze .NET. Nejnovější verze Visual Studio vždy podporuje nejnovější verzi .NET.

Visual Studio Instalační program nainstaluje a nakonfiguruje Visual Studio. Mezi Visual Studio úlohy patří .NET, jako je vývoj ASP.NET a vývoj webů a .NET vývoj uživatelského rozhraní pro více platforem. Konkrétní verze .NET je možné nainstalovat prostřednictvím karty Individual Components.

Dokumentace k Visual Studio obsahuje pokyny, jak:

Snímek obrazovky znázorňující Visual Studio Instalátor se zvýrazněnou sadou nástrojů .NET Desktop obklopenou červeným rámečkem.

.NET verze a Visual Studio

Pokud k vývoji aplikací .NET používáte Visual Studio, popisuje následující tabulka minimální požadovanou verzi Visual Studio na základě cílové verze sady .NET SDK.

verze sady .NET SDK verze Visual Studio
10 Visual Studio 2026 verze 18.0 nebo vyšší.
9 Visual Studio 2022 verze 17.12 nebo vyšší.
8 Visual Studio 2022 verze 17.8 nebo vyšší.
7 Visual Studio 2022 verze 17.4 nebo vyšší.
6 Visual Studio 2022 verze 17.0 nebo vyšší.
5 Visual Studio 2019 verze 16.8 nebo novější.
3.1 Visual Studio 2019 verze 16.4 nebo vyšší.
3,0 Visual Studio 2019 verze 16.3 nebo vyšší.
2,2 Visual Studio 2017 verze 15.9 nebo novější.
2.1 Visual Studio 2017 verze 15.7 nebo vyšší.

Pokud už máte nainstalované Visual Studio, můžete zkontrolovat verzi pomocí následujícího postupu.

  1. Otevřete Visual Studio.
  2. Vyberte Help>About Microsoft Visual Studio.
  3. Přečtěte si číslo verze z dialogu About.

Další informace najdete v tématu .NET SDK, MSBuild a Visual Studio správy verzí.

Instalace pomocí 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.

Důležité

Pokud instalujete .NET pro celý systém, instalujte s oprávněními správce.

Tento konfigurační soubor WinGet nainstaluje nejnovější sadu .NET SDK, Visual Studio Code a sadu DevKit jazyka C#. Pokud už máte některý z nich nainstalovaný, WinGet tento krok přeskočí.

  1. Stáhněte soubor a poklikáním ho spusťte.
  2. Přečtěte si licenční smlouvu, zadejte ya po zobrazení výzvy k přijetí vyberte Enter.
  3. Pokud se na hlavním panelu zobrazí výzva řízení uživatelských účtů (UAC), povolte instalaci pokračovat.

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.

instalační program .NET

Stránka download pro .NET poskytuje spustitelné soubory instalačního programu Windows.

Důležité

Pokud instalujete .NET pro celý systém, instalujte s oprávněními správce.

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

  2. Vyberte verzi .NET, kterou chcete stáhnout, například 10.0.

  3. Vyhledejte pole sdk nebo modulu runtime, které obsahuje odkazy pro stahování .NET.

  4. Ve sloupci Instalátory najděte řádek Windows a vyberte odkaz pro architekturu procesoru. Pokud si nejste jistí, vyberte x64 , protože je nejběžnější.

    Prohlížeč by měl instalační program automaticky stáhnout.

    Návod

    Následující obrázek ukazuje sadu SDK, ale můžete si také stáhnout modul runtime.

     Obrázek stránky pro stažení .NET se zvýrazněným odkazem pro stažení sady SDK.

  5. Otevřete Průzkumníka Windows a přejděte do umístění, kam byl soubor stažen, pravděpodobně do složky Stahy.

  6. Poklikáním na soubor nainstalujte .NET.

    Otevře se dialogové okno instalačního programu Windows.

    snímek obrazovky okna aplikace instalačního programu .NET.

  7. Vyberte Install a podle pokynů nainstalujte .NET.

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Možnosti příkazového řádku

Pomocí parametru /? zobrazíte seznam možností.

Pokud chcete nainstalovat .NET bezobslužně, například v produkčním prostředí nebo podporovat kontinuální integraci, použijte následující možnosti:

  • /install
    Nainstaluje .NET.

  • /quiet
    Zabrání zobrazení všech uživatelských rozhraní a výzev.

  • /norestart
    Potlačuje jakékoliv pokusy o restartování.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

Pokud jste už nainstalovali .NET, ke správě instalace použijte instalační program .NET. Místo /installpoužijte jednu z následujících možností:

  • /uninstall
    Odeberte tuto verzi .NET.

  • /repair
    Zkontrolujte, jestli jsou poškozené soubory nebo součásti instalačního klíče a obnovte je.

Návod

Instalační program vrátí ukončovací kód 0 pro úspěch a ukončovací kód 3010 , který indikuje, že se vyžaduje restartování. Jakákoli jiná hodnota je s největší pravděpodobností kód chyby.

Microsoft Update

Spustitelné soubory instalačního programu .NET jsou nezávislé produkty, které lze obsluhovat pomocí služby Microsoft Update (MU) na Windows. MU se liší od Windows Update (WU), která se používá k poskytování komponent operačního systému, jako je .NET Framework.

Prostřednictvím MU jsou poskytovány jak bezpečnostní, tak i nebezpečnostní opravy pro podporované verze .NET s využitím několika distribučních kanálů. Automatické aktualizace (AU) jsou relevantní pro koncové uživatele a uživatele, zatímco služba Windows Server Update Services (WSUS) a katalog Windows Update jsou relevantní pro správce IT.

Spustitelné soubory instalačního programu .NET podporují souběžné instalace (SxS) napříč hlavními a dílčími verzemi pro různé architektury a komponenty, jako je modul runtime a sada SDK. Můžete například nainstalovat modul runtime 6.0.15 (x64) i 6.0.17 (x86). Když se MU aktivuje, nabídne nejnovější instalační software pro obě instalace.

Blokování aktualizací

Ačkoli většina uživatelů preferuje být informováni o novinkách, je možné blokovat aktualizace .NET pomocí klíčů registru uvedených v následující tabulce.

verze .NET Klíč registru Název Typ Hodnota
Vše HKLM\SOFTWARE\Microsoft\.NET BlockMU REG_DWORD 0x00000001
.NET 9 HKLM\SOFTWARE\Microsoft\.NET\9.0 BlockMU REG_DWORD 0x00000001
.NET 8 HKLM\SOFTWARE\Microsoft\.NET\8.0 BlockMU REG_DWORD 0x00000001
.NET 7 HKLM\SOFTWARE\Microsoft\.NET\7.0 BlockMU REG_DWORD 0x00000001
.NET 6 HKLM\SOFTWARE\Microsoft\.NET\6.0 BlockMU REG_DWORD 0x00000001
.NET 5 HKLM\SOFTWARE\Microsoft\.NET\5.0 BlockMU REG_DWORD 0x00000001
.NET Core 3.1 HKLM\SOFTWARE\Microsoft\.NET\3.1 BlockMU REG_DWORD 0x00000001
.NET Core 2.1 HKLM\SOFTWARE\Microsoft\.NET\2.1 BlockMU REG_DWORD 0x00000001

Automatické aktualizace operačního systému serveru

Aktualizace serverových operačních systémů jsou podporovány službou WSUS a katalogem služby Microsoft Update, ale nikoli SU. Serverové operační systémy se můžou rozhodnout přijímat aktualizace prostřednictvím AU pomocí následujících klíčů registru.

verze .NET Klíč registru Název Typ Hodnota
Vše HKLM\SOFTWARE\Microsoft\.NET PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001
.NET 9 HKLM\SOFTWARE\Microsoft\.NET\9.0 PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001
.NET 8 HKLM\SOFTWARE\Microsoft\.NET\8.0 PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001
.NET 7 HKLM\SOFTWARE\Microsoft\.NET\7.0 PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001
.NET 6 HKLM\SOFTWARE\Microsoft\.NET\6.0 PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001
.NET 5 HKLM\SOFTWARE\Microsoft\.NET\5.0 PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001
.NET Core 3.1 HKLM\SOFTWARE\Microsoft\.NET\3.1 PovolitAutomatickéAktualizaceNaServerovémOS REG_DWORD 0x00000001

Klasifikace služby WSUS a aktualizace

Službu WSUS je možné nakonfigurovat tak, aby poskytovala konkrétní aktualizace na základě jejich klasifikace. Aktualizace .NET jsou klasifikovány jako bezpečnostní nebo kritické. Pokud je nejnovější aktualizace klasifikovaná jako kritická, může být k dispozici starší aktualizace security, pokud je nainstalovaná starší verze .NET nahrazená nejnovější aktualizací zabezpečení. To platí také pro použití souboru CAB v offline režimu (Wsusscan2.cab) ke skenování počítače.

Poznámka:

V některých případech může služba WSUS hlásit chybějící aktualizaci pro verzi, která je starší než .NET verze, kterou jste nainstalovali. Představte si například, že uživatel nainstaluje .NET 6.0.36, nejnovější verzi .NET 6. Tato verze se klasifikuje jako kritická (nesouvisecí se zabezpečením). Aplikace pak nainstaluje starší verzi 6.0.33. (Není neobvyklé, že aplikace zahrnou konkrétní verze .NET jako předpoklad.) Pokud správce nakonfiguroval službu WSUS tak, aby poskytovala pouze aktualizace zabezpečení, bude další kontrola 6.0.35 hlásit jako chybějící aktualizaci. Počítače nakonfigurované tak, aby přijímaly aktualizace zabezpečení prostřednictvím AU nebo WSUS, budou nabízeny verze 6.0.35, i když je nainstalovaná verze 6.0.36. Důvodem je, že verze 6.0.35 nahrazuje verzi 6.0.33 a je nejnovější aktualizací zabezpečení .

Zvolte, kdy byly odebrány předchozí verze.

Spustitelné soubory instalačního programu vždy instalují nový obsah před odebráním předchozí instalace. Aplikace, které běží, mohou být přerušeny nebo havarovat, když jsou odstraněny starší moduly runtime. Pokud chcete minimalizovat dopad aktualizace .NET, můžete určit, kdy se má předchozí instalace .NET odebrat pomocí klíče registru.

verze .NET Klíč registru Název Typ Hodnota
Vše HKLM\SOFTWARE\Microsoft\.NET OdstranitPředchozíVerzi REG_SZ always, never nebo nextSession
.NET 10 HKLM\SOFTWARE\Microsoft\.NET\10.0 OdstranitPředchozíVerzi REG_SZ always, never nebo nextSession
.NET 9 HKLM\SOFTWARE\Microsoft\.NET\9.0 OdstranitPředchozíVerzi REG_SZ always, never nebo nextSession
.NET 8 HKLM\SOFTWARE\Microsoft\.NET\8.0 OdstranitPředchozíVerzi REG_SZ always, never nebo nextSession
  • never zachovává předchozí instalace a vyžaduje ruční zásah k odebrání předchozích .NET instalací.
  • always odebere předchozí instalace po instalaci nové verze. Toto je výchozí chování v .NET.
  • nextSession odloží odebrání až do další přihlašovací relace členů ve skupině Administrátoři.
  • Hodnoty nerozlišují malá a velká písmena a neplatné hodnoty mají ve výchozím nastavení always.

Při odložení odebrání instalační program zapíše příkaz do klíče registru RunOnce , který odinstaluje předchozí verzi. Příkaz se spustí jenom v případě, že se uživatel ve skupině Administrators přihlásí k počítači.

Poznámka:

Tato funkce je dostupná pouze od verze .NET 8 (8.0.11). Týká se pouze spustitelných souborů samostatného instalačního programu a ovlivňuje distribuce, jako je WinGet, které je používají.

Instalace pomocí Windows Package Manager (WinGet)

Pomocí nástroje winget.exe můžete nainstalovat a spravovat .NET prostřednictvím služby Windows Package Manager. Další informace o tom, jak nainstalovat a používat WinGet, naleznete v tématu Použití nástroje winget k instalaci a správě aplikací.

Důležité

Pokud instalujete .NET pro celý systém, instalujte s oprávněními správce.

Balíčky WinGet .NET jsou:

  • Microsoft.DotNet.Runtime.10 – .NET Runtime 10.0
  • Microsoft.DotNet.AspNetCore.10 – ASP.NET Core Runtime 10.0
  • Microsoft.DotNet.DesktopRuntime.10 – .NET Desktop Runtime 10.0
  • Microsoft.DotNet.SDK.10 – .NET SDK 10.0
  • Microsoft.DotNet.Runtime.9 – .NET Runtime 9.0
  • Microsoft.DotNet.AspNetCore.9 – ASP.NET Core Runtime 9.0
  • Microsoft.DotNet.DesktopRuntime.9 – .NET Desktop Runtime 9.0
  • Microsoft.DotNet.SDK.9 – .NET SDK 9.0
  • Microsoft.DotNet.Runtime.8 – .NET Runtime 8.0
  • Microsoft.DotNet.AspNetCore.8 – ASP.NET Core Runtime 8.0
  • Microsoft.DotNet.DesktopRuntime.8 – .NET Desktop Runtime 8.0
  • Microsoft.DotNet.SDK.8 – .NET SDK 8.0

Nainstalujte sadu SDK .

Pokud nainstalujete sadu SDK, nemusíte instalovat odpovídající modul runtime.

  1. Nainstalujte WinGet.

  2. Otevřete terminál, například PowerShell nebo příkazový řádek.

  3. winget install Spusťte příkaz a předejte název balíčku SDK:

    winget install Microsoft.DotNet.SDK.10
    

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Instalace modulu runtime

Existují různé runtime, které můžete nainstalovat. Informace o tom, co je součástí každého modulu runtime, najdete v části Volba správného modulu runtime.

  1. Nainstalujte WinGet.

  2. Otevřete terminál, například PowerShell nebo příkazový řádek.

  3. winget install Spusťte příkaz a předejte název balíčku SDK:

    winget install Microsoft.DotNet.DesktopRuntime.10
    winget install Microsoft.DotNet.AspNetCore.10
    

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Hledání verzí

winget search Pomocí příkazu vyhledejte různé verze balíčku, který chcete nainstalovat. Například následující příkaz vyhledá všechny sady SDK .NET dostupné přes WinGet:

winget search Microsoft.DotNet.SDK

Výsledky hledání se vytisknou v tabulce s každým identifikátorem balíčku.

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Instalace verzí Preview

Pokud je k dispozici verze Preview, nahraďte číslo verze v ID slovem Preview. Následující příklad nainstaluje verzi Preview modulu .NET Desktop Runtime:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalace pomocí PowerShellu

Instalace .NET prostřednictvím skriptu dotnet-install PowerShell se doporučuje pro kontinuální integraci a instalace bez oprávnění správce. Pokud instalujete .NET pro normální použití v systému, použijte instalační program .NET nebo Windows Package Manager metody instalace.

Skript ve výchozím nastavení nainstaluje nejnovější verzi long term support (LTS) verze, která je .NET 10. 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. Skript je k dispozici na adrese https://dot.net/v1/dotnet-install.ps1 a zdrojový kód je hostovaný na GitHub.

Další informace o skriptu naleznete v tématu dotnet-návod ke skriptu pro instalaci.

Instalace modulu runtime

Modul .NET Runtime je nainstalován zadáním přepínače -Runtime.

  1. Stažení instalačního skriptu z https://dot.net/v1/dotnet-install.ps1

  2. Otevřete PowerShell a přejděte do složky obsahující skript.

  3. Spuštěním následujících příkazů nainstalujte desktopový modul runtime i modul runtime ASP.NET Core za účelem zajištění maximální kompatibility:

    dotnet-install.ps1 -Runtime windowsdesktop
    dotnet-install.ps1 -Runtime aspnetcore
    

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

Nainstalujte sadu SDK .

Pokud nainstalujete sadu SDK, nemusíte instalovat běhové prostředí.

  1. Stažení instalačního skriptu z https://dot.net/v1/dotnet-install.ps1

  2. Otevřete PowerShell a přejděte do složky obsahující skript.

  3. Spuštěním následujícího příkazu nainstalujte sadu .NET SDK.

    dotnet-install.ps1
    

    Poznámka:

    Sada SDK se nainstaluje vynecháním -Runtime přepínače.

Informace o používání rozhraní příkazového řádku .NET najdete v tématu .NET přehled rozhraní příkazového řádku.

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.

Stránka ke stažení .NET s kontrolním součtem

Pomocí PowerShellu nebo příkazového řádku můžete ověřit kontrolní součet staženého souboru. Například následující příkaz hlásí kontrolní součet dotnet souboru-sdk-9.0.306-win-x64.exe :

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.
> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

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

Ověření pomocí PowerShellu a 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í 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 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:

    Tabulka verzí poznámek k vydání na GitHubu pro .NET

  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.

    Návod

    Pokud si nejste jistí, která verze .NET obsahuje váš soubor kontrolního součtu, prozkoumejte odkazy, dokud ho nenajdete.

  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:

    Stahovací tabulka s kontrolními součty pro .NET

  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:

    Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
    
  6. Soubory kontrolního součtu a .NET releaseu si stáhněte do stejného adresáře a v souboru kontrolního součtu vyhledejte kontrolní součet pro .NET stažení:

    Když ověření projde, zobrazí se hodnota True vytištěná:

    > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
    True
    

    Pokud se zobrazí false, stažený soubor není platný a neměl by být používán.

Řešení problému

Po instalaci sady .NET SDK může docházet k problémům při pokusu o spuštění příkazů rozhraní příkazového řádku .NET. Tato část shromažďuje tyto běžné problémy a poskytuje řešení.

Nebyla nalezena žádná sada SDK .NET

S největší pravděpodobností jste nainstalovali verze x86 (32bitové) i x64 (64bitové) sady .NET SDK. To způsobuje konflikt, protože při spuštění dotnet příkazu se překládá na verzi x86, když se má přeložit na verzi x64. Tento problém je opraven úpravou %PATH% proměnné tak, aby se nejprve vyřešila verze x64.

  1. Spuštěním where.exe dotnet příkazu ověřte, že máte nainstalované obě verze. Pokud ano, měla by se zobrazit položka pro složky Program Files\ i Program Files (x86)\. Pokud je první složka Program Files (x86)\, jak ukazuje následující příklad, je nesprávná a měli byste pokračovat k dalšímu kroku.

    > where.exe dotnet
    C:\Program Files (x86)\dotnet\dotnet.exe
    C:\Program Files\dotnet\dotnet.exe
    

    Návod

    I když se v tomto příkladu používá Program Files, mohou se zobrazit další kopie dotnet.exe uvedených. Upravte je tak, aby se nejprve vyřešil soubor dotnet.exe.

    Pokud je správně a Program Files\ je první, nemáte problém, který tento oddíl popisuje a měli byste vytvořit problém s žádostí o pomoc .NET na GitHub.

  2. Stiskněte tlačítko Windows a do hledání zadejte "Upravit proměnné systémového prostředí". Vyberte Upravit proměnné systémového prostředí.

    Windows nabídky Start s možností upravit proměnnou prostředí

  3. Otevře se okno Vlastnosti systému na kartě Upřesnit. Vyberte Proměnné prostředí.

     Panel vlastností systému Windows open.

  4. V okně Proměnné prostředí ve skupině Systémové proměnné vyberte řádek Path* a pak vyberte tlačítko Upravit.

    Okno proměnných prostředí s uživatelskými a systémovými proměnnými.

  5. Pomocí tlačítek Přesunout nahoru a Přesunout dolů přesuňte C:\Program Files\dotnet\ položku nad C:\Program Files (x86)\dotnet\.

    Seznam proměnných prostředí pro systém.

Sestavování aplikací je pomalejší, než se čekalo

Ujistěte se, že je vypnuté inteligentní řízení aplikací, funkce Windows. Na počítačích používaných pro vývoj se nedoporučuje povolit inteligentní řízení aplikací. Jakékoli jiné nastavení než vypnuto může negativně ovlivnit výkon sady SDK.

hostfxr.dll / api-ms-win-crt-runtime-l1-1-0.dll / api-ms-win-cor-timezone-l1-1-0.dll chybí

Nainstalujte Microsoft Visual C++ 2015-2019 Redistributable (64bitová nebo 32bitová verze).