Как файлы комментариев Swagger XML включены в основной сервер ASP.NET?

Question

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

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

Что делать при публикации на сервере?

var xmlFile = "${System.Reflection.Assembly.GetExecutingAssembly().GetName().Name}.xml";
c.IncludeXmlComments(System.IO.Path.Combine(AppContext.BaseDirectory, xmlFile));

Answer 1

Для генерации XML-документации из комментариев к коду. Вам нужно будет открыть свойства проекта для всех ваших проектов, перейти на вкладку Build и проверить XML-файл документации . Это обеспечит создание документа XML в указанном месте. Вы захотите использовать относительный путь для выходного каталога.