c# - 各种 MSBuild 版本属性(例如 Version、VersionPrefix 和 VersionSuffix)之间有什么区别？

Question

使用 MSBuild 15 和 Microsoft.NET.Sdk 构建项目允许用户指定六个版本属性。它们之间的区别是什么？正确的使用方法是什么？

• 版本
• 版本前缀
• 版本后缀
• 程序集版本
• 文件版本
• 包版本

需要明确的是，我所说的“属性”是在文件中定义的 MSBuild 属性(如下所示)

<PropertyGroup>
   <Version>1.2.0</Version>
</PropertyGroup>

...或在命令行上作为 msbuild.exe/p:Version=1.2.0

Answer 1

此外，显式设置这些值将覆盖默认值。

版本前缀

格式: major.minor.patch

示例:14.2.4、0.1.0、99.99.99

含义:semver版本号的正常部分。这用于确定 Version 值的开头。

默认值:“1.0.0”

版本后缀

格式:[0-9A-Za-z-.]*(任意字符串)

示例:alpha、beta、build0123、rc4-build201701、rc.1、rc-1

含义:版本号的预发布标签。用于确定 Version 值的结尾。

默认:(空)

版本

格式: major.minor.patch[-prerelease]

示例:5.3.9-beta、0.0.1-alpha-01、0.0.1-alpha.1、2.0.0

含义:该属性是用户项目中最常用的属性。其他版本属性将此值视为默认值。它还用于生成 System.Reflection.AssemblyInformationalVersionAttribute 的值。预发布值是可选的。

默认值: VersionPrefix 如果 VersionSuffix 为空。 VersionPrefix-VersionSuffix 如果 VersionSuffix 不为空。

注意:显式设置 Version 将覆盖任何 VersionPrefix 或 VersionSuffix 设置。

此外，这通常遵循 SemVer 规则。参见 http://semver.org/详情

包版本

格式: major.minor.patch[-prerelease]

含义:用于在从 MSBuild 项目生成 NuGet 包时生成包版本。

默认:匹配版本

程序集版本

格式: major.minor.patch.revision

示例:4.5.6.2、1.0.0.0

含义:用于生成 System.Reflection.AssemblyVersionAttribute 的值。编译器使用它来确定最终的 AssemblyVersion 值，这是程序集标识的重要部分。参见 https://msdn.microsoft.com/en-us/library/51ket42z(v=vs.110).aspx#Anchor_0

默认:匹配没有预发布标签的版本。

文件版本

格式 major.minor.patch.buildnumber

示例:1.0.0.43952、0.1.0.0

含义:用于生成System.Reflection.AssemblyFileVersionAttribute的值。这不需要匹配 AssemblyVersion。向该版本添加内部版本号是很常见的。

默认:匹配AssemblyVersion

信息版本

格式:任意

含义:用于生成System.Reflection.AssemblyInformationalVersionAttribute的值。此属性可以包含任何其他版本信息。

默认:匹配版本