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】程序附加即可。打個斷點，就可以除錯了。