显示 NuGet 包发行说明

Question

nuspec 参考文献介绍了releaseNotes标签

v1.5 软件包每个版本中所做更改的描述。仅当选择 Updates 选项卡且该软件包是先前安装的软件包的更新时，才会显示此字段。它显示在通常显示说明的位置。

我创建了两个 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

打开“管理 NuGet 包”对话框，则会显示发行说明。
但当我从

solution

打开它时却没有。

我自己的包以及 nuget.org 的行为是相同的

Answer 2

截至 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>

Answer 3

此问题已在有关 VS2015 的 NuGet 存储库中进行跟踪。

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

Answer 4

截至 2024 年 1 月 16 日，这在 VS 2022 中仍然是一个问题。