雅處理版本號、變量與固定版本)
CentralisedPackageConverter版本解析源碼探秘如何優(yōu)雅處理版本號、變量與固定版本【免費下載鏈接】CentralisedPackageConverterConverts a project to use Centralised Package Management項目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverterCentralisedPackageConverter中央包管理轉(zhuǎn)換器是一款把大型 .NET 解決方案一鍵遷移到 Centralised Package ManagementCPM集中式包管理的 dotnet 命令行工具。它最核心的看家本領(lǐng)就是對項目文件里千奇百怪的版本號進行智能解析——無論是普通版本號、MSBuild 版本變量還是方括號包裹的固定版本都能一一識別并優(yōu)雅處理。本文帶你直擊PackageVersion.cs與Versioning.cs源碼用最通俗的方式搞懂它的版本解析機制新手也能輕松看懂。 CentralisedPackageConverter 是什么一個命令搞定 CPM 遷移在 NuGet 的集中式包管理CPM模式下所有項目的包版本被統(tǒng)一收攏到根目錄的Directory.Packages.props文件中項目文件里只保留包引用、不再寫版本號。好處是版本一目了然、升級一處生效但手動遷移幾十上百個項目文件無疑是災(zāi)難。CentralisedPackageConverter 正是為此而生掃描目錄樹下的全部.csproj、.fsproj等工程文件收集版本引用刪除項目文件里的 Version 屬性再把PackageVersion條目寫入集中的Directory.Packages.props。它還支持反向回退revert一條命令即可把 CPM 還原為傳統(tǒng)寫法。 版本解析源碼在哪三大核心文件一目了然要理解版本解析只需關(guān)注工程根目錄下這幾個文件PackageVersion.cs版本解析的核心負責(zé)把字符串解析成三種形態(tài)之一Versioning.cs版本選擇策略決定沖突時取最大還是最小版本PackageConverter.cs解析后的落盤邏輯重寫工程文件并生成Directory.Packages.props對應(yīng)地測試目錄下的 VersioningTests.cs 用大量用例把各種邊界情況覆蓋得明明白白是理解源碼行為的最佳說明書。 三種版本形態(tài)普通版本號、變量與固定版本PackageVersion類通過TryParse方法把版本字符串分成三類普通版本號如8.0.3交給 NuGet 的NuGetVersion解析版本變量形如$(MyVersion)即 MSBuild 屬性引用原樣保留固定版本形如[1.0.0]方括號表示精確鎖定此版本解析時去掉方括號并打上固定標(biāo)記其中變量和固定版本是很多工具容易忽略的細節(jié)CentralisedPackageConverter 卻處理得相當(dāng)細致。 變量版本$(...)是如何被原樣保留的源碼中判斷變量版本的方式非常巧妙只要值里包含$(就直接認(rèn)定為變量把整個字符串存入VariableName不做任何數(shù)字解析。if (value.Contains($()) { version new PackageVersion { VariableName value }; return true; }這意味著像Version$(PackageVersion)這樣的引用不會被誤傷遷移后變量引用依舊保留項目構(gòu)建行為完全不變。類里還有個IsVariable屬性配合 Versioning.cs 中的PreferExisting邏輯保證變量版本優(yōu)先于普通數(shù)字版本避免被其它項目的數(shù)字版本覆蓋。 固定版本[1.0.0]是如何識別的固定版本在 NuGet 中表示嚴(yán)格等于該版本。源碼用了一段非常高效的 Span 操作先Trim()去掉首尾空白檢查首字符是[且末字符是]滿足則去掉方括號、標(biāo)記IsFixedVersion true再交給NuGetVersion.TryParse校驗數(shù)字部分var span value.AsSpan().Trim(); if (span.Length 2 span[0] [ span[^1] ]) { value span.Slice(1, span.Length - 2).ToString(); isFixed true; }解析成功后ToFullString()會把方括號原樣加回來確保寫入Directory.Packages.props時語義不丟失。測試用例 TestFixedVersion 驗證了[1.0.0]會被完整保留。?? 多項目版本沖突怎么辦最大版本與最小版本策略大型解決方案里同一個包在不同項目可能有不同版本。CentralisedPackageConverter 默認(rèn)取最大版本因為高版本通常兼容低版本也可以通過-v參數(shù)切換為取最小版本。對應(yīng)邏輯在 Versioning.cs 的PreferExisting方法中用 NuGet 官方的VersionComparer比較新舊版本默認(rèn)策略是新版本 已存在版本時保留新版本。測試用例 VersioningPickRegular 展示了從 0.0.0 到 10.1.11 六個版本中正確選出 10.1.11 的過程。 預(yù)發(fā)布版本與版本比較模式細節(jié)控的福音針對預(yù)發(fā)布版本如2.0.0-beta工具提供兩個貼心開關(guān)-p/--ignore-prerelease完全忽略預(yù)發(fā)布版本-c/--version-comparison選擇版本比較時考慮的組成部分支持四種模式Default標(biāo)準(zhǔn)規(guī)則正式版優(yōu)先于預(yù)發(fā)布版Version只看主次修訂號VersionRelease連同預(yù)發(fā)布標(biāo)簽一起比較VersionReleaseMetadata連構(gòu)建元數(shù)據(jù)metadata也納入比較源碼中IgnorePackageVersion方法配合Comparer即VersionComparer實現(xiàn)這一策略而 VersioningTests.cs 里的VersioningByPrerelease、VersioningByMetadata用例把每種模式的輸出結(jié)果都固定了下來行為一目了然。? 版本號隱式補全8 就是 8.0.0CentralisedPackageConverter 還有一個貼心的細節(jié)NuGet 支持省略版本位8、8.0、8.0.0三者等價。工具的解析邏輯天然繼承了這一特性項目里寫Version8也能正常識別不會因為位數(shù)不齊而報錯或跳過。 一句話總結(jié)CentralisedPackageConverter 的版本解析之所以優(yōu)雅在于它把三類版本形態(tài)數(shù)字、變量、固定分層處理再配合可配置的版本選擇策略把集中式包管理的遷移做成了零心智負擔(dān)的一鍵操作。想深入研究的讀者直接打開PackageVersion.cs和Versioning.cs這兩個文件配上VersioningTests.cs的測試用例半小時就能吃透全部邏輯。如果你正為大型解決方案的 CPM 遷移發(fā)愁不妨親自跑一遍這個工具體會一下什么叫潤物細無聲?！久赓M下載鏈接】CentralisedPackageConverterConverts a project to use Centralised Package Management項目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 CentralisedPackageConverter版本解析源碼探秘：如何優(yōu)雅處理版本號、變量與固定版本
CentralisedPackageConverter版本解析源碼探秘如何優(yōu)雅處理版本號、變量與固定版本【免費下載鏈接】CentralisedPackageConverterConverts a project to use Centralised Package Management項目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverterCentralisedPackageConverter中央包管理轉(zhuǎn)換器是一款把大型 .NET 解決方案一鍵遷移到 Centralised Package ManagementCPM集中式包管理的 dotnet 命令行工具。它最核心的看家本領(lǐng)就是對項目文件里千奇百怪的版本號進行智能解析——無論是普通版本號、MSBuild 版本變量還是方括號包裹的固定版本都能一一識別并優(yōu)雅處理。本文帶你直擊PackageVersion.cs與Versioning.cs源碼用最通俗的方式搞懂它的版本解析機制新手也能輕松看懂。 CentralisedPackageConverter 是什么一個命令搞定 CPM 遷移在 NuGet 的集中式包管理CPM模式下所有項目的包版本被統(tǒng)一收攏到根目錄的Directory.Packages.props文件中項目文件里只保留包引用、不再寫版本號。好處是版本一目了然、升級一處生效但手動遷移幾十上百個項目文件無疑是災(zāi)難。CentralisedPackageConverter 正是為此而生掃描目錄樹下的全部.csproj、.fsproj等工程文件收集版本引用刪除項目文件里的 Version 屬性再把PackageVersion條目寫入集中的Directory.Packages.props。它還支持反向回退revert一條命令即可把 CPM 還原為傳統(tǒng)寫法。 版本解析源碼在哪三大核心文件一目了然要理解版本解析只需關(guān)注工程根目錄下這幾個文件PackageVersion.cs版本解析的核心負責(zé)把字符串解析成三種形態(tài)之一Versioning.cs版本選擇策略決定沖突時取最大還是最小版本PackageConverter.cs解析后的落盤邏輯重寫工程文件并生成Directory.Packages.props對應(yīng)地測試目錄下的 VersioningTests.cs 用大量用例把各種邊界情況覆蓋得明明白白是理解源碼行為的最佳說明書。 三種版本形態(tài)普通版本號、變量與固定版本PackageVersion類通過TryParse方法把版本字符串分成三類普通版本號如8.0.3交給 NuGet 的NuGetVersion解析版本變量形如$(MyVersion)即 MSBuild 屬性引用原樣保留固定版本形如[1.0.0]方括號表示精確鎖定此版本解析時去掉方括號并打上固定標(biāo)記其中變量和固定版本是很多工具容易忽略的細節(jié)CentralisedPackageConverter 卻處理得相當(dāng)細致。 變量版本$(...)是如何被原樣保留的源碼中判斷變量版本的方式非常巧妙只要值里包含$(就直接認(rèn)定為變量把整個字符串存入VariableName不做任何數(shù)字解析。if (value.Contains($()) { version new PackageVersion { VariableName value }; return true; }這意味著像Version$(PackageVersion)這樣的引用不會被誤傷遷移后變量引用依舊保留項目構(gòu)建行為完全不變。類里還有個IsVariable屬性配合 Versioning.cs 中的PreferExisting邏輯保證變量版本優(yōu)先于普通數(shù)字版本避免被其它項目的數(shù)字版本覆蓋。 固定版本[1.0.0]是如何識別的固定版本在 NuGet 中表示嚴(yán)格等于該版本。源碼用了一段非常高效的 Span 操作先Trim()去掉首尾空白檢查首字符是[且末字符是]滿足則去掉方括號、標(biāo)記IsFixedVersion true再交給NuGetVersion.TryParse校驗數(shù)字部分var span value.AsSpan().Trim(); if (span.Length 2 span[0] [ span[^1] ]) { value span.Slice(1, span.Length - 2).ToString(); isFixed true; }解析成功后ToFullString()會把方括號原樣加回來確保寫入Directory.Packages.props時語義不丟失。測試用例 TestFixedVersion 驗證了[1.0.0]會被完整保留。?? 多項目版本沖突怎么辦最大版本與最小版本策略大型解決方案里同一個包在不同項目可能有不同版本。CentralisedPackageConverter 默認(rèn)取最大版本因為高版本通常兼容低版本也可以通過-v參數(shù)切換為取最小版本。對應(yīng)邏輯在 Versioning.cs 的PreferExisting方法中用 NuGet 官方的VersionComparer比較新舊版本默認(rèn)策略是新版本 已存在版本時保留新版本。測試用例 VersioningPickRegular 展示了從 0.0.0 到 10.1.11 六個版本中正確選出 10.1.11 的過程。 預(yù)發(fā)布版本與版本比較模式細節(jié)控的福音針對預(yù)發(fā)布版本如2.0.0-beta工具提供兩個貼心開關(guān)-p/--ignore-prerelease完全忽略預(yù)發(fā)布版本-c/--version-comparison選擇版本比較時考慮的組成部分支持四種模式Default標(biāo)準(zhǔn)規(guī)則正式版優(yōu)先于預(yù)發(fā)布版Version只看主次修訂號VersionRelease連同預(yù)發(fā)布標(biāo)簽一起比較VersionReleaseMetadata連構(gòu)建元數(shù)據(jù)metadata也納入比較源碼中IgnorePackageVersion方法配合Comparer即VersionComparer實現(xiàn)這一策略而 VersioningTests.cs 里的VersioningByPrerelease、VersioningByMetadata用例把每種模式的輸出結(jié)果都固定了下來行為一目了然。? 版本號隱式補全8 就是 8.0.0CentralisedPackageConverter 還有一個貼心的細節(jié)NuGet 支持省略版本位8、8.0、8.0.0三者等價。工具的解析邏輯天然繼承了這一特性項目里寫Version8也能正常識別不會因為位數(shù)不齊而報錯或跳過。 一句話總結(jié)CentralisedPackageConverter 的版本解析之所以優(yōu)雅在于它把三類版本形態(tài)數(shù)字、變量、固定分層處理再配合可配置的版本選擇策略把集中式包管理的遷移做成了零心智負擔(dān)的一鍵操作。想深入研究的讀者直接打開PackageVersion.cs和Versioning.cs這兩個文件配上VersioningTests.cs的測試用例半小時就能吃透全部邏輯。如果你正為大型解決方案的 CPM 遷移發(fā)愁不妨親自跑一遍這個工具體會一下什么叫潤物細無聲?！久赓M下載鏈接】CentralisedPackageConverterConverts a project to use Centralised Package Management項目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考