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安裝好后， 終於右上角的小旗子亮了提示有更新， 各種重試均是不動沒有下載進度。

最后不管它發現它以一種怪異的方式開始了更新。。。