asp.net webapi публікація - файли xml не копіюються

У мене є проект MVC 4.0 WebApi з автоматично створеною довідкою на основі цього .

Мої моделі класів зберігаються це ще один проект у моєму рішенні. Генерація файлу xml увімкнена для кожного проекту (Властивості проекту -> Збірка -> Вихід -> Файл документації XML - Увімкнено).

У локальній налагодженні все нормально - файли xml копіюються в каталог проектів, і я бачу коментарі до полів / класів з інших проектів.

Але коли я використовую профіль публікації (у папку), файли xml не копіюються у вихідну папку. Копіюється лише один файл xml з основного проекту WebApi. Тому я не бачу коментарів до занять з інших проектів.

У мене було подібне питання, для мене відповідь була трохи "дох!" момент.

У налаштуваннях проекту я ввімкнув файл документації XML лише під конфігурацією налагодження, а не під Release. Я використовував Release, і тому документація XML фактично не генерувалася. Тож виправлення переконалося, що ввімкнуло документацію XML як для налагодження, так і для випуску.

Ви можете зробити це двома різними способами:

1) Перейдіть до властивості вашого проекту -> виберіть варіант збірки -> поставте галочку біля «Файл документації XML» -> додайте шлях «App_data \ XMLDocument.xml» -> налаштування збереження, побудуйте свій проект -> включіть свій XMLDocument. файл xml -> вибрати властивість -> скопіювати у вихідний каталог -> вибрати "Копіювати завжди"

2) Перейдіть до властивості вашого проекту -> виберіть опцію «Пакування / Публікація в Інтернеті» -> елементи для відображення -> виберіть зі спадного меню «всі файли в цьому проекті»

У мене була та сама проблема, що було розгорнуто лише файл xml із проекту webapi.

Щоб це виправити, мені довелося додати це до мого файлу проекту Web (Api), у межах першого PropertyGroupелемента.

<ExcludeXmlAssemblyFiles>false</ExcludeXmlAssemblyFiles>

Після цього було опубліковано документацію xml-файлів усіх проектів (де це включено) !

Я зміг вирішити це, використовуючи лише власну ціль MSBuild у профілі публікації .pubxml файлі . Виконайте наведені нижче дії.

Кінцевим результатом є те, що ціль MSBuild скопіює всі .xmlфайли з папки bin Web API в папку bin, де ви публікуєте. Не потрібно копіювати ці файли в App_Data.

1) Відкрийте відповідний .pubxmlфайл із [Project Folder]\Properties\PublishProfiles.

2) Додайте цей фрагмент до <Project><PropertyGroup>тегу:

<CopyAllFilesToSingleFolderForPackageDependsOn>
  CustomCollectFiles;
  $(CopyAllFilesToSingleFolderForPackageDependsOn);
</CopyAllFilesToSingleFolderForPackageDependsOn>

<CopyAllFilesToSingleFolderForMsdeployDependsOn>
  CustomCollectFiles;
  $(CopyAllFilesToSingleFolderForMsdeployDependsOn);
</CopyAllFilesToSingleFolderForMsdeployDependsOn>

3) Додайте цей фрагмент після <PropertyGroup>тегу:

      <Target Name="CustomCollectFiles">
        <ItemGroup>
          <_CustomFiles Include="bin\*.xml" />

          <FilesForPackagingFromProject  Include="%(_CustomFiles.Identity)">
            <DestinationRelativePath>bin\%(Filename)%(Extension)</DestinationRelativePath>
          </FilesForPackagingFromProject>
        </ItemGroup>
      </Target>

Заслуга належить цій відповіді, яка стосувалася способу включення файлів, що не входять до каталогу проекту, під час публікації.

Відкрийте свій файл публікації (* .pubxml) і включіть цей код в елемент "Проект":

<ItemGroup>
    <Content Include="bin\yourDocumentationFile.xml">
        <CopyToOutputDirectory>true</CopyToOutputDirectory>
    </Content>
    <!-- Include a content to each documentation file -->
</ItemGroup>

Один із способів - це додати файли XML до папки " App_Data " всередині проекту, а потім у візуальній студії вибрати файл до його властивості " Копіювати до каталогу Ouput " до " Завжди ".

Доповнюючи попередню відповідь, є також інший тип тегу, як і стаття нижче:

https://www.asp.net/mvc/overview/deployment/visual-studio-web-deployment/deploying-extra-files

Тег:

<CopyAllFilesToSingleFolderForMsdeployDependsOn>
  CustomCollectFiles;
  $(CopyAllFilesToSingleFolderForMsdeployDependsOn);
</CopyAllFilesToSingleFolderForMsdeployDependsOn>

Якщо ваш сайт використовує профіль публікації (наприклад, якщо ви завантажили його від свого постачальника послуг Інтернету), вам потрібно переконатися, що для наступної опції встановлено значення False

<ExcludeApp_Data>False</ExcludeApp_Data>

Властивості файлу XML можна встановити так: Дія побудови - Вміст, Копіювати у вихідний каталог - Завжди

Але якщо для параметра опублікування для параметра вище вказано значення True, тоді ваш XML-файл ніколи не буде опублікований. Навчився цього важким шляхом.

Якщо ви не хочете Файл документації, перейдіть до HelpPageConfig.cs і залиште коментар

config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")))