ABP如何升级Abp并调试源码
1.升级Abp本系列教程是基于AbpV1.0版本,现在Abp版本已经升级至V1.4.2,其中新增了NewFeature,并对Abp做了相应的Enhancements,以及Bugfixs。现在我们就把它升级至最新版本,那如何升级呢?下面就请按我的步骤来将Abp由V1.0升级至V1.4.2。1.1.过滤AbpNuget包VS打开解决方案文件,右键解决方案(不是某个项目),选中【管理解决方案的Nuget程序包(N)...】,如下图1.1。图1.1从图中可以看到,VS智能提示有42个Nuget包可升级,其中有2个Nuget程序包可合并。看到这个,不要犯了强迫症,就全部更新合并。要知道,Nuget程序包是相互依赖的,不一定最新的就能相互兼容。所以这一次,我们保险起见,只升级Abp相关Nuget程序包。选中【更新】,在搜索框中录入Abp进行筛选Abp相关Nuget程序包(一共16个)。1.2.更新Abp相关Nuget包勾选【选择所有的包】,并点击【更新】。VS会去分析解决方案下每个工程的Nuge包的依赖项,如下图1.2。图1.2分析完毕后,弹出分析结果,即每个工程将要更新哪些Nuget包,如图1.3。图1.3从图中可以发现,不仅仅是更新了Nuget包,依赖的相关包也将自动更新。毫无疑问,点击【确定】,紧接着会弹出一个【接受许可证】,如图1.4,点击【我接受】。图1.4观察输出窗口,发现VS已经开始下载要更新的Nuget包并安装,如图1.5。图1.5因为AbpV1.4.2已经支持TypeScript,VS解析到需要安装TypeScript,弹出图1.6所示对话框。图1.6点【是】进入下一步。稍等2分钟,即可成功安装,如图1.7。图1.71.3.编译项目编译项目,报了一堆错误,如图1.8。图1.8第一个错误好解决,是我们扩展AbpSesion出的错误。定位一看,原来是Abp修改了默认IAbpSession的实现类ClaimsAbpSession。我们只需要删除报错的构造方法,按下面方式更改即可:publicAbpSessionExtension(IPrincipalAccessorprincipalAccessor,IMultiTenancyConfigmultiTenancy,ITenantResolvertenantResolver,IAmbientScopeProvider<SessionOverride>sessionOverrideScopeProvider):base(principalAccessor,multiTenancy,tenantResolver,sessionOverrideScopeProvider){}接下来的错误都是Typescript报的错,需要安装下TypeScript。1.4.安装TypeScript依次点击【工具-->扩展和更新-->联机】,在右边搜索框中搜索typescript,并按【最新】排序,搜索结果如图1.9。选择最新版本下载后,关闭VS,安装即可。图1.91.5.运行Web项目重新编译下,Ctrl+F5运行web项目,报错如图2.0。图2.0按照图示所言,修改web.config中的customErrors节点为Off,<customErrorsmode="Off"/>。重新运行Web项目,报错如图2.1。图2.1一看是EntityFramework.DynamicFilters相关错误,这个是一个第三方Nuget包,用来支持EF进行Linq动态过滤的。猜到一种可能是升级后的DynamicFilters删除了图中的扩展方法,导致出错。到abp官方github上的项目上根据关键字搜索Issue,如图2.2。图2.2果然大家跟我们报的一样的错,其中已经给出了解决方案,需要将DynamicFilterNuget包降级到1.4.11。右键解决方案,选择【管理解决方案的Nuget程序包(N)...】,在搜索框中输入【EntityFramework.DynamicFilters】过滤,并选中依赖的项目,在版本下拉框中选择1.4.11,点击安装,如图2.3。图2.3重新编译,再次启动web项目,还是报错,如图2.4。图2.4是不是快崩溃了,别怕,跟着我做,让你气死回生。分别定位到依赖EntityFramework.DynamicFilters组件的项目,修改App.Config或Web.Config,找到以下节点:<dependentAssembly><assemblyIdentityname="EntityFramework.DynamicFilters"publicKeyToken="146423a1b8d60775"culture="neutral"/><bindingRedirectoldVersion="0.0.0.0-2.3.0.0"newVersion="2.3.0.0"/></dependentAssembly>是不是吐血,降级后,VS没有更改依赖组件的版本。修改如下:<dependentAssembly><assemblyIdentityname="EntityFramework.DynamicFilters"publicKeyToken="146423a1b8d60775"culture="neutral"/><bindingRedirectoldVersion="0.0.0.0-1.4.11"newVersion="1.4.11"/></dependentAssembly>修改完毕后,重新编译,启动web项目,这一次终于显示久违的登陆界面,预示着这次升级折腾结束了。有了这次升级折腾经验,下次我想咱就不怕了。2.调试源码按照作者的官方如何调试的文档介绍Debuging,所有官方ASP.NETBoilerplatenuget包都启用了GitLink。这意味着您可以轻松地在项目中调试Abp.*nuget包。但是由于GitLink暂不支持xproj/project.json格式,所以我们暂时用不了GitLink进行调试。这里另外提供一种调试的方式:2.1.下载与本地模板项目版本一致的Abp源码首先去看看Abp的Releases目录,找到对应版本的Sourcecode.zip,下载即可。2.2.还原Nuget包打开下载下来的源码解决方案,右键解决方案,选择还原Nuget包。还原成功后,重新编译项目。然后把需要调试的dll文件拷贝到自己的模板项目中的web项目的Bin目录下。2.3.附加进程调试Ctrl+F5运行web项目,然后在源码对应解决方案,选择【调试-->附加到进程】,从进程列表中,选择【iisexpress.exe】进程附加即可。打个断点,就可以调试了
【.Net】