你的團隊需要一個正確的程序集(dll)管理姿勢

很多團隊經歷時間的積澱之後,都會有很多的可重用的公共技術組件。大部分的團隊都會把這些公共組件生成程序集(dll)後,放到GIT或SVN的一個公共目錄裏面,以供各個項目中使用。起初在項目很少又或者是公共組件不多的時候,這樣看起來也沒有多大問題。但是隨着團隊越來越大,項目的組件增多,所封裝的可重用組件越來越多,一些問題就會慢慢暴露出來。這個時候如果還是使用這種方式去管理程序集,顯然就不太合適了。

我們知道,在Java中比較常用的包管理工具,如Maven。實際上在很多大公司裏面都會搭建自己公司的Maven私服,以管理公司的一些公共技術組件。

實際上在.net中也有,大家也絕對不陌生,就是Nuget, 相信每個人都從官方的nuget服務器上下載過一些第三方組件,如:log4net、quartz.net等等。

Nuget是一個.NET平台下的開源的項目,它是Visual Studio的擴展。在使用Visual Studio開發基於.NET Framework的應用時,Nuget能把在項目中添加、移除和更新引用的工作變得更加快捷方便。這是維基百科中的定義,實際上Nuget就是一個包管理器,類似於Java的Maven,可以幫助我們更方便的管理dll,這也是微軟提供給.net平台的一個正確的包管理工具。

而如Maven一樣,Nuget也可以搭建自己的私服。這篇文章就來簡單介紹一下如何搭建屬於你們團隊自己的Nuget服務器。

一、下載Nuget.Server

    從官方Nuget服務器上搜索nuget.server,點擊項目url中的github路徑。從github中下載nuget.server的源碼。

下載並解壓後的文件路徑如下圖所示:

二、搭建Nuget.Server

  1. 打開項目文件NuGet.Server.sln,找到NuGet.Server,右鍵發佈,選擇文件系統(跟發佈web程序一樣,發佈到IIS中)。
  2. IIS新建站點MyNuGet

    啟動程序出現以下頁面代表搭建成功
  3. 注意:若點擊here出現404頁面如下圖所示:

    可以通過VS運行起來Nuget.Server項目,然後將bin目錄替換IIS下的bin目錄,即可解決。出現下圖代表搭建成功

    打開VS的Nuget管理器,點擊圖中設置圖標,新建我們自己的nuget服務器

    之後就可以連上我們自己搭建的服務器了

三、自建NuGet基本使用

  1. 下載NuGet命令行打包工具nuget.exe
    下載地址://www.nuget.org/downloads

  2. 打包我們程序

  • 方式1:通過類庫文件csproj的方式打包
    首先打開我們程序的AssemblyInfo.cs文件修改程序集信息

使用nuget.exe打包程序集

在.csproj文件目錄下執行命令spec

nuget.exe spec //spec 在.csproj文件目錄下執行命令


此時會生成一個.nuspec文件,打開這個文件
修改其中的xml屬性即可(注意此處一些信息最好和AssemblyInfo.cs中的程序集信息一致)

修改完成後繼續執行pack命令

這時將生成的.nupkg文件直接copy到nuget服務器IIS目錄下的packages文件夾內即可
也可通過命令push推送至nuget服務器

nuget push *.nupkg -s //127.0.0.1:8005 123456 //push 程序包路徑 選項 地址 apikey
//apikey 可以在服務器webconfig中配置

完成後即可查看或使用我們發佈的程序集

四、問題

如果你認為以上就結束了,那你就太天真了,實際上,我們團隊在搭建與使用過程中還是遇到了很多問題的,如果搭建使用中踩到了同樣的坑可以參考下面幾點。

  1. 在剛開始使用的時候經常因為失誤或者程序有問題從而導致需要重新發佈nuget包,但是發現覆蓋掉原來的之後,項目里更新下來的始終還是原來的程序。
    解決:慎重慎重再慎重打包,需要重新發佈包的時候可以升級,不能覆蓋。(當時認為這個東西只能升級不能覆蓋)
  2. 用了一段時間後,由於當時至提供了nuget管理包的技術方案,卻沒有相應的使用規範與制度,導致團隊nuget包混亂,開發人員胡亂升級,胡亂引用nuget包,終於有一天造成大問題。因此需要制定一個完善的使用規範與制度,包括如何打包,如何發佈,誰來打包,誰來發佈,慎重打包、升級、專人管理等
  3. 由於問題2引起的問題,因此決定重新整理nuget包(不破不立),於是重新搭建了一個nuget服務器,重新規整雖有的程序集、組件、重新打包發佈等,但是發現遷移到新的後,項目中下載下來的程序集還是原來的。(又遇到了問題1)。這次靈感一來發現問題解決方案。VS2017通過工具->選項->清除所有NuGet緩存 再重新下載包問題即可解決

    若沒有VS2017或找不到清楚NuGet緩存選項,也可找到自己機器上nuget的緩存文件夾刪除掉裏面對應的內容也可以,一般是在C:\Users\Administrator.nuget

小結

今天簡單介紹了如何搭建自己團隊的Nuget服務器,以及如何打包並發佈程序集到Nuget。實際上,大多數的.net團隊仍然是在用SVN或GIT的方式去管理dll,包括我所在的某大廠,雖然後來框架研發部,提供了一個自主研發的管理工具,但我個人感覺還是不如Nuget更好用一些。

如果你的團隊不滿足現在的程序集管理方式,那麼不妨換個姿勢,搭建一個屬於你們團隊自己的Nuget服務器吧!當然,如果你有更好的方式,歡迎與我留言分享!

Tags: