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)擊【我接受】菲饼。
觀察輸出窗口肾砂，發(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)試了挤忙。
