【实验手册】使用Visual Studio Code 开发.NET Core应用程序

开源和跨平台开发是Microsoft 的当前和未来相当重要的策略。.NET Core已开源，同时开发了其余项来使用和支持新的跨平台策略。.NET Core 2.0 目前已经正式发布，是适用于针对 Web 和云构建跨平台应用程序的最新开源技术，可在 Linux、Mac OS X 和 Windows 上运行。

.NET Core使用各类命令行工具来生成基架、构建和运行应用程序，同时可使用 Visual Studio Code 进行编辑。

Visual Studio Code 是微软为广大开发人员提供的免费开源的跨平台代码编辑器，和其它流行的代码编辑器，如：Sublime, Atom同样，它很是小，运行速度快，同时经过各类插件支持不一样开发语言的编写。不一样的地方在于，VSC的插件不只仅提供静态的语言高亮，自动语法检测和完成功能外；还提供更加高级的编译器服务支持，这使得VSC能够在必定程度上替代IDE的功能，进行代码的编译，调试和发布操做。

本实验将介绍如何开发.NET Core跨平台应用程序，以及如何在 Linux、OS X 和 Windows 上的 Visual Studio Code (code.visualstudio.com) 中编写代码。

先决条件

1. 为了完成这个实验，你须要一个Windows 10虚拟机

2. 你须要在虚拟机上手动安装.NET Core和Visual Studio Code，你能够按照练习1 的任务1来搭建实验环境

3. 你须要下载和安装Visual Studio Code的C#扩展，你能够按照练习1的任务2来完成

练习1：安装和配置.NET Core以及Visual Studio Code 扩展

在本练习中，您将了解安装和配置 Visual Studio Code 和.NET Core扩展出于演示目的所需的安装和配置要点

任务1：安装Visual Studio Code和.NET Core

1. 下载Visual Studio Code ，从https://code.visualstudio.com/ 下载最新版本并安装

2. 从 https://www.microsoft.com/net/core 下载.NET Core 2.0进行安装

3. Node.JS和NPM，以及 bower, gulp 和 grunt 等前端工具, Node.js是一个javascript的运行引擎，提供服务端的javascript运行能力，同时也包含了npm这个包管理器，能够用来安装 bower, glup，grunt等前端工具。下载地址：http://nodejs.org

安装完成后，让经过如下命令安装前端工具

npm install bower gulp grunt-cli -g

任务2：安装插件

安装好Visual Studio Code 以后，须要安装下面插件

1. C# 扩展http://www.omnisharp.net/

2. 安装vscode-nuget-package-manager

您能够在Visual Studio Code中界面安装这些扩展（选择菜单查看-扩展）, 也可使用 Ctrl + P, 而后输入 ext install vscode-nuget-package-manager或 ext install csharp。一旦您安装了 NuGet 项目管理器, 您还将使用它来安装 NuGet 包。

练习2：使用命令行界面构建. NET Core应用程序

.NET Core CLI 是开发 .NET Core 应用程序的一个新的跨平台工具链的基础。它是“基础”的缘由时它是在其它的、高级别工具的主要层，如集成开发环境（IDEs），由编辑器和构建者组成。

默认它是跨平台的，而且对支持的每一个平台有相同的表现范围。这意味着，当你学会如何使用工具，你能够从任何支持的平台上以一样的方式使用它。

本练习中如今咱们假设你已经安装好了VS Code开发工具、.Net Core 2.0 SDK dotnet-sdk-2.0.0（注意本身的操做系统），而且已经为VS Code安装好了C#扩展。

1、咱们先在咱们的电脑硬盘的新建一个文件夹。我把这个地方选在D:\WorkTest下，建立的文件夹名称为HelloWorld。注意，这一步不是在VS Code中完成的，VS Code中不能建立文件夹。

2、在VS Code开发环境中，选择文件->打开文件夹，而后选择咱们刚刚建立文件夹HelloWorld打开

3、选择查看->集成终端命令或直接摁下快捷键Ctrl+`，VS Code开发环境中会出现一个集成的终端。好比我接下来在集成终端中输入命令dotnet new sln -n HelloWorld，在咱们的HelloWorld文件夹下会出现一个解决方案HelloWorld.sln

4、接下来，咱们再在集成终端中输入dotnet new mvc -n HelloWorld.Web，通过VS Code一阵的挣扎和折腾，咱们会发现左边的文件列表中多了一个叫HelloWorld.Web的MVC项目。以下图：

5、按下F5，选择.NET Core, 出来一个launch.json，以下图：

6、在集成终端中输入命令dotnet build HelloWorld.Web命令，回车，完过后成成了一个东西在Debug下边。好了，咱们把这段生成的东西放在launch.json的.NET Core Launch (web)配置项的program中，而后顺便改一下下边那个cwd。完过后看起来效果是下边这样子的：

7、点击左边的那个小虫子，VS Code中的左侧会出现上图中的状况，选择.NET Core Launch (web)，再次摁下F5，点击“配置任务运行程序”，自动生成了下边这个配置json文件：

8、咱们如今配置一下这个新生成的task.json吧。也就是在tasks配置项中添加以下内容，指定一下任务在build时的直接命令对象。${workspaceRoot}的意思就是你项目的根目录，别写成绝对路径，否则回头你项目发布后找不到

9、再次按下F5，一个.Net Core MVC网站出如今咱们眼前

有可能会出现下面的错误：

这是因为默认启动的是 .NET Core Launch (console)，点击调试（左边小虫子图标），选择.NET Core Launch (web)

10、下面咱们演示给项目添加一个Nuget包

利用咱们前面安装的VS code 的Nuget 包扩展插件，咱们选中HelloWorld.Web 项目，使用UI菜单查看- 命令面板：

选择NuGet Package Manager:Add Package, 回车，输入NodaTime , 选择版本后提示添加成功，打开HelloWorld.Web.csproj 文件能够看到NodaTime已经添加到工程中

打开 HomeController 文件，加入下述代码：

在Views\Home\Index.cshtml 加入下面代码

练习3：使用 Visual Studio Code和 Omnisharp 调试 c# 代码

上面的练习咱们已经看到项目下有个.vscode 文件夹。里面有2个文件tasks.json 和launch.json.

tasks.json 用于dotnet 构建任务的配置数据，当你按下F5 启动调试时VS Code 能够生成项目

{

// See https://go.microsoft.com/fwlink/?LinkId=733558

// for the documentation about the tasks.json format

"version": "2.0.0",

"tasks": [

{

"taskName": "build",

"command": "dotnet build",

"type": "shell",

"group": "build",

"presentation": {

"reveal": "silent"

"problemMatcher": "$msCompile",

"options": {

"cwd": "${workspaceRoot}/HelloWorld.Web"

}

]

}

launch.json包含调试模式的配置数据，默认是从vs code启动或者附加进程。

launch.json中有不少属性能够设置, 经过智能提示查看有那些属性能够设置, 若是要查看属性的具体含义, 能够把鼠标悬停在属性上面, 会属性的使用说明.

任务1：从VS code启动调试器

对于控制台和Web项目是很是简单的，只需在代码中设置断点，导航到调试窗口（ctrl + shift + d）并点击调试按钮 - “.Net Core Launch”选项应该默认选择。您的应用程序如今应该中止在您的断点。

任务2：附加到进程/网站

使用VsCode将调试器附加到正在运行的进程也很是简单，设置断点，从调试菜单中选择“.Net Core Attach”选项，而后进行调试。任务栏应显示您能够选择附加调试器的正在运行的进程的列表 - 在本示例中，咱们将附加到正在运行的dotnet网站进程。

练习4：使用Visual Studio Code 开发ASP.NET Core 应用程序

本练习要使用Visual studio code完成一个包含多个项目的解决方案，包括类库和Web项目。结合Visual Studio Code和.NET Core CLI，建立项目结构以下：

piedpiper

└── src

├── piedpiper.domain

├── piedpiper.sln

├── piedpiper.tests

└── piedpiper.website

任务1：建立解决方案

首先，咱们将建立咱们的解决方案（.sln）文件，我一直都喜欢在顶级源文件夹中建立解决方案文件D:\WorkTest\piedpiper, 打开Visual Studio Code的集成终端，

PS D:\WorkTest\piedpiper> cd src

PS D:\WorkTest\piedpiper\src> dotnet new sln -n piedpiper

这将建立一个sln名为的新文件piedpiper.sln。

接下来，咱们使用dotnet new <projecttype>命令中的output参数在特定文件夹中建立一个项目：

PS D:\WorkTest\piedpiper\src> dotnet new mvc -o piedpiper.website

已成功建立模板“ASP.NET Core Web App (Model-View-Controller)”。

这将在同一目录中的piedpiper.website文件夹中建立一个ASP.NET Core MVC应用程序。若是咱们目前看到咱们的文件夹结构，它看起来像这样：

接下来咱们能够为咱们的域名和测试项目作一样的事情：

PS D:\WorkTest\piedpiper\src> dotnet new classlib -o piedpiper.domain

PS D:\WorkTest\piedpiper\src> dotnet new xunit -o piedpiper.tests

任务2：将项目添加到咱们的解决方案中

在这一点上，咱们有一个没有引用项目的解决方案文件，咱们能够经过调用list命令来验证这一点：

PS D:\WorkTest\piedpiper\src> dotnet sln list

未在解决方案中找到项目。

接下来咱们将咱们的项目添加到咱们的解决方案文件，咱们很容易在Visual Studio 2017中打开解决方案，而后手动添加对每一个项目的引用。Visual Studio Code也能够经过.NET Core CLI完成。

如今开始使用如下命令添加每一个项目，咱们经过引用.csproj文件来执行此操做：

PS D:\WorkTest\piedpiper\src> dotnet sln add piedpiper.website/piedpiper.website.csproj

PS D:\WorkTest\piedpiper\src> dotnet sln add piedpiper.domain/piedpiper.domain.csproj

PS D:\WorkTest\piedpiper\src> dotnet sln add piedpiper.tests/piedpiper.tests.csproj

注意：若是您使用的是基于Linux / Unix的shell，您可使用globbing模式在单个命令中执行此操做！

dotnet sln add **/*.csproj

如今，当咱们调用list咱们的解决方案文件时，咱们应该获得如下输出：

S D:\WorkTest\piedpiper\src> dotnet sln list

项目引用

----

piedpiper.website\piedpiper.website.csproj

piedpiper.domain\piedpiper.domain.csproj

piedpiper.tests\piedpiper.tests.csproj

任务3：向项目添加项目引用

接下来，咱们要开始向咱们的项目添加项目引用，经过dotnet add reference命令将咱们的域库连接到咱们的网站和单元测试库：

PS D:\WorkTest\piedpiper\src> dotnet add piedpiper.tests reference piedpiper.domain/piedpiper.domain.csproj

已将引用“..\piedpiper.domain\piedpiper.domain.csproj”添加到项目。

如今，若是要查看测试项目的内容，咱们将看到咱们的domain 已被引用：

PS D:\WorkTest\piedpiper\src> cd .\piedpiper.tests\

PS D:\WorkTest\piedpiper\src\piedpiper.tests> cat .\piedpiper.tests.csproj

<TargetFramework>netcoreapp2.0</TargetFramework>

<IsPackable>false</IsPackable>

</PropertyGroup>

</ItemGroup>

</ItemGroup>

</Project>

接下来，咱们将为咱们的网站项目作一样的事情，因此让咱们去咱们的网站文件夹并运行相同的命令：

dotnet add piedpiper.website reference piedpiper.domain/piedpiper.domain.csproj

若是咱们返回到咱们的根源文件夹并运行build命令，咱们应该看到全部的构建成功：

PS D:\WorkTest\piedpiper\src> dotnet build

用于 .NET Core 的 Microsoft (R) 生成引擎版本 15.3.409.57025

版权全部(C) Microsoft Corporation。保留全部权利。

piedpiper.domain -> D:\WorkTest\piedpiper\src\piedpiper.domain\bin\Debug\netstandard2.0\piedpiper.domain.dll

piedpiper.tests -> D:\WorkTest\piedpiper\src\piedpiper.tests\bin\Debug\netcoreapp2.0\piedpiper.tests.dll

piedpiper.website -> D:\WorkTest\piedpiper\src\piedpiper.website\bin\Debug\netcoreapp2.0\piedpiper.website.dll

已成功生成。

0 个警告

0 个错误

任务4：将NuGet包添加到项目或更新它

假设咱们要将NuGet包添加到咱们的一个项目中，咱们可使用该add package命令来执行此操做。

首先导航到要添加NuGet软件包的项目：

PS D:\WorkTest\piedpiper\src> cd .\piedpiper.tests\

PS D:\WorkTest\piedpiper\src\piedpiper.tests> dotnet add package shouldly

Writing C:\Users\dell\AppData\Local\Temp\tmp68E4.tmp

info : Adding PackageReference for package 'shouldly' into project 'D:\WorkTest\piedpiper\src\piedpiper.tests\piedpiper.tests.csproj'.

log : Restoring packages for D:\WorkTest\piedpiper\src\piedpiper.tests\piedpiper.tests.csproj...

info : GET https://api.nuget.org/v3-flatcontainer/shouldly/index.json

info : OK https://api.nuget.org/v3-flatcontainer/shouldly/index.json 512ms

info : GET https://api.nuget.org/v3-flatcontainer/shouldly/2.8.3/shouldly.2.8.3.nupkg

info : OK https://api.nuget.org/v3-flatcontainer/shouldly/2.8.3/shouldly.2.8.3.nupkg 84ms

log : Installing Shouldly 2.8.3.

info : Package 'shouldly' is compatible with all the specified frameworks in project 'D:\WorkTest\piedpiper\src\piedpiper.tests\piedpiper.tests.csproj'.

info : PackageReference for package 'shouldly' version '2.8.3' added to file 'D:\WorkTest\piedpiper\src\piedpiper.tests\piedpiper.tests.csproj'.

或者，咱们可使用版本参数指定要安装的版本：

dotnet add package shouldly -v 2.8.3

更新NuGet包

将NuGet软件包更新到最新版本也是同样简单，只需使用相同的命令而不使用版本参数：

dotnet add package shouldly

你也能够下载word 文档 http://url.cn/5e3NT3G