Задача UpdateManifestForBrowserApplication

Статья
06/09/2015

Выполнение задачи UpdateManifestForBrowserApplication для добавления элемента <hostInBrowser /> в манифест приложения (имя_проекта.exe.manifest) после построения проекта XBAP (XAML browser application — приложение браузера XAML).

Параметры задачи

Параметр	Описание
ApplicationManifest	Обязательный параметр ITaskItem[]. Задание пути и имени для файла манифеста приложения, который необходимо добавить в элемент <hostInBrowser />.
HostInBrowser	Обязательный параметр Boolean. Настройка изменения манифеста приложения для добавления в него элемента <hostInBrowser />. Если задано значение true, в элемент <entryPoint /> включается новый элемент <hostInBrowser />. Обратите внимание, что включение элемента является совокупным: если элемент <hostInBrowser /> уже существует, то он не удаляется и не перезаписывается. Вместо этого создается дополнительный элемент <hostInBrowser />. Если задано значение false, манифест приложения не изменяется.

ApplicationManifest

Обязательный параметр ITaskItem[].

Задание пути и имени для файла манифеста приложения, который необходимо добавить в элемент <hostInBrowser />.

HostInBrowser

Обязательный параметр Boolean.

Настройка изменения манифеста приложения для добавления в него элемента <hostInBrowser />. Если задано значение true, в элемент <entryPoint /> включается новый элемент <hostInBrowser />. Обратите внимание, что включение элемента является совокупным: если элемент <hostInBrowser /> уже существует, то он не удаляется и не перезаписывается. Вместо этого создается дополнительный элемент <hostInBrowser />. Если задано значение false, манифест приложения не изменяется.

Заметки

XBAP выполняются с помощью развертывания ClickOnce и поэтому должны быть опубликованы с соответствующими манифестами развертывания и приложения. MSBuild (Microsoft build engine) использует задачу GenerateApplicationManifest для создания манифеста приложения.

После этого для настойки приложения, которое можно запускать из браузера, в манифест приложения необходимо добавить дополнительный элемент <hostInBrowser />, как показано в следующем примере:

<!--MyXBAPApplication.exe.manifest-->
<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly ... >
    <asmv1:assemblyIdentity ... />
    <application />
    <entryPoint>
      ...
      <hostInBrowser xmlns="urn:schemas-microsoft-com:asm.v3" />
    </entryPoint>
  ...
/>

Задача UpdateManifestForBrowserApplication выполняется при построении проекта XBAP для добавления элемента <hostInBrowser />.

Пример

В следующем примере демонстрируется, как можно обеспечить добавление элемента <hostInBrowser /> в файл манифеста приложения.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask 
    TaskName="Microsoft.Build.Tasks.Windows.UpdateManifestForBrowserApplication"
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="UpdateManifestForBrowserApplicationTask">
    <UpdateManifestForBrowserApplication
      ApplicationManifest="MyXBAPApplication.exe.manifest"
      HostInBrowser="true" />
  </Target>
</Project>