Instalowanie platformy .NET w systemie Windows

Z tego artykułu dowiesz się, jak zainstalować platformę .NET w systemie Windows. Platforma .NET składa się ze środowiska uruchomieniowego i zestawu SDK. Środowisko uruchomieniowe jest używane do uruchamiania aplikacji .NET i może być dołączone do aplikacji lub nie może być dołączone do 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 6.

Instalowanie za pomocą Menedżer pakietów systemu Windows (winget)

Platformę .NET można zainstalować i zarządzać nią za pomocą usługi Menedżer pakietów systemu Windows, korzystając z narzędzia do obsługi zestawów narzędzi. Aby uzyskać więcej informacji na temat sposobu instalowania i używania zestawu winget, zobacz Korzystanie z narzędzia winget.

Jeśli instalujesz platformę .NET dla całego systemu, zainstaluj z uprawnieniami administracyjnymi.

Instalacja zestawu SDK

Zestaw .NET SDK umożliwia tworzenie aplikacji przy użyciu platformy .NET. Jeśli zainstalujesz zestaw .NET SDK, nie musisz instalować odpowiednich środowisk uruchomieniowych. Aby zainstalować zestaw .NET SDK, uruchom następujące polecenie:

winget install Microsoft.DotNet.SDK.6

Instalowanie środowiska uruchomieniowego

W przypadku systemu Windows można zainstalować trzy środowiska uruchomieniowe platformy .NET. Należy zainstalować środowisko uruchomieniowe programu .NET Desktop i środowisko uruchomieniowe ASP.NET Core, aby zapewnić zgodność ze wszystkimi typami aplikacji platformy .NET.

  • Środowisko uruchomieniowe programu .NET Desktop

    To środowisko uruchomieniowe obejmuje podstawowe środowisko uruchomieniowe platformy .NET i obsługuje aplikacje Windows Presentation Foundation (WPF) i Windows Forms, które są kompilowane przy użyciu platformy .NET. Nie jest to samo, co .NET Framework, który jest dostarczany z systemem Windows.

    winget install Microsoft.DotNet.DesktopRuntime.6
    
  • środowisko uruchomieniowe ASP.NET Core

    To środowisko uruchomieniowe obejmuje podstawowe środowisko uruchomieniowe platformy .NET i uruchamia aplikacje serwera internetowego. Środowisko uruchomieniowe ASP.NET Core umożliwia uruchamianie aplikacji wykonanych za pomocą platformy .NET, które nie udostępniały środowiska uruchomieniowego. Następujące polecenia instalują środowisko uruchomieniowe ASP.NET Core, które jest najbardziej zgodnym środowiskiem uruchomieniowym dla platformy .NET. W terminalu uruchom następujące polecenia:

    winget install Microsoft.DotNet.Runtime.6
    
  • Środowisko uruchomieniowe platformy .NET

    Jest to podstawowe środowisko uruchomieniowe i zawiera tylko składniki potrzebne do uruchomienia aplikacji konsolowej. Zazwyczaj należy zainstalować inne środowiska uruchomieniowe.

    winget install Microsoft.DotNet.AspNetCore.6
    

Wersje zapoznawcze środowisk uruchomieniowych można zainstalować, zastępując numer wersji, taki jak 6, wyrazem Preview. W poniższym przykładzie jest instalowana wersja zapoznawcza środowiska uruchomieniowego programu .NET Desktop:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalowanie obok Visual Studio Code

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

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

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

Instalowanie za pomocą Instalatora Windows

Strona pobierania dla platformy .NET udostępnia pliki wykonywalne Instalatora Windows.

W przypadku używania instalatorów systemu Windows do zainstalowania platformy .NET możesz dostosować ścieżkę instalacji, ustawiając DOTNETHOME_X64 parametry i DOTNETHOME_X86 :

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

Jeśli chcesz zainstalować platformę .NET w trybie dyskretnym, na przykład w środowisku produkcyjnym lub obsługiwać ciągłą integrację, użyj następujących przełączników:

  • /install
    Instaluje platformę .NET.

  • /quiet
    Zapobiega wyświetlaniu jakichkolwiek interfejsów użytkownika i monitów.

  • /norestart
    Pomija wszelkie próby ponownego uruchomienia.

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

Aby uzyskać więcej informacji, zobacz Opcje Command-Line Instalatora standardowego.

Porada

Instalator zwraca kod zakończenia 0 dla powodzenia i kod zakończenia 3010, aby wskazać, że wymagane jest ponowne uruchomienie. Każda inna wartość jest zazwyczaj kodem błędu.

Instalowanie przy użyciu automatyzacji programu PowerShell

Skrypty dotnet-install są używane do automatyzacji ciągłej integracji i instalacji środowiska uruchomieniowego bez uprawnień administratora. Skrypt można pobrać ze strony dokumentacji skryptu dotnet-install.

Skrypt domyślnie instaluje najnowszą wersję obsługi długoterminowej (LTS ), czyli .NET 6. 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.

dotnet-install.ps1 -Channel 6.0 -Runtime aspnetcore

Zainstaluj zestaw SDK, pomijając -Runtime przełącznik. Przełącznik -Channel jest ustawiony w tym przykładzie na Current, który instaluje najnowszą obsługiwaną wersję.

dotnet-install.ps1 -Channel Current

Instalowanie przy użyciu programu Visual Studio

Jeśli używasz programu Visual Studio do tworzenia aplikacji platformy .NET, w poniższej tabeli opisano minimalną wymaganą wersję programu Visual Studio opartą na docelowej wersji zestawu .NET SDK.

Wersja zestawu SDK platformy .NET Wersja programu Visual Studio
6.0 Program Visual Studio 2022 w wersji 17.0 lub nowszej.
5.0 Program Visual Studio 2019 w wersji 16.8 lub nowszej.
3,1 Program Visual Studio 2019 w wersji 16.4 lub nowszej.
3.0 Program Visual Studio 2019 w wersji 16.3 lub nowszej.
2,2 Program Visual Studio 2017 w wersji 15.9 lub nowszej.
2.1 Program Visual Studio 2017 w wersji 15.7 lub nowszej.

Jeśli masz już zainstalowany program Visual Studio, możesz sprawdzić swoją wersję, wykonując następujące kroki.

  1. Otwórz program Visual Studio.
  2. Wybierz pozycję Pomoc>dotyczącą programu Microsoft Visual Studio.
  3. Przeczytaj numer wersji w oknie dialogowym Informacje .

Program Visual Studio może zainstalować najnowszy zestaw .NET SDK i środowisko uruchomieniowe.

Wybieranie obciążenia

Podczas instalowania lub modyfikowania programu Visual Studio wybierz co najmniej jedno z następujących obciążeń w zależności od rodzaju kompilowania aplikacji:

  • Obciążenie programistyczne dla wielu platform platform .NET Core w sekcji Inne zestawy narzędzi .
  • Obciążenie ASP.NET i tworzenia aplikacji internetowych w sekcji Chmura internetowa&.
  • Obciążenie programowanie na platformie Azure w sekcji Chmura internetowa&.
  • Obciążenie programowanie aplikacji klasycznych platformy .NET w sekcji Desktop & Mobile .

Windows Visual Studio 2019 z obciążeniem platformy .NET Core

Obsługiwane wersje

Poniższa tabela zawiera listę obecnie obsługiwanych wersji platformy .NET i obsługiwanych wersji systemu Windows. Te wersje pozostają obsługiwane do momentu osiągnięcia końca wsparcia przez wersję platformy .NET lub wersja systemu Windows osiągnie koniec okresu eksploatacji.

Windows 10 wersje daty zakończenia usługi są podzielone według wersji. W poniższej tabeli uwzględniono tylko wersje Home, Pro, Pro Education i Pro for Workstations. Aby uzyskać szczegółowe informacje, zapoznaj się z arkuszem faktów cyklu życia systemu Windows .

Porada

+ Symbol reprezentuje minimalną wersję.

System operacyjny .NET Core 3.1 .NET 6
Windows 11 ✔️ ✔️
Windows Server 2022 ✔️ ✔️
Windows 10 wersja 21H1 ✔️ ✔️
Windows 10/ Windows Server, wersja 20H2 ✔️ ✔️
Windows 10 / Windows Server, wersja 2004 ✔️ ✔️
Windows 10 / Windows Server, wersja 1909 ✔️ ✔️
Windows 10 / Windows Server, wersja 1903 ✔️ ✔️
Windows 10, wersja 1809 ✔️ ✔️
Windows 10, wersja 1803 ✔️ ✔️
Windows 10, wersja 1709 ✔️ ✔️
Windows 10, wersja 1607 ✔️ ✔️
Windows 8.1 ✔️ ✔️
Windows 7 z dodatkiem SP1 ESU ✔️ ✔️
Windows Server 2019
Windows Server 2016
Windows Server 2012 z dodatkiem R2
Windows Server 2012
✔️ ✔️
Windows Server Core 2012 R2 ✔️ ✔️
Windows Server Core 2012 ✔️ ✔️
Nano Server, wersja 1809+ ✔️ ✔️
Nano Server, wersja 1803 ✔️

Aby uzyskać więcej informacji na temat obsługiwanych systemów operacyjnych, dystrybucji i zasad cyklu życia platformy .NET 6, zobacz .NET 6 Supported OS Versions (Obsługiwane wersje systemu operacyjnego platformy .NET 6).

Nieobsługiwane wydania

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

  • .NET 5
  • .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, użytkownik musi zainstalować środowisko uruchomieniowe.

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

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

  • Środowisko uruchomieniowe pulpitu
    Uruchamia aplikacje klasyczne .NET WPF i Windows Forms dla systemu Windows. 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 i środowiska uruchomieniowegopulpitu 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 wszystkie trzy środowiska uruchomieniowe: ASP.NET Core, Desktop i .NET.

Komputery z systemem Windows oparte na usłudze Arm

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

Jakie operacje są obsługiwane

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

Wersja platformy .NET Architektura SDK Środowisko uruchomieniowe Konflikt ścieżki
6.0 Arm64 Tak Tak Nie
6.0 x64 Tak Tak Nie
5.0 Arm64 Tak Tak Tak
5.0 x64 Nie Tak Tak
3,1 Arm64 Nie Nie Nie dotyczy
3,1 x64 Nie Tak Tak

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

Różnice ścieżki

Na komputerze z systemem Windows opartym na usłudze Arm64 wszystkie wersje platformy .NET są instalowane w normalnym folderze C:\Program Files\dotnet\ . Jednak podczas instalowania wersji x64 zestawu .NET 6 SDK jest on zainstalowany w folderze C:\Program Files\dotnet\x64\.

Konflikty ścieżek

Zestaw SDK platformy .NET 6 x6 jest instalowany we własnym katalogu, zgodnie z opisem w poprzedniej sekcji. Dzięki temu na tej samej maszynie mogą istnieć wersje zestawu .NET 6 SDK w wersji Arm64 i x64. Jednak każdy zestaw SDK x64 przed wersją 6.0 nie jest obsługiwany i instalowany w tej samej lokalizacji co wersja arm64, folder C:\Program Files\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 zainstalowano zarówno wersje zestawu SDK platformy .NET 6, jak i x64. Ponadto niektóre narzędzia opierają się na zmiennej środowiskowej DOTNET_ROOT , która również musi zostać zaktualizowana, aby wskazać odpowiedni folder instalacyjny zestawu .NET 6 SDK.

Zależności

Następujące wersje systemu Windows są obsługiwane przy użyciu platformy .NET 6:

Uwaga

+ Symbol reprezentuje minimalną wersję.

System operacyjny Wersja Architektury
Windows 11 21H2 x64, Arm64
klient Windows 10 1607+ x64, x86, Arm64
Klient systemu Windows 7 SP1+, 8.1 x64, x86
Windows Server 2012+ x64, x86
Windows Server Core 2012+ x64, x86
Nano Server 1809+ x64

Aby uzyskać więcej informacji na temat obsługiwanych systemów operacyjnych, dystrybucji i zasad cyklu życia platformy .NET 6, zobacz Obsługiwane wersje systemu operacyjnego .NET 6.

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

Więcej zależności jest wymaganych, jeśli instalujesz zestaw .NET SDK lub środowisko uruchomieniowe w następujących wersjach systemu Windows:

System operacyjny Wymagania wstępne
Windows 7 z dodatkiem SP1 ESU - Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /
- KB3063858 64-bitowa32-bitowa /
- Główny urząd certyfikacji firmy Microsoft 2011 (tylko instalator offline platformy .NET Core 2.1)
Windows Vista SP 2 Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /
Windows 8.1 Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /
Windows Server 2008 z dodatkiem R2 Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /
Windows Server 2012 Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /
Windows Server 2012 z dodatkiem R2 Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /

Poprzednie wymagania są również wymagane, jeśli wystąpi błąd związany z jedną z następujących bibliotek dll:

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

Docker

Kontenery zapewniają lekki sposób izolowania aplikacji od reszty systemu hosta. Kontenery na tym samym komputerze współużytkować tylko jądro i używać zasobów przekazanych aplikacji.

Platforma .NET może działać w kontenerze platformy Docker. Oficjalne obrazy platformy Docker platformy .NET są publikowane w rejestrze 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 zawiera 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.

Rozwiązywanie problemów

Po zainstalowaniu zestawu .NET SDK mogą wystąpić problemy podczas próby uruchomienia poleceń interfejsu wiersza polecenia platformy .NET. Ta sekcja zbiera te typowe problemy i udostępnia rozwiązania.

Nie można odnaleźć zainstalowanych zestawów SDK platformy .NET Core

Najprawdopodobniej zainstalowano zarówno wersje x86 (32-bitowe) i x64 (64-bitowe) zestawu .NET SDK. Powoduje to konflikt, ponieważ po uruchomieniu dotnet polecenia jest ono rozpoznawane w wersji x86, gdy powinno zostać rozpoznane w wersji x64. Jest to zwykle naprawione przez dostosowanie zmiennej %PATH% w celu rozpoznania najpierw wersji x64.

  1. Sprawdź, czy masz zainstalowane obie wersje, uruchamiając where.exe dotnet polecenie . Jeśli to zrobisz, powinien zostać wyświetlony wpis dla folderów Program Files\ i Program Files (x86).\ Jeśli folder Program Files (x86)\ jest najpierw wskazany w poniższym przykładzie, jest niepoprawny i należy przejść do następnego kroku.

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

    Jeśli jest to poprawne, a plik Program Files\ jest pierwszy, nie masz problemu, który omawia ta sekcja i należy utworzyć problem z żądaniem pomocy platformy .NET w usłudze GitHub

  2. Naciśnij przycisk Systemu Windows i wpisz ciąg "Edytuj zmienne środowiskowe systemu", aby wyszukać. Wybierz pozycję Edytuj zmienne środowiskowe systemowe.

    Menu Start systemu Windows z edytowaniem zmiennej środowiskowej

  3. Zostanie otwarte okno Właściwości systemu na karcie Zaawansowane. Wybierz pozycję Zmienne środowiskowe.

    Zostanie otwarty panel właściwości systemu Windows.

  4. W oknie Zmienne środowiskowe w grupie Zmienne systemowe wybierz wiersz Ścieżka*, a następnie wybierz przycisk Edytuj .

    Okno zmiennych środowiskowych ze zmiennymi użytkownika i systemu.

  5. Użyj przycisków Przenieś w górę i Przenieś w dół , aby przenieść wpis C:\Program Files\dotnet\ powyżej C:\Program Files (x86)\dotnet\.

    Lista zmiennych środowiskowych dla systemu.

Następne kroki