VersioningDemos

版本控制演示

使用和不使用持续部署 (CD) 的 .NET Core 项目版本控制方法示例

如果您克隆此站点并在调试和发布模式下在本地运行它，您将看到不同的结果。您可以访问 https://versioningdemos.azurewebsites.net/ 上的实时版本，该版本已通过我的 Git 和 VSTS 生成版本信息。

您会注意到，Microsoft 在自己的 .Net 库中具有不同的版本控制策略，可能不是来自同一团队。

.NET Core 程序集中通常引用 3 个版本

• 文件版本 - 用于查看哪个 DLL 较晚。
  • 它的模式xybr通常被认为是 Major.Minor.Build.Revision
• 产品版本 - 也称为程序集中的信息版本。这是用于描述目的的自由格式文本版本。
  • 目前其格式倾向于遵循语义版本控制模式（由 GitHub 提出）
  • xyp-buildinfo主要.次要.补丁[-元数据]
  • 您可以在 semver.org 上阅读更多内容
• 程序集版本 - 程序集的版本

您看到的用于检索版本信息的常规方法仅适用于某些用例，并且在放入库中时会崩溃。

版本示例项目

所有这些项目都使用 .vbproj（也可能是 .csproj）文件，而不是以前使用 AssemblyInfo.cs 或 project.json 的技术

未设置任何内容 - 默认

• 默认为 1.0.0

设置值 - 手动

使用 Visual Studio UI（项目属性/包）

• 即使您不使用它来设置信息，它也会显示计算值
• 请小心，不要意外覆盖其他地方计算的值
• 编辑<project>.csproj

设置所有值 - Manual.AllDifferent

• 使用 Visual Studio 用户界面
• 编辑<project>.csproj

只需使用 VersionPrefix - VersionPrefix

版本后缀 - 版本后缀

构建修订版 - 构建修订版

• 通过实现 roslyn 的版本模式逻辑来复制构建和修订通配符
• 使用 csproj 文件中的计算

构建日期时间 - 构建日期时间

• 使用 x.YYYY.MDD.HHMM 创建自动值

Visual Studio 团队服务构建 - VSTS

• 将配置的 BUILDNUMBER 从 VSTS 添加到 VersionSuffix

使用 Git 分支构建 Visual Studio Team Services - VSTS.WithGit

• 将 Git 分支添加到版本后缀

标签助手

使用 Taghelpers 时有几个问题。

• 页面最终被放置到与您预期不同的程序集中
• 在调试或发布中运行可能会给出不同的值和创建的程序集
• 将 TagHelper 放入外部库中会更改当前运行的程序集的结果