ASP.NET Core 2.1 : 十.升级现有Core2.0 项目到2.1

.NET Core 2.1 终于发布了， 赶紧升级一下。

一. 安装SDK

首先现在并安装 SDK（64-bit）

安装完毕后如果新建项目可以看到已经有2.1的选项了

二. 更新现有2.0项目到2.1

1. 修改 项目版本

右键点击解决方案管理器中的项目， 选择编辑项目名.csproj

将 <TargetFramework>netcoreapp2.0</TargetFramework> 中的2.0改为2.1，保存。

2. 将引用 Microsoft.AspNetCore.All  替换为 Microsoft.AspNetCore.App 

项目依赖中找到 Microsoft.AspNetCore.All ，移除它， 在Nugget中搜索并安装 Microsoft.AspNetCore.App 

注意：以下内容依旧包含在 Microsoft.AspNetCore.All 中， 而 Microsoft.AspNetCore.App 中不存在

• Microsoft.AspNetCore.ApplicationInsights.HostingStartup
• Microsoft.AspNetCore.AzureAppServices.HostingStartup
• Microsoft.AspNetCore.AzureAppServicesIntegration
• Microsoft.AspNetCore.DataProtection.AzureKeyVault
• Microsoft.AspNetCore.DataProtection.AzureStorage
• Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv
• Microsoft.AspNetCore.SignalR.Redis
• Microsoft.Data.Sqlite
• Microsoft.Data.Sqlite.Core
• Microsoft.EntityFrameworkCore.Sqlite
• Microsoft.EntityFrameworkCore.Sqlite.Core
• Microsoft.Extensions.Caching.Redis
• Microsoft.Extensions.Configuration.AzureKeyVault
• Microsoft.Extensions.Logging.AzureAppServices
• Microsoft.VisualStudio.Web.BrowserLink

所以如果项目中需要用到这些内容， 可以单独引用它们， 而不建议再次整体引用 Microsoft.AspNetCore.All 

3. 修改其他引用

再次打开*.csproj文件， 可以看到对应的 Microsoft.AspNetCore.All 已经替换为Microsoft.AspNetCore.App 了

删除各种 <DotNetCliToolReference Include="********" Version="2.0.3" />  例如： <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.3" /> 

最终这个*.csproj文件类似这样

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <UserSecretsId>aspnet-{Project Name}-{GUID}</UserSecretsId>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.App" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="2.1.0" PrivateAssets="All" />
  </ItemGroup>
</Project>

4.修改Program.cs

修改Main方法和BuildWebHost方法， 结果如下

    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>();
    }

5. 修改Startup

修改后代码示例如下， 主要是新增行，删除UseBrowserLink， 见下文代码的颜色标注

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

namespace WebApp1
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<CookiePolicyOptions>(options =>
            {
                // This lambda determines whether user consent for non-essential cookies is needed for a given request.
                options.CheckConsentNeeded = context => true;
                options.MinimumSameSitePolicy = SameSiteMode.None;
            });


            services.AddMvc()
                .SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
　　　　　　　　　　//app.UseBrowserLink();  删除此行
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Error");
                app.UseHsts();
            }

            app.UseHttpsRedirection();
            app.UseStaticFiles();
            app.UseCookiePolicy();

            app.UseMvc();
        }
    }
}

三. 其他改动

• shared文件夹中添加了新文件_CookieConsentPartial.cshtml, 在_Layout文件中被引用 <partial name="_CookieConsentPartial" /> 
• _ValidationScriptsPartial.cshtml 文件中的jquery.validate.js版本升级到了1.17.0
• JQuery从2.2.0升级到3.3.1

四. 一点郁闷的事

看到2.1发布， 首先没有去下载SDK而是查看VS是否有更新，希望更新VS的时候可以顺便更新SDK。 当前版本15.7.1 ， 官方文档中提示前几天有15.7.2发布， VS中检查更新一直没有。

下载SDK安装好后， 终于右上角的小旗子亮了提示有更新， 各种重试均是不动没有下载进度。

最后不管它发现它以一种怪异的方式开始了更新。。。