diff --git a/docs/core/media/windows-prerequisites/Targeting-dotnetCore2.png b/docs/core/media/windows-prerequisites/Targeting-dotnetCore2.png deleted file mode 100644 index c2179291218f6..0000000000000 Binary files a/docs/core/media/windows-prerequisites/Targeting-dotnetCore2.png and /dev/null differ diff --git a/docs/core/media/windows-prerequisites/targeting-dotnet-core.jpg b/docs/core/media/windows-prerequisites/targeting-dotnet-core.jpg new file mode 100644 index 0000000000000..f71121baf0c2c Binary files /dev/null and b/docs/core/media/windows-prerequisites/targeting-dotnet-core.jpg differ diff --git a/docs/core/media/windows-prerequisites/vs-15-3-workloads.jpg b/docs/core/media/windows-prerequisites/vs-15-3-workloads.jpg deleted file mode 100644 index e72d1e9ffe2be..0000000000000 Binary files a/docs/core/media/windows-prerequisites/vs-15-3-workloads.jpg and /dev/null differ diff --git a/docs/core/media/windows-prerequisites/vs-15-8-workloads.jpg b/docs/core/media/windows-prerequisites/vs-15-8-workloads.jpg deleted file mode 100644 index b1ee229ea180e..0000000000000 Binary files a/docs/core/media/windows-prerequisites/vs-15-8-workloads.jpg and /dev/null differ diff --git a/docs/core/media/windows-prerequisites/vs-2017-workloads.jpg b/docs/core/media/windows-prerequisites/vs-2017-workloads.jpg new file mode 100644 index 0000000000000..5d61b567643e3 Binary files /dev/null and b/docs/core/media/windows-prerequisites/vs-2017-workloads.jpg differ diff --git a/docs/core/media/windows-prerequisites/vs_workloads.jpg b/docs/core/media/windows-prerequisites/vs-workloads.jpg similarity index 100% rename from docs/core/media/windows-prerequisites/vs_workloads.jpg rename to docs/core/media/windows-prerequisites/vs-workloads.jpg diff --git a/docs/core/windows-prerequisites.md b/docs/core/windows-prerequisites.md index d5fa44d13b29d..3b71f9188975d 100644 --- a/docs/core/windows-prerequisites.md +++ b/docs/core/windows-prerequisites.md @@ -1,18 +1,18 @@ --- title: Prerequisites for .NET Core on Windows description: Learn what dependencies you need on your Windows machine to develop and run .NET Core applications. -author: mairaw -ms.author: mairaw -ms.date: 12/03/2018 +ms.date: 12/05/2018 --- # Prerequisites for .NET Core on Windows -This article shows the dependencies needed to develop .NET Core applications on Windows. The supported OS versions and dependencies that follow apply to the three ways of developing .NET Core apps on Windows: +This article shows the supported OS versions in order to run .NET Core applications on Windows. The supported OS versions and dependencies that follow apply to the three ways of developing .NET Core apps on Windows: * [Command line](tutorials/using-with-xplat-cli.md) -* [Visual Studio 2017](https://aka.ms/vsdownload?utm_source=mscom&utm_campaign=msdocs) +* [Visual Studio](https://www.visualstudio.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) * [Visual Studio Code](https://code.visualstudio.com/) +Also, if you're developing on Windows using Visual Studio 2017, the [Prerequisites with Visual Studio 2017](#prerequisites-with-visual-studio-2017) section goes in more detail about minimum versions supported for .NET Core development. + ## .NET Core supported Windows versions .NET Core is supported on the following versions of: @@ -29,10 +29,12 @@ This article shows the dependencies needed to develop .NET Core applications on The following articles have a complete list of .NET Core supported operating systems per version: -* [.NET Core 2.1 - Supported OS Versions](https://github.com/dotnet/core/blob/master/release-notes/2.1/2.1-supported-os.md) -* [.NET Core 1.x - Supported OS Versions](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0-supported-os.md) +* [.NET Core 2.2](https://github.com/dotnet/core/blob/master/release-notes/2.2/2.2-supported-os.md) +* [.NET Core 2.1](https://github.com/dotnet/core/blob/master/release-notes/2.1/2.1-supported-os.md) +* [.NET Core 1.1](https://github.com/dotnet/core/blob/master/release-notes/1.1/1.1-supported-os.md) +* [.NET Core 1.0](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0-supported-os.md) -For download links and more information, see [.NET Core 2.2 downloads](https://www.microsoft.com/net/download/dotnet-core/2.2), [.NET Core 2.1 downloads](https://www.microsoft.com/net/download/dotnet-core/2.1), [.NET Core 1.1 downloads](https://www.microsoft.com/net/download/dotnet-core/1.1), or [.NET Core 1.0 downloads](https://www.microsoft.com/net/download/dotnet-core/1.0). +For download links and more information, see [.NET downloads](https://www.microsoft.com/net/download) to download the latest version or [.NET downloads archive](https://dotnet.microsoft.com/download/archives#dotnet-core) for older versions. ## .NET Core dependencies @@ -60,35 +62,39 @@ You can use any editor to develop .NET Core applications using the .NET Core SDK You can read more about the changes in Visual Studio 2017 in the [release notes](/visualstudio/releasenotes/vs2017-relnotes). -# [.NET Core 2.1](#tab/netcore21) +# [.NET Core 2.x](#tab/netcore2x) + +To develop .NET Core apps in Visual Studio 2017 using the .NET Core 2.2 SDK: -To develop .NET Core 2.1 apps in Visual Studio 2017: + 1. [Download and install Visual Studio 2017 version 15.9.0 or higher](/visualstudio/install/install-visual-studio) with the **.NET Core cross-platform development** workload (in the **Other Toolsets** section) selected. - 1. [Download and install Visual Studio 2017 version 15.7.0 or higher](/visualstudio/install/install-visual-studio) with the **.NET Core cross-platform development** workload (in the **Other Toolsets** section) selected. +![Screenshot of Visual Studio 2017 installation with the ".NET Core cross-platform development" workload selected](./media/windows-prerequisites/vs-2017-workloads.jpg) -![Screenshot of Visual Studio 2017 installation with the ".NET Core cross-platform development" workload selected](./media/windows-prerequisites/vs-15-8-workloads.jpg) +After the **.NET Core cross-platform development** toolset is installed, Visual Studio usually installs a previous version of the .NET Core SDK. +For example, Visual Studio 2017 15.9 uses .NET Core 2.1 SDK by default after the workload is installed. -After the **.NET Core cross-platform development** toolset is installed, by default, Visual Studio 2017 15.7 uses .NET Core 2.0 SDK and Visual Studio 2017 15.8 uses 2.1 SDK. +To update Visual Studio to use .NET Core 2.2 SDK: - 2. If you're using Visual Studio 2017 15.7, install the [.NET Core 2.1 SDK](https://www.microsoft.com/net/download/core) or upgrade to Visual Studio 2017 15.8. + 1. Install the [.NET Core 2.2 SDK](https://dotnet.microsoft.com/download). - 3. Retarget existing or new .NET Core projects to .NET Core 2.1 using the following instructions: - * On the **Project** menu, Choose **Properties**. - * In the **Target framework** selection menu, set the value to **.NET Core 2.1**. + 1. If you want your project to use the latest .NET Core runtime, retarget existing or new .NET Core projects to .NET Core 2.2 using the following instructions: -![Screenshot of Visual Studio 2017 Application Project Property with the ".NET Core 2.0" Target framework menu item selected](./media/windows-prerequisites/Targeting-dotnetCore2.png) + * On the **Project** menu, choose **Properties**. + * In the **Target framework** selection menu, set the value to **.NET Core 2.2**. -Once you have Visual Studio configured with .NET Core 2.1 SDK, you can do the following actions: +![Screenshot of Visual Studio 2017 Application Project Property with the ".NET Core 2.2" target framework menu item selected](./media/windows-prerequisites/targeting-dotnet-core.jpg) + +Once you have Visual Studio configured with .NET Core 2.2 SDK, you can do the following actions: * Open, build, and run existing .NET Core 1.x and 2.x projects. -* Retarget .NET Core 1.x and 2.0 projects to .NET Core 2.1, build, and run. -* Create new .NET Core 2.1 projects. +* Retarget .NET Core 1.x and 2.x projects to .NET Core 2.2, build, and run. +* Create new .NET Core 2.2 projects. # [.NET Core 1.x](#tab/netcore1x) To develop .NET Core 1.x apps in Visual Studio, [download and install Visual Studio 2017](/visualstudio/install/install-visual-studio) with the **".NET Core cross-platform development"** workload (in the **Other Toolsets** section) selected. -![Screenshot of Visual Studio 2017 installation with the ".NET Core cross-platform development" workload selected](./media/windows-prerequisites/vs_workloads.jpg) +![Screenshot of Visual Studio 2017 installation with the ".NET Core cross-platform development" workload selected](./media/windows-prerequisites/vs-workloads.jpg) > [!IMPORTANT] > It's possible to use Visual Studio 2015 for .NET Core 1.x development, but it's not recommended for the following reasons: @@ -96,15 +102,17 @@ To develop .NET Core 1.x apps in Visual Studio, [download and install Visual Stu > * The projects are project.json-based, which is deprecated. > > For more information about the project format changes, see [High-level overview of changes](./tools/cli-msbuild-architecture.md). + --- > [!TIP] -> To verify your Visual Studio 2017 version: +> To verify your Visual Studio version: > > * On the **Help** menu, choose **About Microsoft Visual Studio**. > * In the **About Microsoft Visual Studio** dialog, verify the version number. -> * For .NET Core 2.2 Preview 1 apps, Visual Studio 2017 version 15.9 (currently in Preview) or higher. +> * For .NET Core 3.0 Preview 1 apps, Visual Studio 2019 Preview 1 or higher. +> * For .NET Core 2.2 apps, Visual Studio 2017 version 15.9 or higher. > * For .NET Core 2.1 apps, Visual Studio 2017 version 15.7 or higher. > * For .NET Core 1.x apps, Visual Studio 2017 version 15.0 or higher.