ASP.NET 5探险(4):如何把ASP.NET 5从beta4升级到beta5
(此文章同时发表在本人微信公众号“dotNET每日精华文章”,欢迎右边二维码来关注。)
题记:上一篇文章讲述了ASP.NET 5 Beta带来的一些变化,虽然原文最后给出了从beta4升级到beta5的介绍,但是讲的过于简要和模糊。今天就给大家分享下我的经验。
我把我的ASP.NET 5的项目代码从beta 4升级到beta5还是遵从了上篇文章原文中提到的基本步骤。
1,安装或升级DNVM。
如果没有.NET Version Manager (DNVM),需要通过如下代码来安装(如果已经有了执行如下代码也会升级到最新版本):
1: @powershell -NoProfile -ExecutionPolicy unrestricted -Command "&{$Branch='dev';iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.ps1'))}"
理论上,执行以上代码就可以把dnvm安装(或升级)到“beta6-10395”,明显的不同是多了一个“update-self”的命令。
如果在已经有beta4的dnvm,那么执行上述命令后,需要重启命令行窗口才能看到最新的dnvm版本;当然我也遇到一个奇怪的问题,就是执行上述代码后死活不能升级,最后无奈,只好先执行第二步(见:升级DNX运行时)的特殊步骤,然后就会看到dnvm也自动升级为最新版本了。
2,升级DNX运行时。
如果正常升级了DNVM,那么无需去设置“DNX_FEED”环境变量,因为最新版的DNVM的默认地址已经是“https://www.nuget.org/api/v2”。现在只需要执行“dnvm upgrade”就可以下载并安装ASP.NET 5的Beta5运行时了(默认是clr x86),也会自动把这个运行时设置激活状态和default别名。
当然如果没有升级DNVM,那么可以设置“DNX_FEED”,然后再升级DNX运行时。
也可以不设置“DNX_FEED”,直接执行”dnvm upgrade“,来先升级到beta5的预发布版本(beta5-12103)。升级到beta5的预发布版本会同时升级dnvm,然后再次执行“dnvm upgrade”,升级到beta5正式发布版本。(这里说的就是上面提到的特殊步骤)。
3,修改project.json中的包引用。
打开解决方案中所有项目的project.json文件的,把其中所有后缀“beta4”的包修改为“beta5”,保存project.json文件后,VS会自动更新到最新的beta5的包。
需要注意的是,xunit的相关包要改为引用beta5的编译版本,即"xunit": "2.1.0-beta3-build3029","xunit.runner.dnx": "2.1.0-beta3-build99"。
和Configuration相关的包,从“Microsoft.Framework.ConfigurationModel”修改为“Microsoft.Framework.Configuration”。
把“Interfaces”后缀的包修改为“Abstractions”。
4,解决代码变更。根据上篇文章提到的更新尤其破坏变更列表(https://github.com/aspnet/announcements/issues?q=milestone%3A1.0.0-beta5),来修改编译有问题的代码。主要的修改有:
- EF7的迁移修改了代码接口(从属性改为方法),为了避免大量修改代码我是自己重建Migration。如果需要修改,见:https://github.com/aspnet/Announcements/issues/35
- 把命名空间“Microsoft.Framework.ConfigurationModel”修改为“Microsoft.Framework.Configuration”。
- IConfiguration.GetSubKey修改为IConfiguration.GetConfigurationSection
- _GlobalImport.cshtml重命名为_ViewImports.cshtml,修改后VS2015可能会报类型没有引用,不必理会(等着VSWebTools更新)
- 我之前讲解EF数据迁移的文章提到的代码“db.Database as SqlServerDatabase”要改为“db.Database as RelationalDatabase”
- 单元测试中,必须显式执行services.AddLogging()
以上就是我升级到beta5的一些经验。有不解的朋友可以在微信上和我交流讨论。