Skip to content
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

additional updates to prerequisites topic #1391

Merged
merged 3 commits into from
Jan 6, 2017
Merged

additional updates to prerequisites topic #1391

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
11074b2
additional updates to prerequisites topic
mairaw Jan 4, 2017
cb6e417
Merge branch 'master' into prereq
mairaw Jan 5, 2017
f4e051e
fixing OPS warning
mairaw Jan 5, 2017
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
59 changes: 4 additions & 55 deletions docs/core/preview3/windows-prerequisites.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,59 +1,8 @@
---
title: .NET Core Prerequisites (Preview 3 Tooling)
description: .NET Core Prerequisites (Preview 3 Tooling)
keywords: .NET, .NET Core
author: billwagner
ms.author: wiwagn
ms.date: 09/15/2016
ms.topic: article
ms.prod: .net-core
ms.devlang: dotnet
ms.assetid: c33b1241-ab66-4583-9eba-52cf51146f5a
redirect_url: /dotnet/articles/core/windows-prerequisites
---

# Prerequisites for Windows development (Preview 3 Tooling)
# Prerequisites for .NET Core on Windows (Preview 3)

.NET Core development on Windows with Visual Studio requires:

* A supported version of the Windows client or operating system.
* Visual Studio 2017 RC or later
* .NET Core Tooling Preview 3

## Supported Windows versions

.NET Core is supported by the following versions of Windows:

* Windows 7 SP1
* Windows 8.1
* Windows 10
* Windows Server 2008 R2 SP1 (Full Server or Server Core)
* Windows Server 2012 SP1 (Full Server or Server Core)
* Windows Server 2012 R2 SP1 (Full Server or Server Core)
* Windows Server 2016 (Full Server, Server Core or Nano Server)

You can see the full set of [supported operating systems](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0.md#rtm-platform-support) in the [.NET Core Release Notes](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0.md).

## .NET Core dependencies

.NET Core requires the VC++ Redistributable when running on Windows. It is installed for you by the .NET Core installer. You need to install the Visual C++ redistributable manually if you are installing .NET Core via the installer script (`dotnet-install.ps1`).

The Visual C++ Redistributable version differs by Windows version.

* Windows 10
* [Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145)
* Windows 7+ (not Windows 10)
* Please make sure that your Windows installation is up-to-date and includes hotfix [KB2533623](https://support.microsoft.com/en-us/kb/2533623) installed through Windows Update.
* [Universal CRT update](https://www.microsoft.com/en-us/download/details.aspx?id=48234) (you can get more info on what Universal CRT is in [this blog post](https://blogs.msdn.microsoft.com/vcblog/2015/03/03/introducing-the-universal-crt/))

## Visual Studio

You may develop .NET Core apps with any editor using the .NET Core command-line tools, but if you want to use Visual Studio and the Preview 3 of the .NET Core tooling, you need Visual Studio 2017 RC or later. You can download [Visual Studio Community 2017 RC](https://www.visualstudio.com/vs/visual-studio-2017-rc/) for free.

Verify that you're running Visual Studio 2017 RC:

* On the **Help** menu, choose **About Microsoft Visual Studio**.
* In the **About Microsoft Visual Studio** dialog, the version number should be 15.0.25831.1 or higher.

You can read more about the changes in Visual Studio 2017 RC in the [release notes](https://www.visualstudio.com/en-us/news/releasenotes/vs2017-relnotes).

Make sure you installed the ".NET Core and Docker (Preview)" workload during setup. If you didn't, it's possible to run the setup again and select it.
## Content moved!
This content has merged and moved to the [Prerequisites for .NET Core on Windows](../windows-prerequisites.md) topic.
88 changes: 54 additions & 34 deletions docs/core/windows-prerequisites.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: .NET Core Prerequisites
description: .NET Core Prerequisites
keywords: .NET, .NET Core
author: billwagner
ms.author: wiwagn
ms.date: 09/15/2016
title: Prerequisites for .NET Core on Windows | Microsoft Docs
description: Learn what dependencies you need on your Windows machine to develop and run .NET Core applications.
keywords: .NET Core, Windows, prerequisites, dependencies, Visual Studio
author: mairaw
ms.author: mairaw
ms.date: 01/05/2017
ms.topic: article
ms.prod: .net-core
ms.devlang: dotnet
Expand All @@ -13,16 +13,11 @@ ms.assetid: c33b1241-ab66-4583-9eba-52cf51146f5a

# Prerequisites for .NET Core on Windows

.NET Core development on Windows with Visual Studio requires:

* A supported version of the Windows client or operating system.
* Visual Studio 2015 Update 3.3 or later
* NuGet Manager extension for Visual Studio
* .NET Core Tooling Preview 2
This articles shows you what dependencies you need to deploy and run .NET Core applications on Windows machines and develop using Visual Studio.

## Supported Windows versions

.NET Core is supported by the following versions of Windows:
.NET Core is supported on the following versions of Windows:

* Windows 7 SP1
* Windows 8.1
Expand All @@ -32,41 +27,66 @@ ms.assetid: c33b1241-ab66-4583-9eba-52cf51146f5a
* Windows Server 2012 R2 SP1 (Full Server or Server Core)
* Windows Server 2016 (Full Server, Server Core or Nano Server)

You can see the full set of [supported operating systems](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0.md#rtm-platform-support) in the [.NET Core Release Notes](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0.md).
You can see the full set of [supported operating systems](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0.md#rtm-platform-support) in the [.NET Core 1.0.0 Release Notes](https://github.com/dotnet/core/blob/master/release-notes/1.0/1.0.0.md).

## .NET Core dependencies

.NET Core requires the VC++ Redistributable when running on Windows. It is installed for you by the .NET Core installer. You need to install the Visual C++ redistributable manually if you are installing .NET Core via the installer script (`dotnet-install.ps1`) or are attempting to run a self-contained .NET Core application.
.NET Core requires the Visual C++ Redistributable when running on Windows versions earlier than Windows 10 and Windows Server 2016. This dependency is automatically installed for you if you use the .NET Core installer. However, you need to manually install the [Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145) if you are installing .NET Core via the [installer script](https://docs.microsoft.com/en-us/dotnet/articles/core/tools/dotnet-install-script) or deploying a self-contained .NET Core application.

[Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145)
> [!NOTE]
> <em>For Windows 7 and Windows Server 2008 machines only:</em><br>
> Make sure that your Windows installation is up-to-date and includes hotfix [KB2533623](https://support.microsoft.com/en-us/kb/2533623) installed through Windows Update.

* Windows 7 and 2008 only
* Please make sure that your Windows installation is up-to-date and includes hotfix [KB2533623](https://support.microsoft.com/en-us/kb/2533623) installed through Windows Update.

## Visual Studio
## Prerequisites with Visual Studio

You need Visual Studio 2015 to develop .NET Core apps. You can download [Visual Studio Community 2015](https://www.visualstudio.com/downloads/download-visual-studio-vs) for free.
You can use any editor of your choice to develop .NET Core applications using the .NET Core SDK. However, if you want to develop .NET Core applications on Windows using Visual Studio, there are two versions you can use:

Verify that you're running [Visual Studio 2015 Update 3.3](https://msdn.microsoft.com/library/mt752379.aspx):
* [Visual Studio 2015](#visual-studio-2015)
* [Visual Studio 2017 RC](#visual-studio-2017-rc)

* On the **Help** menu, choose **About Microsoft Visual Studio**.
* In the **About Microsoft Visual Studio** dialog, the version number should be 14.0.25424.00 or higher, and include "Update 3".
* If you don't have Update 3, you first need to download and install [Visual Studio 2015 Update 3](https://www.visualstudio.com/news/releasenotes/vs2015-update3-vs).
* If you have Update 3 but the version number is smaller than 14.0.25424.00, you need to download and install [Visual Studio 2015 Update 3.3](https://msdn.microsoft.com/library/mt752379.aspx).
Projects created with Visual Studio 2015 will be project.json-based by default while projects created with Visual Studio 2017 RC will always be MSBuild-based. For more information about the format changes, see [High-level overview of changes](./preview3/tools/layering.md).

You can read more about the changes in Update 3 in the [release notes](https://www.visualstudio.com/news/releasenotes/vs2015-update3-vs).
### Visual Studio 2015

## NuGet Manager extension for Visual Studio
If you want to use Visual Studio 2015 to develop .NET Core apps, you'll need:

NuGet is the package manager for the Microsoft development platform including .NET Core. You need [NuGet 3.5.0](https://dist.nuget.org/visualstudio-2015-vsix/v3.5.0-beta/NuGet.Tools.vsix) or higher to build .NET Core apps.
* Visual Studio 2015 Update 3.3 or later.

## .NET Core tools for Visual Studio 2015
There are different [editions](https://www.visualstudio.com/vs/compare) of Visual Studio 2015. You can download [Visual Studio Community 2015](https://www.visualstudio.com/downloads/) for free to get started.

Download and install the [.NET Core 1.0.1 - VS 2015 Tooling Preview 2][sdk].
To verify that you're running [Visual Studio 2015 Update 3.3](https://msdn.microsoft.com/library/mt752379.aspx), do the following:

The .NET Core Tooling package installs .NET Core, project templates and other tools for Visual Studio 2015.
* On the **Help** menu, choose **About Microsoft Visual Studio**.
* In the **About Microsoft Visual Studio** dialog, the version number should be 14.0.25424.00 or higher, and include "Update 3".
* If you don't have Update 3, you first need to download and install [Visual Studio 2015 Update 3](https://www.visualstudio.com/news/releasenotes/vs2015-update3-vs).
* If you have Update 3 but the version number is smaller than 14.0.25424.00, you need to download and install [Visual Studio 2015 Update 3.3](https://msdn.microsoft.com/library/mt752379.aspx).

> [!NOTE]
Currently, you cannot download an offline installer for [.NET Core 1.0.1 - VS 2015 Tooling Preview 2][sdk]. Instead, you have to download the [regular bootstrapper][sdk] and run it with a command-line option (such as, `/layout c:\path`) to get an offline layout. After that, it can be used as an offline installer: just run the executable from the local path. Notice that because it's a full layout, this procedure downloads all the packages for all supported languages, which is around 1 GB in size.
You can read more about the changes in Update 3 in the [release notes](https://www.visualstudio.com/news/releasenotes/vs2015-update3-vs).

* NuGet Manager extension for Visual Studio

NuGet is the package manager for the Microsoft development platform including .NET Core. You need [NuGet 3.5.0-beta](https://dist.nuget.org/visualstudio-2015-vsix/v3.5.0-beta/NuGet.Tools.vsix) or higher to build .NET Core apps.

* .NET Core Tooling Preview 2

Download and install the [.NET Core 1.0.1 - VS 2015 Tooling Preview 2][sdk].

The .NET Core Tooling package installs .NET Core, project templates and other tools for Visual Studio 2015.

> [!NOTE]
> Currently, you cannot download an offline installer for [.NET Core 1.0.1 - VS 2015 Tooling Preview 2][sdk]. Instead, you have to download the [regular bootstrapper][sdk] and run it with a command-line option (such as, `/layout c:\path`) to get an offline layout. After that, it can be used as an offline installer: just run the executable from the local path. Notice that because it's a full layout, this procedure downloads all the packages for all supported languages, which is around 1 GB in size.

### Visual Studio 2017 RC

If you want to use Visual Studio 2017 RC to develop .NET Core apps, you'll need to have the latest version of Visual Studio RC installed with the ".NET Core and Docker (Preview)" workload selected.

There are different editions of Visual Studio 2017 RC. You can download [Visual Studio Community 2017 RC](https://www.visualstudio.com/vs/visual-studio-2017-rc/#downloadvs) for free to get started. To learn more about the Visual Studio installation process, see [Install Visual Studio 2017 RC](https://docs.microsoft.com/en-us/visualstudio/install/install-visual-studio).

To verify that you're running the latest version of Visual Studio 2017 RC, do the following:

* On the **Help** menu, choose **About Microsoft Visual Studio**.
* In the **About Microsoft Visual Studio** dialog, the version number should be 15.0.26020.0 or higher.

You can read more about the changes in Visual Studio 2017 RC in the [release notes](https://www.visualstudio.com/en-us/news/releasenotes/vs2017-relnotes).

[sdk]: https://go.microsoft.com/fwlink/?LinkID=827546
7 changes: 4 additions & 3 deletions docs/csharp/getting-started/with-visual-studio-code.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Getting started with Visual Studio Code | C# Guide
description: Learn how to create and debug your first .NET Core application in C# using VS Code.
keywords: C#, Getting Started, Acquisition, Install, Visual Studio Code, Cross Platform
author: kendrahavens
ms.author: wiwagn
ms.author: mairaw
ms.date: 01/03/2017
ms.topic: article
ms.prod: .net
Expand Down Expand Up @@ -89,8 +89,9 @@ You can also watch a short video tutorial for further setup help on [Windows](ht

7. Hit the green arrow at the top to continue debugging or press the red square to stop.

> [!TIP] For more information and troubleshooting tips on .NET Core debugging with OmniSharp in VS Code, see [Instructions for setting up the .NET Core debugger](https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger.md).
> [!TIP]
> For more information and troubleshooting tips on .NET Core debugging with OmniSharp in VS Code, see [Instructions for setting up the .NET Core debugger](https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger.md).

## See also
- [Setting up Visual Studio Code](https://code.visualstudio.com/docs/setup/setup-overview)
- [Debugging in Visual Studio Code](https://code.visualstudio.com/Docs/editor/debugging)
- [Debugging in Visual Studio Code](https://code.visualstudio.com/Docs/editor/debugging)