Как включить XML-документы для библиотеки классов в пакет NuGet?

Question 1

Я создаю пакет NuGet для библиотеки классов C #, и я хотел бы включить сгенерированную документацию Xml в библиотеку. Это мой файл NUSPEC:

<?xml version="1.0" encoding="utf-8"?>
<package>
  <metadata>
    <id>MyLibrary</id>
    <version>1.0.0.0</version>
    <authors>John Nelson</authors>
    <language>en-US</language>
    <description>A C# class library</description>
  </metadata>
  <files>
    <file src="..\..\build\MyLibrary.dll" target="lib\Net40" />
    <file src="..\..\build\MyLibrary.xml" target="lib\Net40" />
  </files>
</package>

Когда я создаю пакет с помощью этой команды :

nuget pack MyLibrary.nuspec

Выдает ошибку. Если я удалю строку:

<file src="..\..\build\MyLibrary.xml" target="lib\Net40" />

NuGet.exe успешно создает файл nupkg. Я даже могу разархивировать пакет и проверить правильность содержимого. Что я делаю не так? Должен ли XML-файл перейти в другой целевой каталог?

Question 2

Проблема заключалась в том, что я не проверял «Создать XML-документацию» для конфигурации сборки, которую я использовал. Этот Nuspec правильный.

введите описание изображения здесь

Question 3

В .NET Core / Standard вы можете сделать это, отредактировав XML-файл проекта, например:

<PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>

<PropertyGroup>
    <DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile>
</PropertyGroup>

Это выведет документацию в виде файла XML рядом с вашей выходной сборкой.

РЕДАКТИРОВАТЬ: В качестве примечания, как только вы включите, GenerateDocumentationFileвы, вероятно, получите множество предупреждений о своих общедоступных методах за то, что не добавили полные теги документации. Если вы хотите отключить эти предупреждения, просто добавьте PropertyGroup:

<NoWarn>$(NoWarn);1591</NoWarn>