c#-.NET分析器:程序包版本与程序集版本

如下图所示,当使用VS 2017创建带有代码修复(.NET Standard)的Analyzer类型的项目时,在项目的属性选项卡中有程序包版本,程序集版本和程序集文件版本.

c#-.NET分析器:程序包版本与程序集版本

这3个版本是否相互关联?另外,当我在项目中进行更改时,应该如何更改版本号?例如,如果我修复了错误,添加了新规则等.

解决方法:

Are those 3 versions related together or not? Also, as I make changes in the project how am I supposed to change the versions number? For instance, if I fix a bug, if I add a new rule, etc.

在回答这个问题之前,我们需要了解一些有关AssemblyVersion和AssemblyFileVersion的信息.

Assembly Version: This is the version that .Net looks at during run-time for loading packages and finding types.

Assembly File Version: This defines the version reported by the OS to other applications like Windows Explorer.

您可以查看Rémy van Duijkeren`s answer了解更多详细信息.

但是,NuGet不使用这两种方法.它使用第三个版本控制属性:AssemblyInformationalVersion-程序集的产品版本.

它使用此属性,因为似乎没有其他人关心它.操作系统或.Net没有使用该信息版本,这意味着NuGet可以使用它.但是此版本控制属性已在AssemblyInfo.cs文件中删除,因为它们不适用于语义版本控制.

当您使用VS 2017使用代码修复(.NET Standard)使用分析器类型的项目时,这些属性设置已移至.csproj文件中.默认情况下,它们不会显示,但是您可以从Visual Studio 2017的项目属性“程序包”选项卡中找到它们:

c#-.NET分析器:程序包版本与程序集版本

保存后,可以在MyProject.csproj中找到这些值:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net461</TargetFramework>
    <Version>1.2.3.4</Version>
    <Authors>Author 1</Authors>
    <Company>Company XYZ</Company>
    <Product>Product 2</Product>
    <PackageId>MyApp</PackageId>
    <AssemblyVersion>2.0.0.0</AssemblyVersion>
    <FileVersion>3.0.0.0</FileVersion>
    <NeutralLanguage>en</NeutralLanguage>
    <Description>Description here</Description>
    <Copyright>Copyright</Copyright>
    <PackageLicenseUrl>License URL</PackageLicenseUrl>
    <PackageProjectUrl>Project URL</PackageProjectUrl>
    <PackageIconUrl>Icon URL</PackageIconUrl>
    <RepositoryUrl>Repo URL</RepositoryUrl>
    <RepositoryType>Repo type</RepositoryType>
    <PackageTags>Tags</PackageTags>
    <PackageReleaseNotes>Release</PackageReleaseNotes>
  </PropertyGroup>

在文件资源管理器属性信息选项卡中,版本显示为“产品版本”,供NuGet使用.就像版本控制属性:AssemblyInformationalVersion.

因此,如果您修复了错误或添加了新规则,则可以更改软件包版本以运送新软件包.

major is incremented for a breaking change, minor for a change that
is backwards compatible and patch for bug fixes.

至于是否需要修改程序集版本的版本号,请参考this document了解更多详细信息.

希望这可以帮助.

上一篇:发布程序包到Nuget


下一篇:.NET加水印/验证码的NuGet包