Skip to content

Update windows prereqs for 2.2 #9419

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Dec 6, 2018
Merged

Update windows prereqs for 2.2 #9419

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
27556e0
update windows prereqs
mairaw Dec 5, 2018
b95aa11
Merge branch 'master' into win-prereq-2.2
mairaw Dec 5, 2018
990c50b
remove 2017 from the sentence
mairaw Dec 5, 2018
53ccde2
feedback
mairaw Dec 5, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file removed docs/core/media/windows-prerequisites/Targeting-dotnetCore2.png
View file
Open in desktop
Binary file not shown.
Binary file added docs/core/media/windows-prerequisites/targeting-dotnet-core.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/core/media/windows-prerequisites/vs-15-3-workloads.jpg
View file
Open in desktop
Binary file not shown.
Binary file removed docs/core/media/windows-prerequisites/vs-15-8-workloads.jpg
View file
Open in desktop
Binary file not shown.
Binary file added docs/core/media/windows-prerequisites/vs-2017-workloads.jpg
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
0 ...ia/windows-prerequisites/vs_workloads.jpg → ...ia/windows-prerequisites/vs-workloads.jpg
View file
Open in desktop
File renamed without changes
56 changes: 32 additions & 24 deletions docs/core/windows-prerequisites.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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:
Expand All @@ -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.
Copy link
Contributor

@pkulikov pkulikov Dec 5, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mairaw This paragraph tells the similar story as the next one. Is it intentional or a merge result?

Copy link
Contributor Author

@mairaw mairaw Dec 5, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nope. Good catch @pkulikov. I tried to simplify the paragraph, not duplicate it. 😄


## .NET Core dependencies

Expand Down Expand Up @@ -60,51 +62,57 @@ 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:
> * The .NET Core tooling is a preview version, which is not supported.
> * 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).

---

<a name="vs-mapping"></a>

> [!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.