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

.NET Core 2.1 终于发布了，赶紧升级一下。(ASP.NET Core 系列目录)

一. 安装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