显示 NuGet 包发行说明

Question

nuspec reference 提到了 releaseNotes 标签

v1.5 A description of the changes made in each release of the package. This field only shows up when the Updates tab is selected and the package is an update to a previously installed package. It is displayed where the Description would normally be displayed.

我创建了两个 nuspec 文件，都包含（当然有不同的 version 标签）

<?xml version="1.0"?>
<package >
  <metadata>
    <id>TestReleaseNotes</id>
    <version>1.0</version>
    <authors>adrianm</authors>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>Description</description>
    <releaseNotes>Release notes</releaseNotes>
  </metadata>
  <files>
    <file src="Test.cs" target="content" />
  </files>
</package>

我在 VS2013 中安装了 1.0 并选择了更新选项卡，但我看不到发行说明。

我错过了什么？

Answer 1

这是我自己发现的。

如果我从 project 打开 "Manage NuGet packages" 对话框，则会显示发行说明。
但当我从 solution.

打开它时却没有

我自己的包和 nuget.org

的行为相同

Answer 2

有关 VS2015 的 NuGet 存储库中跟踪了此问题。

https://github.com/NuGet/Home/issues/1823

Answer 3

截至 2021 年 3 月，这似乎仍然是 Visual Studio 2019 年的一个问题。我们使用 Azure 在内部发布了许多 nuget 包。包发行说明显示在 Azure UI 但不在 Visual Studio 中。但是，“描述”确实出现在 Visual Studio 中，因此我调整了描述以包含发行说明。这实际上来自 Directory.build.props 文件，但同样可以嵌入到项目文件中：

        <PackageReleaseNotes>
Release notes added to .nuspec file as <Release Notes> and also to end of Description
        </PackageReleaseNotes>
        <!-- Don't indent text, it makes it hard to read in the nuget package manager-->
        <Description>
Description:
This is the description of our internally produced nuget package

Release Notes:$(PackageReleaseNotes)
        </Description>

显示 NuGet 包发行说明

Show NuGet package release notes

nuget

nuspec

visual-studio-2013