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

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程序包（Ｎ）...】，以下图1.1。

从图中能够看到，VS智能提示有42个Nuget包可升级，其中有2个Nuget程序包可合并。看到这个，不要犯了强迫症，就所有更新合并。
要知道，Nuget程序包是相互依赖的，不必定最新的就能相互兼容。
因此这一次，咱们保险起见，只升级Abp相关Nuget程序包。
选中【更新】，在搜索框中录入Abp进行筛选Abp相关Nuget程序包（一共16个）。

1.2. 更新Abp相关Nuget包

勾选【选择全部的包】，并点击【更新】。VS会去分析解决方案下每一个工程的Nuge包的依赖项，以下图1.2。

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

从图中能够发现，不单单是更新了Nuget包，依赖的相关包也将自动更新。
毫无疑问，点击【肯定】，紧接着会弹出一个【接受许可证】，如图1.4，点击【我接受】。

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

由于Abp V1.4.2已经支持TypeScript，VS解析到须要安装TypeScript，弹出图1.6所示对话框。

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

1.3. 编译项目

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

第一个错误好解决，是咱们扩展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，安装便可。

1.5. 运行Web项目

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

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

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

果真你们跟咱们报的同样的错，其中已经给出了解决方案，须要将DynamicFilterNuget包降级到1.4.11。

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

从新编译，再次启动web项目，仍是报错，如图2.4。

是否是快崩溃了，别怕，跟着我作，让你气死回生。
分别定位到依赖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项目，这一次终于显示久违的登录界面，预示着此次升级折腾结束了。

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

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】进程附加便可。打个断点，就能够调试了。