CentralisedPackageConverter版本解析源码探秘如何优雅处理版本号、变量与固定版本【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverterCentralisedPackageConverter中央包管理转换器是一款把大型 .NET 解决方案一键迁移到 Centralised Package ManagementCPM集中式包管理的 dotnet 命令行工具。它最核心的看家本领就是对项目文件里千奇百怪的版本号进行智能解析——无论是普通版本号、MSBuild 版本变量还是方括号包裹的固定版本都能一一识别并优雅处理。本文带你直击PackageVersion.cs与Versioning.cs源码用最通俗的方式搞懂它的版本解析机制新手也能轻松看懂。 CentralisedPackageConverter 是什么一个命令搞定 CPM 迁移在 NuGet 的集中式包管理CPM模式下所有项目的包版本被统一收拢到根目录的Directory.Packages.props文件中项目文件里只保留包引用、不再写版本号。好处是版本一目了然、升级一处生效但手动迁移几十上百个项目文件无疑是灾难。CentralisedPackageConverter 正是为此而生扫描目录树下的全部.csproj、.fsproj等工程文件收集版本引用删除项目文件里的 Version 属性再把PackageVersion条目写入集中的Directory.Packages.props。它还支持反向回退revert一条命令即可把 CPM 还原为传统写法。 版本解析源码在哪三大核心文件一目了然要理解版本解析只需关注工程根目录下这几个文件PackageVersion.cs版本解析的核心负责把字符串解析成三种形态之一Versioning.cs版本选择策略决定冲突时取最大还是最小版本PackageConverter.cs解析后的落盘逻辑重写工程文件并生成Directory.Packages.props对应地测试目录下的 VersioningTests.cs 用大量用例把各种边界情况覆盖得明明白白是理解源码行为的最佳说明书。 三种版本形态普通版本号、变量与固定版本PackageVersion类通过TryParse方法把版本字符串分成三类普通版本号如8.0.3交给 NuGet 的NuGetVersion解析版本变量形如$(MyVersion)即 MSBuild 属性引用原样保留固定版本形如[1.0.0]方括号表示精确锁定此版本解析时去掉方括号并打上固定标记其中变量和固定版本是很多工具容易忽略的细节CentralisedPackageConverter 却处理得相当细致。 变量版本$(...)是如何被原样保留的源码中判断变量版本的方式非常巧妙只要值里包含$(就直接认定为变量把整个字符串存入VariableName不做任何数字解析。if (value.Contains($()) { version new PackageVersion { VariableName value }; return true; }这意味着像Version$(PackageVersion)这样的引用不会被误伤迁移后变量引用依旧保留项目构建行为完全不变。类里还有个IsVariable属性配合 Versioning.cs 中的PreferExisting逻辑保证变量版本优先于普通数字版本避免被其它项目的数字版本覆盖。 固定版本[1.0.0]是如何识别的固定版本在 NuGet 中表示严格等于该版本。源码用了一段非常高效的 Span 操作先Trim()去掉首尾空白检查首字符是[且末字符是]满足则去掉方括号、标记IsFixedVersion true再交给NuGetVersion.TryParse校验数字部分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 默认取最大版本因为高版本通常兼容低版本也可以通过-v参数切换为取最小版本。对应逻辑在 Versioning.cs 的PreferExisting方法中用 NuGet 官方的VersionComparer比较新旧版本默认策略是新版本 已存在版本时保留新版本。测试用例 VersioningPickRegular 展示了从 0.0.0 到 10.1.11 六个版本中正确选出 10.1.11 的过程。 预发布版本与版本比较模式细节控的福音针对预发布版本如2.0.0-beta工具提供两个贴心开关-p/--ignore-prerelease完全忽略预发布版本-c/--version-comparison选择版本比较时考虑的组成部分支持四种模式Default标准规则正式版优先于预发布版Version只看主次修订号VersionRelease连同预发布标签一起比较VersionReleaseMetadata连构建元数据metadata也纳入比较源码中IgnorePackageVersion方法配合Comparer即VersionComparer实现这一策略而 VersioningTests.cs 里的VersioningByPrerelease、VersioningByMetadata用例把每种模式的输出结果都固定了下来行为一目了然。➕ 版本号隐式补全8 就是 8.0.0CentralisedPackageConverter 还有一个贴心的细节NuGet 支持省略版本位8、8.0、8.0.0三者等价。工具的解析逻辑天然继承了这一特性项目里写Version8也能正常识别不会因为位数不齐而报错或跳过。 一句话总结CentralisedPackageConverter 的版本解析之所以优雅在于它把三类版本形态数字、变量、固定分层处理再配合可配置的版本选择策略把集中式包管理的迁移做成了零心智负担的一键操作。想深入研究的读者直接打开PackageVersion.cs和Versioning.cs这两个文件配上VersioningTests.cs的测试用例半小时就能吃透全部逻辑。如果你正为大型解决方案的 CPM 迁移发愁不妨亲自跑一遍这个工具体会一下什么叫润物细无声。【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CentralisedPackageConverter版本解析源码探秘：如何优雅处理版本号、变量与固定版本
CentralisedPackageConverter版本解析源码探秘如何优雅处理版本号、变量与固定版本【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverterCentralisedPackageConverter中央包管理转换器是一款把大型 .NET 解决方案一键迁移到 Centralised Package ManagementCPM集中式包管理的 dotnet 命令行工具。它最核心的看家本领就是对项目文件里千奇百怪的版本号进行智能解析——无论是普通版本号、MSBuild 版本变量还是方括号包裹的固定版本都能一一识别并优雅处理。本文带你直击PackageVersion.cs与Versioning.cs源码用最通俗的方式搞懂它的版本解析机制新手也能轻松看懂。 CentralisedPackageConverter 是什么一个命令搞定 CPM 迁移在 NuGet 的集中式包管理CPM模式下所有项目的包版本被统一收拢到根目录的Directory.Packages.props文件中项目文件里只保留包引用、不再写版本号。好处是版本一目了然、升级一处生效但手动迁移几十上百个项目文件无疑是灾难。CentralisedPackageConverter 正是为此而生扫描目录树下的全部.csproj、.fsproj等工程文件收集版本引用删除项目文件里的 Version 属性再把PackageVersion条目写入集中的Directory.Packages.props。它还支持反向回退revert一条命令即可把 CPM 还原为传统写法。 版本解析源码在哪三大核心文件一目了然要理解版本解析只需关注工程根目录下这几个文件PackageVersion.cs版本解析的核心负责把字符串解析成三种形态之一Versioning.cs版本选择策略决定冲突时取最大还是最小版本PackageConverter.cs解析后的落盘逻辑重写工程文件并生成Directory.Packages.props对应地测试目录下的 VersioningTests.cs 用大量用例把各种边界情况覆盖得明明白白是理解源码行为的最佳说明书。 三种版本形态普通版本号、变量与固定版本PackageVersion类通过TryParse方法把版本字符串分成三类普通版本号如8.0.3交给 NuGet 的NuGetVersion解析版本变量形如$(MyVersion)即 MSBuild 属性引用原样保留固定版本形如[1.0.0]方括号表示精确锁定此版本解析时去掉方括号并打上固定标记其中变量和固定版本是很多工具容易忽略的细节CentralisedPackageConverter 却处理得相当细致。 变量版本$(...)是如何被原样保留的源码中判断变量版本的方式非常巧妙只要值里包含$(就直接认定为变量把整个字符串存入VariableName不做任何数字解析。if (value.Contains($()) { version new PackageVersion { VariableName value }; return true; }这意味着像Version$(PackageVersion)这样的引用不会被误伤迁移后变量引用依旧保留项目构建行为完全不变。类里还有个IsVariable属性配合 Versioning.cs 中的PreferExisting逻辑保证变量版本优先于普通数字版本避免被其它项目的数字版本覆盖。 固定版本[1.0.0]是如何识别的固定版本在 NuGet 中表示严格等于该版本。源码用了一段非常高效的 Span 操作先Trim()去掉首尾空白检查首字符是[且末字符是]满足则去掉方括号、标记IsFixedVersion true再交给NuGetVersion.TryParse校验数字部分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 默认取最大版本因为高版本通常兼容低版本也可以通过-v参数切换为取最小版本。对应逻辑在 Versioning.cs 的PreferExisting方法中用 NuGet 官方的VersionComparer比较新旧版本默认策略是新版本 已存在版本时保留新版本。测试用例 VersioningPickRegular 展示了从 0.0.0 到 10.1.11 六个版本中正确选出 10.1.11 的过程。 预发布版本与版本比较模式细节控的福音针对预发布版本如2.0.0-beta工具提供两个贴心开关-p/--ignore-prerelease完全忽略预发布版本-c/--version-comparison选择版本比较时考虑的组成部分支持四种模式Default标准规则正式版优先于预发布版Version只看主次修订号VersionRelease连同预发布标签一起比较VersionReleaseMetadata连构建元数据metadata也纳入比较源码中IgnorePackageVersion方法配合Comparer即VersionComparer实现这一策略而 VersioningTests.cs 里的VersioningByPrerelease、VersioningByMetadata用例把每种模式的输出结果都固定了下来行为一目了然。➕ 版本号隐式补全8 就是 8.0.0CentralisedPackageConverter 还有一个贴心的细节NuGet 支持省略版本位8、8.0、8.0.0三者等价。工具的解析逻辑天然继承了这一特性项目里写Version8也能正常识别不会因为位数不齐而报错或跳过。 一句话总结CentralisedPackageConverter 的版本解析之所以优雅在于它把三类版本形态数字、变量、固定分层处理再配合可配置的版本选择策略把集中式包管理的迁移做成了零心智负担的一键操作。想深入研究的读者直接打开PackageVersion.cs和Versioning.cs这两个文件配上VersioningTests.cs的测试用例半小时就能吃透全部逻辑。如果你正为大型解决方案的 CPM 迁移发愁不妨亲自跑一遍这个工具体会一下什么叫润物细无声。【免费下载链接】CentralisedPackageConverterConverts a project to use Centralised Package Management项目地址: https://gitcode.com/gh_mirrors/ce/CentralisedPackageConverter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考