Instalowanie platformy .NET na platformie Windows

Z tego artykułu dowiesz się, jak zainstalować platformę .NET w 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 z zestawem SDK.

Najnowsza wersja platformy .NET to 6.

Obsługiwane wersje

Poniższa tabela zawiera listę obecnie obsługiwanych wersji platformy .NET oraz wersje Windows, na których są obsługiwane. Te wersje pozostają obsługiwane, dopóki wersja platformy .NET nie osiągnie końca wsparcia lub wersja 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 informacyjnym cyklu życia Windows.

Porada

+ Symbol reprezentuje minimalną wersję.

System operacyjny .NET Core 3.1 .NET 5 .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 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. Pliki do pobrania dla tych elementów nadal pozostają opublikowane:

  • .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 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 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 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 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 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 Windows opartym na architekturze 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 instalowany w folderze C:\Program Files\dotnet\x64\ .

Konflikty ścieżek

Zestaw .NET 6 SDK x64 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 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 zmienna PATH , mogą wymagać zmiany, jeśli masz zainstalowane wersje zestawu SDK platformy .NET 6 i x64. Ponadto niektóre narzędzia opierają się na zmiennej DOTNET_ROOT środowiskowej, która również musi zostać zaktualizowana w celu wskazania odpowiedniego folderu instalacyjnego zestawu .NET 6 SDK.

Zależności

W przypadku platformy .NET 6 obsługiwane są następujące wersje Windows:

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 .NET 6 Supported OS Versions (Obsługiwane wersje systemu operacyjnego platformy .NET 6).

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

Jeśli instalujesz zestaw SDK platformy .NET lub środowisko uruchomieniowe w następujących wersjach Windows, wymagana jest większa liczba zależności:

System operacyjny Wymagania wstępne
Windows 7 SP1 ESU - Microsoft Visual C++ 2015-2019 Redystrybucyjny 64-bitowy32-bitowy /
— KB3063858 64-bitowy32-bitowy /
- 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

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 Visual Studio

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

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

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

  1. Otwórz program Visual Studio.
  2. Wybierz pozycję HelpAbout>Microsoft Visual Studio.
  3. Przeczytaj numer wersji w oknie dialogowym Informacje .

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

Wybieranie obciążenia

Podczas instalowania lub modyfikowania 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 with .NET Core workload

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 jest wyposażony w zautomatyzowany instalator platformy .NET Core, taki jak 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.

Instalator Windows

Strona pobierania dla platformy .NET zawiera pliki wykonywalne instalatora Windows.

Korzystając z instalatorów 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.

Pobieranie i ręczne instalowanie

Zamiast instalatorów Windows dla platformy .NET można pobrać i ręcznie zainstalować zestaw SDK lub środowisko uruchomieniowe. Instalacja ręczna jest zwykle wykonywana w ramach ciągłego testowania integracji. W przypadku dewelopera lub użytkownika zazwyczaj lepiej jest użyć instalatora.

Zarówno zestaw .NET SDK, jak i środowisko uruchomieniowe platformy .NET można zainstalować ręcznie po ich pobraniu. Jeśli zainstalujesz zestaw .NET SDK, nie musisz instalować odpowiedniego środowiska uruchomieniowego. Najpierw pobierz wersję binarną zestawu SDK lub środowiska uruchomieniowego z jednej z następujących witryn:

Utwórz katalog w celu wyodrębnienia pliku .NET, na przykład %USERPROFILE%\dotnet. Następnie wyodrębnij pobrany plik zip do tego katalogu.

Domyślnie polecenia interfejsu wiersza polecenia platformy .NET i aplikacje nie będą używać platformy .NET zainstalowanej w ten sposób i musisz jawnie zdecydować się na jej użycie. W tym celu zmień zmienne środowiskowe, z którymi jest uruchamiana aplikacja:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

Takie podejście umożliwia zainstalowanie wielu wersji w oddzielnych lokalizacjach, a następnie jawne wybranie lokalizacji instalacji, której aplikacja powinna używać, uruchamiając aplikację ze zmiennymi środowiskowymi wskazującymi tę lokalizację.

Gdy DOTNET_MULTILEVEL_LOOKUP jest ustawiona wartość 0, platforma .NET ignoruje dowolną globalnie zainstalowaną wersję platformy .NET. Usuń to ustawienie środowiska, aby umożliwić platformie .NET rozważenie domyślnej globalnej lokalizacji instalacji podczas wybierania najlepszej platformy do uruchamiania aplikacji. Wartość domyślna to zazwyczaj C:\Program Files\dotnet, czyli miejsce, w którym instalatory instalują platformę .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 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órych można użyć.

Firma Microsoft udostępnia obrazy dostosowane do konkretnych scenariuszy. 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 Introduction to .NET and Docker and Samples (Wprowadzenie do platformy .NET i platformy Docker i przykładów).

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 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ć rozwiązane z wersją x64. Zwykle jest to naprawione przez dostosowanie zmiennej %PATH% w celu uprzedniego rozpoznania wersji x64.

  1. Sprawdź, czy masz zainstalowane obie wersje, uruchamiając where.exe dotnet polecenie . Jeśli tak, powinien zostać wyświetlony wpis dla folderów Program Files\ i Program Files (x86)\ . Jeśli folder Program Files (x86)\ jest pierwszy 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 program files\ jest pierwszy, nie masz problemu, który omawia ta sekcja i należy utworzyć problem z żądaniem pomocy platformy .NET w GitHub

  2. Naciśnij przycisk Windows i wpisz "Edytuj zmienne środowiskowe systemu" w celu wyszukania. Wybierz pozycję Edytuj systemowe zmienne środowiskowe.

    Windows start menu with edit environment variable

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

    The Windows system properties panel open.

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

    The environment variables window with user and system variables.

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

    The environment variables list for the system.

Następne kroki