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】進程附加便可。打個斷點，就能夠調試了。