ABP入门系列(12)——如何升级Abp并调试源码

时间:2022-08-07 05:14:00

ABP入门系列目录——学习Abp框架之实操演练

源码路径:Github-LearningMpaAbp


1. 升级Abp

本系列教程是基于Abp V1.0版本,现在Abp版本已经升级至V1.4.2(截至至文章发布时间),其中新增了New Feature,并对Abp做了相应的Enhancements,以及Bug fixs。现在我们就把它升级至最新版本,那如何升级呢?

下面就请按我的步骤来将Abp由V1.0升级至V1.4.2

1.1. 过滤Abp Nuget包

VS打开解决方案文件,右键解决方案(不是某个项目),选中【管理解决方案的Nuget程序包(N)...】,如下图1.1。

ABP入门系列(12)——如何升级Abp并调试源码

从图中可以看到,VS智能提示有42个Nuget包可升级,其中有2个Nuget程序包可合并。看到这个,不要犯了强迫症,就全部更新合并。

要知道,Nuget程序包是相互依赖的,不一定最新的就能相互兼容。

所以这一次,我们保险起见,只升级Abp相关Nuget程序包。

选中【更新】,在搜索框中录入Abp进行筛选Abp相关Nuget程序包(一共16个)。

1.2. 更新Abp相关Nuget包

勾选【选择所有的包】,并点击【更新】。VS会去分析解决方案下每个工程的Nuge包的依赖项,如下图1.2。

ABP入门系列(12)——如何升级Abp并调试源码

分析完毕后,弹出分析结果,即每个工程将要更新哪些Nuget包,如图1.3。

ABP入门系列(12)——如何升级Abp并调试源码

从图中可以发现,不仅仅是更新了Nuget包,依赖的相关包也将自动更新。

毫无疑问,点击【确定】,紧接着会弹出一个【接受许可证】,如图1.4,点击【我接受】。

ABP入门系列(12)——如何升级Abp并调试源码

观察输出窗口,发现VS已经开始下载要更新的Nuget包并安装,如图1.5。

ABP入门系列(12)——如何升级Abp并调试源码

因为Abp V1.4.2已经支持TypeScript,VS解析到需要安装TypeScript,弹出图1.6所示对话框。

ABP入门系列(12)——如何升级Abp并调试源码

点【是】进入下一步。稍等2分钟,即可成功安装,如图1.7。

ABP入门系列(12)——如何升级Abp并调试源码

1.3. 编译项目

编译项目,报了一堆错误,如图1.8。

ABP入门系列(12)——如何升级Abp并调试源码

第一个错误好解决,是我们扩展AbpSesion出的错误。定位一看,原来是Abp修改了默认IAbpSession的实现类ClaimsAbpSession。我们只需要删除报错的构造方法,按下面方式更改即可:

public AbpSessionExtension(IPrincipalAccessor principalAccessor, IMultiTenancyConfig multiTenancy,
ITenantResolver tenantResolver, IAmbientScopeProvider<SessionOverride> sessionOverrideScopeProvider)
: base(principalAccessor, multiTenancy, tenantResolver, sessionOverrideScopeProvider)
{
}

接下来的错误都是Typescript报的错,需要安装下TypeScript。

1.4. 安装TypeScript

依次点击【工具-->扩展和更新-->联机】,在右边搜索框中搜索typescript,并按【最新】排序,搜索结果如图1.9。选择最新版本下载后,关闭VS,安装即可。

ABP入门系列(12)——如何升级Abp并调试源码

1.5. 运行Web项目

重新编译下,Ctrl+F5运行web项目,报错如图2.0。

ABP入门系列(12)——如何升级Abp并调试源码

按照图示所言,修改web.config中的customErrors节点为Off,<customErrors mode="Off" />。重新运行Web项目,报错如图2.1。

ABP入门系列(12)——如何升级Abp并调试源码

一看是 EntityFramework.DynamicFilters相关错误,这个是一个第三方Nuget包,用来支持EF进行Linq动态过滤的。猜到一种可能是升级后的DynamicFilters删除了图中的扩展方法,导致出错。到abp官方github上的项目上根据关键字搜索Issue,如图2.2。

ABP入门系列(12)——如何升级Abp并调试源码

果然大家跟我们报的一样的错,其中已经给出了解决方案,需要将DynamicFilterNuget包降级到1.4.11。

右键解决方案,选择【管理解决方案的Nuget程序包(N)...】,在搜索框中输入 【EntityFramework.DynamicFilters】过滤,并选中依赖的项目,在版本下拉框中选择1.4.11,点击安装,如图2.3。

ABP入门系列(12)——如何升级Abp并调试源码

重新编译,再次启动web项目,还是报错,如图2.4。

ABP入门系列(12)——如何升级Abp并调试源码

是不是快崩溃了,别怕,跟着我做,让你气死回生。

分别定位到依赖EntityFramework.DynamicFilters组件的项目,修改App.Config或Web.Config,找到以下节点:

<dependentAssembly>
<assemblyIdentity name="EntityFramework.DynamicFilters" publicKeyToken="146423a1b8d60775" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-2.3.0.0" newVersion="2.3.0.0" />
</dependentAssembly>

是不是吐血,降级后,VS没有更改依赖组件的版本。修改如下:

<dependentAssembly>
<assemblyIdentity name="EntityFramework.DynamicFilters" publicKeyToken="146423a1b8d60775" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-1.4.11" newVersion="1.4.11" />
</dependentAssembly>

修改完毕后,重新编译,启动web项目,这一次终于显示久违的登陆界面,预示着这次升级折腾结束了。

ABP入门系列(12)——如何升级Abp并调试源码

有了这次升级折腾经验,下次我想咱就不怕了。

2. 调试源码

按照作者的官方如何调试的文档介绍Debuging,所有官方ASP.NET Boilerplate nuget包都启用了GitLink。这意味着您可以轻松地在项目中调试Abp.* nuget包。

但是由于GitLink暂不支持 xproj/project.json格式,所以我们暂时用不了GitLink进行调试。

这里另外提供一种调试的方式:

2.1. 下载与本地模板项目版本一致的Abp源码

首先去看看Abp的Releases目录,找到对应版本的Source code.zip,下载即可。

2.2. 还原Nuget包

打开下载下来的源码解决方案,右键解决方案,选择还原Nuget包。还原成功后,重新编译项目。

然后把需要调试的dll文件拷贝到自己的模板项目中的web项目的Bin目录下。

2.3. 附加进程调试

Ctrl+F5运行web项目,然后在源码对应解决方案,选择【调试-->附加到进程】,从进程列表中,选择【iisexpress.exe】进程附加即可。打个断点,就可以调试了。

ABP入门系列(12)——如何升级Abp并调试源码