ASP.NET Core не создает файл комментариев XML

Question

Я использую документацию Swashbuckle для Api, для которой требуется файл projectname.xml из вывода, но когда я создаю проект ASP.NET Core, я не получаю этот файл.

https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger

Visual Studio имеет возможность создания файла XML, но как я могу это сделать из консоли?

Вот мой ASP.NET Основная версия:

.NET Command Line Tools (1.0.0-preview2-1-003177) 

Answer 1

Для Visual Studio 2017 и CLI dotnet установка свойства DocumentationFile в файле .csproj приведет к созданию документации XML по указанному пути относительно файла проекта. Например, для создания XML-документа в том же каталоге, что и построенные сборок, вы можете добавить следующую группу свойств в файл проект:

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

Если вы хотите только он построил для конкретных конфигураций и платформ, убедитесь, для установки подходящего Condition в группе свойств.

Answer 2

Если вы все еще используете Visual Studio 2015, вы можете сделать это в project.json путем добавления xmlDoc к buildOptions

"buildOptions": { 
    "xmlDoc": true, 
} 

Visual Studio 2017 (структура * .csproj) Я не уверен. Но когда вы установите его через Visual Studio, он будет сохранен в файле csproj/project.json.