前幾天回答網友QOO提問,又多學會「AssemblyFileVersion不支援自動跳號,未設定時會引用AssemblyVersion」新知識,知道這些就夠了嗎?並沒有,今天又踩一雷,再獲冷知識一枚。

同事升級專案的Newtonsoft.Json.dll到7.0.1版,NuGet顯示版本為7.0.1版:

由於NuGet安裝時沒自動加入bindingRedirect設定,手動加入時為了找出newVersion的正確版號,參考了檔案資訊:

檔案版本是AssemblyFileVersion,那麼產品版本就是AssemblyVersion囉?加上NuGet Package說現在的版本是7.0.1,所以開開心心填上newVersion="7.0.1.18622":

<dependentAssembly>
    <assemblyIdentity name="Newtonsoft.Json"  publicKeyToken="30AD4FE6B2A6AEED" culture="neutral"/>
    <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="7.0.1.18622"/>
</dependentAssembly>

不料,程式抱怨找不到Newtonsoft.Json 4.5.0版,顯示繫結重新導向沒生效。爬文發現Json.NET 7.0.1相關導向範例都是寫newVersion="7.0.0.0",乖乖改成7.0.0.0後,系統正常運作。

問題來了,7.0.1、7.0.1.18622、7.0.0.0,這麼多版號搞得我好亂,將來遇到同樣狀況,到底要以哪一個為準?

做完功課,老狗又學會新把戲,除了AssemblyVersion、AssemblyFileVersion,還有所謂AssemblyInformationVersion!

  1. AssemblyVersion

    為必要屬性,是參照組件的重要依據,一旦版號改變,參照該組件的程式必須更新(重新編譯或設定組件繫結重新導向)。
  2. AssemblyFileVersion

    主要用於部署管理,可以每次部署時遞增以便區隔,是安裝程式常用的版本依據,實務上可由MSBuild產生(但要自己寫邏輯)。如果想不驚動相關程式悄悄換版,可以維持同一個AssemblyVersion,只編譯成AssemblyFileVersion不同的DLL檔。若未指定AssemblyFileVersion,系統會用AssemblyVersion版號當作AssemblyFileVersion。 AssemblyFileVersion可以用檔案總管檢視(即前面附圖所示的「檔案版本」)。
    注意:用檔案總管是看不到AssemblyVersion的!最簡便的查詢方式是透過Visual Studio:

  3. AssemblyInformationalVersion

    產品版本。它不像AssemblyVersion跟AssemblyFileVersion限定格式為四節數字,允許寫成"0.9 Beta Version"、"1.0 Release Candidate"之類的可讀文字,但過去曾出現過相關工具處理非數字AssemblyInformationalVersion的相容問題(例:Issue1Issue2)。當組件未指定AssemblyInformationalVersion時,系統會使用AssemblyVersion代替。

參考來源:stackoverflow

經過這次教訓,下回遇到要寫bindingRedirect時,就知道要乖乖查Visual Studio的組件屬性視窗,不會再用檔案總管亂查了。


Comments

Be the first to post a comment

Post a comment