Включение сгенерированной XML-документации в пакет облачной службы Azure

РЕДАКТИРОВАТЬ: Обновлено, чтобы указать, что проблема возникает только при упаковке файла CSPKG облачной службы Azure.

У меня есть приложение ASP.NET Web API 2, которое действует как веб-роль в решении облачной службы Azure. Я хотел бы использовать страницы справки веб-API и использовать документы, созданные в формате XML, для их заполнения. У меня возникли проблемы с выяснением того, как включить XML-документацию в облачную упаковку Azure проекта Web Api.

XML-документация правильно попадает в каталог bin локально и при публикации в файловой системе, но отсутствует при проверке архива cspkg или каталога approot развернутых веб-ролей.

Есть ли способ заставить упаковку включать XML?


azure tfs asp.net-web-api msbuild xml-documentation
person RMD    schedule 03.10.2014    source источник
comment
Зачем вам XML-документация по экземпляру Azure?   -  person Peter Ritchie    schedule 04.10.2014
comment
Потому что я использую это для автоматически созданных справочных страниц веб-API.   -  person RMD    schedule 04.10.2014

Ответы (1)


arrow_upward
14
arrow_downward

Вы можете установить для ExcludeXmlAssemblyFiles значение false в PropertyGroup вашего проекта, чтобы принудительно включить все xml-файлы в пакет Azure:

<ExcludeXmlAssemblyFiles>false</ExcludeXmlAssemblyFiles>

person sm85    schedule 11.10.2014
comment
К сведению: мне пришлось добавить это в файл проекта веб-API. Добавление его в облачный проект не повлияло. Спасибо! - person RMD; 13.10.2014
comment
Мой не работает. Я вижу файл xml в папке bin, но его нет в папке approot. Я добавил этот тег в веб-проект. Любая помощь? - person Luís Deschamps Rudge; 10.04.2015
comment
Я добавил это в профиль публикации для моего проекта Web.API (в Properties\PublishProfiles\xxx.pubxml. Сработало, спасибо за помощь! - person Morgan Skinner; 03.02.2016
comment
Этот ответ не сработал для меня. В файле проекта ExcludeXmlAssemblyFiles уже имеет значение false. Странно то, что если я упакую файл, нажав на облачный проект в решении, XML будет включен, но когда я попытаюсь сделать это через командную строку с помощью MSBuild.exe, файл xml отсутствует. - person Jazaret; 18.03.2016
comment
Я был озадачен тем, почему это не работает и для меня, но потом я вспомнил, что у нас есть определения сборки наших серверов сборки, настроенные для передачи аргумента /p:AllowedReferenceRelatedFileExtensions=none в msbuild (как старый обходной путь для this), из-за чего XML-файл будет исключен независимо. - person Mike Asdf; 03.06.2016
comment
Искал час ... Добавление этого в профиль публикации сработало для меня! Спасибо - person jmenzel; 28.10.2016