在Visual Studio 2017中使用Asp.Net Core构建Angular4应用程序

随着Web技术的快速发展，新的技术层出不穷，这使得Web程序的用户体验不断提升。最具代表性的就是SPA(Single Page Application)应用。

技术的快速发展也有弊端，那就是学习成本的不断提升。作为一名开发人员，你需要不断学习、提升自己的技术以适应这个技术快速发展的时代，以让自己不在这个技术快速发展的洪流中所淘汰。

当然，我们的老大Microsoft也是如此，借着Asp.Net Core的机会，发布了好几款集成目前流行的前端框架的Asp.Net Core的模板。文章后边我就具体描述以一下。

你需要知道的东西

你需要明白的东西

4. Asp.Net Core，这是微软推出的跨平台Web应用程序。功能强大。官方文档非常完善。

5. TypeScript，这是一种类型化的JavaScript，可以通过他编译生成Javascript，Angular就是基于TypeScript的。

6. RESTful API，这是一个很火热的Web应用程序API的设计理念。微软官网也写过一篇关于RESTful的文章，但实在太老了。于是用aisuhua的GitHub代替了

你需要了解的东西

1. 翻GFW，根据我国国情需要，GFW是“必须要有的”，这无可厚非。但是带来的问题就是开发人员的一手资料被屏蔽。所以你应该了解怎么翻GFW。

2. 国内NPM源，之后会细说。

3. WebPack，这是一个现代化的JavaScript模块打包器。具体内容可以去官网了解

也许有一些没有接触过以上提到的这些工具或知识的童鞋可能会一脸懵逼，但是不用担心也不用着急，本文会用最浅显易懂的方式告诉你如何配置。

微软SPA模板(不在本文讨论范围)

先说说老大Microsoft的模板。

想要安装微软官方提供的模板，我们就需要用到dotnet CLI工具了。这套模板是由微软Steve Sanderson提出并研发的。关于史蒂夫·桑德森，从2010年到现在，在微软从事Web技术工作。并且最先加入到Asp.Net MVC3的技术团队。构建了一系列JavaScript库以及Azure的门户网站。我们所熟知的Knockout.js就是这个人主导开发的。可以说是绝对的.Net技术大牛。

附上一张他的照片，还有他的Twitter。有玩Twitter的可以Follow他

回到正题，想要安装这个模板，你就需要使用DotNet CLI工具了。具体命令如下：

dotnet new --install Microsoft.AspNetCore.SpaTemplates::*

当你使用CMD或Powershell运行后会得到一下结果：

可以看到微软很给力，给我提供了好多模板。有Angular的，有Knockout的，有Aurelia的，有React的，有Vue的。可以说，非常全面。

可以使用如下DotNetCLI命令根据模板新建项目。

dotnet new angular

如果你了解dotnet CLI，你就会明白，这条命名的意义就是从当前目录使用MVC ASP.NET Core with Angular创建一个Asp.Net Core的项目。

新建成功后，使用如下命令还原.NET依赖包和Angular依赖包：

dotnet restore

npm install

完成之后你就可以运行程序，查看效果：

你不妨可以试试看，期间你可能需要一个高速VPN，否则你在执行npm install命令时，可能会有很多Angular的包安装不上。

有人会说，为啥我们不直接用微软的模板反而要自己去构建Asp.Net Core+Angular的应用程序呢。

其实原因很简单，微软一如既往的作风就是高度集成高度封装。他所提供的这些模板中，集成Server-side prerendering(服务端渲染)，WebPack dev middleware，Hot Module Replacement(模块热插拔)等等技术。最后再加上Angular。

如果你对这些技术了解程度不够，很难做到高度扩展。例如添加新的npm包也会有可能引起一些莫名其妙的异常。所以，我们才要自己去构建集成Angular的Asp.Net Core的应用程序。

有兴趣的童鞋可以自己去尝试一下。

让我们开始把

1.新建一个Asp.Net Core项目

打开宇宙最强IDE，Visual Studio 2017，新建一个Asp.Net Core项目。并且取个名字，比如AspNetCoreWithAngular4：

之后我们创建一个空的Asp.Net Core 程序，我是用的版本是1.1

2. 配置我们的Asp.Net Core

这一步，我们需要配置一些Core的依赖包，并且设置Core在VS重构时MSBuild不去编译Typescript文件，因为我们要使用其他工具去编译Typescript文件。

直接打开csproj文件：

添加如下代码：

代码：

<PackageReference Include="Microsoft.AspNetCore.Mvc" Version="1.1.3" />

<PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="1.1.2" />

在我们的项目中，Microsoft.AspNetCore.Mvc包能够允许我们添加控制器并且构建WebAPI，而Microsoft.AspNetCore.StaticFiles包可以让我们配置提供静态目录访问的功能。例如默认提供/wwwroot目录的访问。

因为我们会使用其他工具去编译Typescript文件，所以需要在PropertyGroup节点中配置

<TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>

保存csproj文件后，VS2017会自动下载相关包。如果你在MacOS或者Linux环境，请使用dotnet restore命令还原包。

3. 配置Startup.cs文件

首先在ConfigServives方法中添加MVC服务：

services.AddMvc();

如果VS出现红色波浪线，你需要关闭项目，重新打开项目即可。

之后，删除Configure方法中的所有代码，使用如下代码替换：

app.Use(async(context, next) =>{awaitnext();if(context.Response.StatusCode ==404&& !System.IO.Path.HasExtension(context.Request.Path.Value) && !context.Request.Path.Value.StartsWith("/api/")) { context.Request.Path="/index.html";awaitnext(); } }); app.UseMvcWithDefaultRoute(); app.UseDefaultFiles(); app.UseStaticFiles();

这里简单说一下，首先第一个app.Use中间件的作用是当系统返回404状态码并且访问的Request不包含文件扩展名并且访问Request不是以“/api/”开头的访问直接将其跳转到/index.html

app.UseMvcWithDefaultRoute()的意思是使用MVC的默认路由中间件。

app.UseDefaultFiles()的意思是启用默认文档提供器中间件，他会对只有主机的URL进行访问时搜索default.html、default.htm、index.html、index.htm文件，如果有就返回内容。

app.UseStaticFiles()的意思启用程序的静态文件支持，也就是启用wwwroot文件夹可以通过URL访问。

4. 创建一个APIController

在根目录中创建一个Controllers的文件夹，当然直接在根目录创建一个WebAPIController也可以。

这里简单说一下，VS2017 15.2(26430.14)这个版本有一个小bug，就是当你使用MVC脚手架功能的时候，比如上图的新建中的“控制器”，亦或者在Controller的Action中使用右键新建视图的功能时，中文会出现乱码。所以我推荐大家直接使用“新建项”，放弃使用脚手架功能。当然在目前的项目中涉及不到上述问题。

创建一个默认的ValuesController

让我们来修改一下ValuesController中Get方法的返回值：

publicIEnumerable<string>Get() {returnnewstring[] {"Hello Angular4","Hello Asp.Net Core 1.1"}; }

创建一个Angular4的应用程序

我们的Asp.Net Core服务器已经构建完成了。现在让我们来向项目中添加Angular

1. 在项目位置中打开CMD或PowerShell命令行工具

以PowerShell为例，输如如下命令，导航到项目所在目录：

PS C:\WINDOWS\system32> cd F:\Code\TFSProject\GitHub\AspNetCoreWithAngular4\AspNetCoreWithAngular4\AspNetCoreWithAngular 4

我的这个路径有点长，当人如果你觉得麻烦，可以安装一个小插件。他可以直接从项目根目录打开命令行工具。插件的名字是：

Open Command Line，你可以通过Visual Studio Marketplace下载安装。安装好之后，你就可以通过如下方式直接在根目录打开命令行工具了：

也许有人会问，为什么不用VS的PowerShell Interactive Window,我只想说我不喜欢他的界面。

2. 全局安装AngularCLI

如果你的机器上没有安装nodeJS，你需要去官网下载nodeJS进行安装，根据你的系统下载相应的安装包。node会有两个版本可供下载。一个是LTS版本，也就是通常我们所说的稳定版，另一种是Current版本，就是尝鲜版。有新的功能。当然我推荐安装稳定版。

安装成功之后，我们需要处理的下一个问题就是GFW的问题。众所周知，node的资源镜像是在GFW禁止访问的黑名单URL列表中。这就导致你可能在使用node的NPM包管理器安装AngularCLI的过程出现问题。不过马云家的淘宝已经有了很好的解决方案，那就是国内NPM数据镜像。

提到国内NPM数据镜像，淘宝建立自己的NPM数据镜像，他们的数据镜像与NPM官网的数据镜像是同步的，时间差大约在10分左右。

因为是在国内，所以不会受到GFW的影响。我们需要做的就是更改NPM包管理器的镜像地址，在我们的刚刚的PowerShell中使用如下命令：

npm config set registry https://registry.npm.taobao.org

当你替换之后，在不使用VPN或代理的情况下，通过NPM安装包就会速度很快了。

但是我要阐述一点，当我们安装AngularCLI的时候，其中有一个依赖项为node-sass，他的指定访问一个https://github.com/sass/node-sass/releases/download/v4.5.3/win32-x64-57_binding.node地址去下载，该地址是被GFW屏蔽的。所以就算我们使用国内NPM镜像，也会出现问题。

当然最好的解决方案是设置NPM为原始镜像地址，然以挂上高速VPN，去安装AngularCLI。

也许你本的网络很好，你也可以尝试使用淘宝NPM镜像，但是不要开VPN，那样会很慢。

就像我家和我单位的网。都是淘宝NPM镜像，单位安装AngularCLI一点问题没有，但是家里就出现了我上面说的node-sass下载不下来的问题了。

替换完淘宝NPM镜像之后，那么让我们继续，使用如下命令全局安装AngularCLI，注意这个只需要安装一次即可：

npm install –g @angular/cli

其中npm install是NPM安装的意思。

-g是全局安装的意思，是-global的简写

@angular/cli就是告诉NPM我们要安装AngularCLI

执行后就是慢慢等待他完成吧。

如果安装失败，你需要执行一下命令，卸载AngularCLI：

npm uninstall –g @angular/cli

npm cache clean --force

并删除“C:\Users\[你用系统账户名]\AppData\Roaming\npm\node_modules”目录下的@angular文件夹，重复上面的安装步骤。

安装成功之后你会看到如下界面：

OK，通过上述操作，我们已经在系统上安装完成了AngularCLI。

3. 在Asp.NET Core 中安装Angular

现在回到之前的项目路径：

运行如下命令，在项目根目录中新建一个Angular项目：

ng new [你的Angular项目名称] --skip-install

解析一下这条命令：

ng new是AngularCLI的新建命令

--skip-install是npm的跳过还原包命令

作用就是在当前目录下新建一个Angular项目并且跳过还原包

大神别嫌我啰嗦。我要照顾一下新手。

OK，运行之后的结果：