ABP入門系列(12)——如何升級Abp并調(diào)試源碼

ABP入門系列目錄——學(xué)習(xí)Abp框架之實(shí)操演練
源碼路徑:Github-LearningMpaAbp


1. 升級Abp

本系列教程是基于Abp V1.0版本,現(xiàn)在Abp版本已經(jīng)升級至V1.4.2,其中新增了New Feature,并對Abp做了相應(yīng)的Enhancements,以及Bug fixs。現(xiàn)在我們就把它升級至最新版本,那如何升級呢?
下面就請按我的步驟來將Abp由V1.0升級至V1.4.2

1.1. 過濾Abp Nuget包

VS打開解決方案文件,右鍵解決方案(不是某個(gè)項(xiàng)目),選中【管理解決方案的Nuget程序包(N)...】,如下圖1.1。

圖1.1

從圖中可以看到,VS智能提示有42個(gè)Nuget包可升級,其中有2個(gè)Nuget程序包可合并。看到這個(gè),不要犯了強(qiáng)迫癥,就全部更新合并。
要知道,Nuget程序包是相互依賴的,不一定最新的就能相互兼容。
所以這一次,我們保險(xiǎn)起見,只升級Abp相關(guān)Nuget程序包。
選中【更新】,在搜索框中錄入Abp進(jìn)行篩選Abp相關(guān)Nuget程序包(一共16個(gè))。

1.2. 更新Abp相關(guān)Nuget包

勾選【選擇所有的包】,并點(diǎn)擊【更新】。VS會去分析解決方案下每個(gè)工程的Nuge包的依賴項(xiàng),如下圖1.2。


圖1.2

分析完畢后,彈出分析結(jié)果,即每個(gè)工程將要更新哪些Nuget包,如圖1.3。

圖1.3

從圖中可以發(fā)現(xiàn),不僅僅是更新了Nuget包,依賴的相關(guān)包也將自動更新。
毫無疑問,點(diǎn)擊【確定】,緊接著會彈出一個(gè)【接受許可證】,如圖1.4,點(diǎn)擊【我接受】。


圖1.4

觀察輸出窗口,發(fā)現(xiàn)VS已經(jīng)開始下載要更新的Nuget包并安裝,如圖1.5。

圖1.5

因?yàn)锳bp V1.4.2已經(jīng)支持TypeScript,VS解析到需要安裝TypeScript,彈出圖1.6所示對話框。

圖1.6

點(diǎn)【是】進(jìn)入下一步。稍等2分鐘,即可成功安裝,如圖1.7。

圖1.7

1.3. 編譯項(xiàng)目

編譯項(xiàng)目,報(bào)了一堆錯誤,如圖1.8。


圖1.8

第一個(gè)錯誤好解決,是我們擴(kuò)展AbpSesion出的錯誤。定位一看,原來是Abp修改了默認(rèn)IAbpSession的實(shí)現(xiàn)類ClaimsAbpSession。我們只需要刪除報(bào)錯的構(gòu)造方法,按下面方式更改即可:

public AbpSessionExtension(IPrincipalAccessor principalAccessor, IMultiTenancyConfig multiTenancy,
            ITenantResolver tenantResolver, IAmbientScopeProvider<SessionOverride> sessionOverrideScopeProvider)
            : base(principalAccessor, multiTenancy, tenantResolver, sessionOverrideScopeProvider)
        {
        }

接下來的錯誤都是Typescript報(bào)的錯,需要安裝下TypeScript。

1.4. 安裝TypeScript

依次點(diǎn)擊【工具-->擴(kuò)展和更新-->聯(lián)機(jī)】,在右邊搜索框中搜索typescript,并按【最新】排序,搜索結(jié)果如圖1.9。選擇最新版本下載后,關(guān)閉VS,安裝即可。

圖1.9

1.5. 運(yùn)行Web項(xiàng)目

重新編譯下,Ctrl+F5運(yùn)行web項(xiàng)目,報(bào)錯如圖2.0。

圖2.0

按照圖示所言,修改web.config中的customErrors節(jié)點(diǎn)為Off,<customErrors mode="Off" />。重新運(yùn)行Web項(xiàng)目,報(bào)錯如圖2.1。
圖2.1

一看是 EntityFramework.DynamicFilters相關(guān)錯誤,這個(gè)是一個(gè)第三方Nuget包,用來支持EF進(jìn)行Linq動態(tài)過濾的。猜到一種可能是升級后的DynamicFilters刪除了圖中的擴(kuò)展方法,導(dǎo)致出錯。到abp官方github上的項(xiàng)目上根據(jù)關(guān)鍵字搜索Issue,如圖2.2。


圖2.2

果然大家跟我們報(bào)的一樣的錯,其中已經(jīng)給出了解決方案,需要將DynamicFilterNuget包降級到1.4.11。

右鍵解決方案,選擇【管理解決方案的Nuget程序包(N)...】,在搜索框中輸入 【EntityFramework.DynamicFilters】過濾,并選中依賴的項(xiàng)目,在版本下拉框中選擇1.4.11,點(diǎn)擊安裝,如圖2.3。

圖2.3

重新編譯,再次啟動web項(xiàng)目,還是報(bào)錯,如圖2.4。

圖2.4

是不是快崩潰了,別怕,跟著我做,讓你氣死回生。
分別定位到依賴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>

是不是吐血,降級后,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項(xiàng)目,這一次終于顯示久違的登陸界面,預(yù)示著這次升級折騰結(jié)束了。


有了這次升級折騰經(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目錄,找到對應(yīng)版本的Source code.zip,下載即可。

2.2. 還原Nuget包

打開下載下來的源碼解決方案,右鍵解決方案,選擇還原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)目,然后在源碼對應(yīng)解決方案,選擇【調(diào)試-->附加到進(jìn)程】,從進(jìn)程列表中,選擇【iisexpress.exe】進(jìn)程附加即可。打個(gè)斷點(diǎn),就可以調(diào)試了。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

推薦閱讀更多精彩內(nèi)容