一步一步搭建 .net core 应用

前言

近段时间 .net core 大火，公司也打算趁此机会把后续项目迁移到 .net core 平台上，我们下面的一帮人也就跟着大部队，开始狂补 dotnetcore 相关的技术了。此贴主要记录我在搭建dotnet core项目过程中采坑点和特别需要注意的点，持续更新。。。

Let's Coding

一、项目环境准备

开发工具：vs2017 ；首先，我在搭建demo的时候，api和web项目都是部署在IIS上的，dotnet core和dotnet framework不太一样，若要部署在iis上，需要额外安装一个运行时-AspnetCoreModule , 下载链接： https://dotnet.microsoft.com/download

到此，在windows上的基本环境就好了，接下来就去愉快的撸码去吧；

二：项目搭建

1.在新建的解决方案上右键，选择.net core ，选择 “Asp.Net Core Web 应用程序” ，填写项目名称，在二级界面选择你要新建的 web 项目类型，我先以 API 作为示例：确定即可。

2.配置 Swagger

为了给接口调用方一个完整的接口文档，页为了不爱写文档的 coder，直接使用“丝袜哥” 插件自动生成接口文档，配置如下：

首先安装在“管理Nuget程序包”中搜索“Swashbuckle.AspNetCore”，安装他。

接着在Startup 类中添加如下配置：

 1   public void ConfigureServices(IServiceCollection services)
 2         {
 3             services.Configure<IISServerOptions>(options =>
 4             {
 5                 options.AutomaticAuthentication = false;
 6             });
 7 
 8             services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
 9             //注册Swagger生成器，定义一个和多个Swagger 文档
10             services.AddSwaggerGen(c =>
11             {
12                 c.SwaggerDoc("v1", new Info
13                 {
14                     Title = "DemoNetCore接口文档",
15                     Version = "v1",
16                     Description = "这里是框架说明文档",
17                     TermsOfService = "None",
18                     Contact = new Swashbuckle.AspNetCore.Swagger.Contact { Name = "DemoNetCore", Email = "xxxx@qq.com", Url = "http://www.xxx.com" }
19 
20                 });
21             });
22 
23             services.AddSingleton<IQuestionsService, QuestionsService>();
24 
25         }

 1    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
 2         {
 3             if (env.IsDevelopment())
 4             {
 5                 app.UseDeveloperExceptionPage();
 6             }
 7             else
 8             {
 9                 // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
10                 app.UseHsts();
11             }
12 
13             app.UseHttpsRedirection();
14             app.UseMvc();
15 
16             //注入Swagger 服务
17             //启用中间件服务生成Swagger作为JSON终结点
18             app.UseSwagger();
19             //启用中间件服务对swagger-ui，指定Swagger JSON终结点
20             app.UseSwaggerUI(c =>
21             {
22                 c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
23             });
24         }

到此，Swagger 配置完成；

3.部署到IIS

Api 项目右键发布，点击配置，进入二级界面，

我们可以设置发布输出的文件夹，不用他默认文件夹，并且配置为Debug模式（方便我们进行开发附加进程调试，但是后期正式上线的时候，要记得改为Release 模式），保存即可；

接下来，我们就在 IIS 中正常的添加网站就行了，但是记得，跟 dotnet Framework 不一样，我们要把网站的物理路径指向我们刚刚发布的路径。然后打开我们之前的Swagger 文档验证发布是否成功，localhost:8022/swagger/index.html