ABP入門(mén)系列目錄——學(xué)習(xí)Abp框架之實(shí)操演練
源碼路徑：Github-LearningMpaAbp
1. 升級(jí)Abp
本系列教程是基于Abp V1.0版本，現(xiàn)在Abp版本已經(jīng)升級(jí)至V1.4.2，其中新增了New Feature，并對(duì)Abp做了相應(yīng)的Enhancements，以及Bug fixs。現(xiàn)在我們就把它升級(jí)至最新版本，那如何升級(jí)呢？
下面就請(qǐng)按我的步驟來(lái)將Abp由V1.0升級(jí)至V1.4.2。
1.1. 過(guò)濾Abp Nuget包
VS打開(kāi)解決方案文件，右鍵解決方案（不是某個(gè)項(xiàng)目），選中【管理解決方案的Nuget程序包（Ｎ）...】，如下圖1.1。
從圖中可以看到，VS智能提示有42個(gè)Nuget包可升級(jí)，其中有2個(gè)Nuget程序包可合并。看到這個(gè)，不要犯了強(qiáng)迫癥，就全部更新合并。
要知道，Nuget程序包是相互依賴(lài)的，不一定最新的就能相互兼容。
所以這一次，我們保險(xiǎn)起見(jiàn)，只升級(jí)Abp相關(guān)Nuget程序包。
選中【更新】，在搜索框中錄入Abp進(jìn)行篩選Abp相關(guān)Nuget程序包（一共16個(gè)）。
1.2. 更新Abp相關(guān)Nuget包
勾選【選擇所有的包】，并點(diǎn)擊【更新】。VS會(huì)去分析解決方案下每個(gè)工程的Nuge包的依賴(lài)項(xiàng)，如下圖1.2。
分析完畢后，彈出分析結(jié)果，即每個(gè)工程將要更新哪些Nuget包，如圖1.3。
從圖中可以發(fā)現(xiàn)，不僅僅是更新了Nuget包，依賴(lài)的相關(guān)包也將自動(dòng)更新。
毫無(wú)疑問(wèn)，點(diǎn)擊【確定】，緊接著會(huì)彈出一個(gè)【接受許可證】，如圖1.4，點(diǎn)擊【我接受】。
觀(guān)察輸出窗口，發(fā)現(xiàn)VS已經(jīng)開(kāi)始下載要更新的Nuget包并安裝，如圖1.5。
因?yàn)锳bp V1.4.2已經(jīng)支持TypeScript，VS解析到需要安裝TypeScript，彈出圖1.6所示對(duì)話(huà)框。
點(diǎn)【是】進(jìn)入下一步。稍等2分鐘，即可成功安裝，如圖1.7。
1.3. 編譯項(xiàng)目
編譯項(xiàng)目，報(bào)了一堆錯(cuò)誤，如圖1.8。
第一個(gè)錯(cuò)誤好解決，是我們擴(kuò)展AbpSesion出的錯(cuò)誤。定位一看，原來(lái)是Abp修改了默認(rèn)IAbpSession的實(shí)現(xiàn)類(lèi)ClaimsAbpSession。我們只需要?jiǎng)h除報(bào)錯(cuò)的構(gòu)造方法，按下面方式更改即可：
public AbpSessionExtension(IPrincipalAccessor principalAccessor, IMultiTenancyConfig multiTenancy,
ITenantResolver tenantResolver, IAmbientScopeProvider<SessionOverride> sessionOverrideScopeProvider)
: base(principalAccessor, multiTenancy, tenantResolver, sessionOverrideScopeProvider)
{
}
接下來(lái)的錯(cuò)誤都是Typescript報(bào)的錯(cuò)，需要安裝下TypeScript。
1.4. 安裝TypeScript
依次點(diǎn)擊【工具-->擴(kuò)展和更新-->聯(lián)機(jī)】，在右邊搜索框中搜索typescript，并按【最新】排序，搜索結(jié)果如圖1.9。選擇最新版本下載后，關(guān)閉VS，安裝即可。
1.5. 運(yùn)行Web項(xiàng)目
重新編譯下，Ctrl+F5運(yùn)行web項(xiàng)目，報(bào)錯(cuò)如圖2.0。
按照?qǐng)D示所言，修改web.config中的customErrors節(jié)點(diǎn)為Off，
<customErrors mode="Off" />。重新運(yùn)行Web項(xiàng)目，報(bào)錯(cuò)如圖2.1。
一看是 EntityFramework.DynamicFilters相關(guān)錯(cuò)誤，這個(gè)是一個(gè)第三方Nuget包，用來(lái)支持EF進(jìn)行Linq動(dòng)態(tài)過(guò)濾的。猜到一種可能是升級(jí)后的DynamicFilters刪除了圖中的擴(kuò)展方法，導(dǎo)致出錯(cuò)。到abp官方github上的項(xiàng)目上根據(jù)關(guān)鍵字搜索Issue，如圖2.2。
果然大家跟我們報(bào)的一樣的錯(cuò)，其中已經(jīng)給出了解決方案，需要將DynamicFilterNuget包降級(jí)到1.4.11。
右鍵解決方案，選擇【管理解決方案的Nuget程序包（Ｎ）...】，在搜索框中輸入 【EntityFramework.DynamicFilters】過(guò)濾，并選中依賴(lài)的項(xiàng)目，在版本下拉框中選擇1.4.11，點(diǎn)擊安裝，如圖2.3。
重新編譯，再次啟動(dòng)web項(xiàng)目，還是報(bào)錯(cuò)，如圖2.4。
是不是快崩潰了，別怕，跟著我做，讓你氣死回生。
分別定位到依賴(lài)EntityFramework.DynamicFilters組件的項(xiàng)目，修改App.Config或Web.Config，找到以下節(jié)點(diǎn)：
<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>
是不是吐血，降級(jí)后，VS沒(méi)有更改依賴(lài)組件的版本。修改如下：
<dependentAssembly>
<assemblyIdentity name="EntityFramework.DynamicFilters" publicKeyToken="146423a1b8d60775" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-1.4.11" newVersion="1.4.11" />
</dependentAssembly>
修改完畢后，重新編譯，啟動(dòng)web項(xiàng)目，這一次終于顯示久違的登陸界面，預(yù)示著這次升級(jí)折騰結(jié)束了。
有了這次升級(jí)折騰經(jīng)驗(yàn)，下次我想咱就不怕了。
2. 調(diào)試源碼
按照作者的官方如何調(diào)試的文檔介紹Debuging，所有官方ASP.NET Boilerplate nuget包都啟用了GitLink。這意味著您可以輕松地在項(xiàng)目中調(diào)試Abp.* nuget包。
但是由于GitLink暫不支持 xproj/project.json格式，所以我們暫時(shí)用不了GitLink進(jìn)行調(diào)試。
這里另外提供一種調(diào)試的方式：
2.1. 下載與本地模板項(xiàng)目版本一致的Abp源碼
首先去看看Abp的Releases目錄，找到對(duì)應(yīng)版本的Source code.zip，下載即可。
2.2. 還原Nuget包
打開(kāi)下載下來(lái)的源碼解決方案，右鍵解決方案，選擇還原Nuget包。還原成功后，重新編譯項(xiàng)目。
然后把需要調(diào)試的dll文件拷貝到自己的模板項(xiàng)目中的web項(xiàng)目的Bin目錄下。
2.3. 附加進(jìn)程調(diào)試
Ctrl+F5運(yùn)行web項(xiàng)目，然后在源碼對(duì)應(yīng)解決方案，選擇【調(diào)試-->附加到進(jìn)程】，從進(jìn)程列表中，選擇【iisexpress.exe】進(jìn)程附加即可。打個(gè)斷點(diǎn)，就可以調(diào)試了。
