#asp.net-web-api #asp.net-core #swagger #swagger-ui
#asp.net-web-api #asp.net-core #развязность #swagger-пользовательский интерфейс
Вопрос:
У меня есть API-сервис для движка моего блога. Я интегрировал документацию OpenAPI с swagger в свой API, но в итоге столкнулся с довольно специфической проблемой, с моей точки зрения. В корневом каталоге проекта есть файл под названием APIService.xml , который на самом деле является спецификациями xml-документа. Этот API развертывается в Azure через конвейеры Azure CI / CD. API успешно развернут, однако, когда я пытаюсь запустить этот api, этого не происходит, потому что он на самом деле ищет apiservice.xml следовательно, файл не удалось запустить, поскольку указанный файл не будет включен в проект. Изначально я думал, что это может быть проблема с конвейерами Azure DevOps, поэтому я попытался опубликовать его локально, но файла там нет, что означает, что он не публикуется / не включается в проект при публикации. Я пытался добавить его вручную в консоль Kudu, но это ничего не добавит. Каков способ добавить этот файл при публикации? есть ли какие-либо настройки, на которые я должен обратить внимание.
Спасибо!!
Ответ №1:
Спасибо, ребята, я исправил это, добавив один параметр liner в мой файл csproj:-
<PropertyGroup>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
</PropertyGroup>
Однако мне довольно любопытно, зачем мне нужно добавлять эту дополнительную строку без необходимости, разве такие файлы не должны добавляться автоматически при публикации, где это необходимо для запуска проекта.
Спасибо!!
Комментарии:
1. Как вы думаете, следует
dotnet
узнать, нужна ли документация xml для запуска проекта?2. Поскольку мой файл csproj уже добавлен с помощью:- <DocumentationFile>APIService.xml </DocumentationFile> тогда зачем мне вводить дополнительные строки, почему не следует Asp.Net Ядро поймет строку и сделает все, что требуется, — это моя точка зрения. Я уже говорил о своем asp.net основной проект, который мой apiservice.xml это мой файл документации, поэтому давайте добавим этот файл, но, к сожалению, он не понимает.