Манифесты приложений для решений Office

  • Статья

Манифест приложения представляет собой XML-файл с описанием сборок, загружаемых в решении Microsoft Office. Средства разработки Microsoft Office в Visual Studio используют схему манифеста приложения ClickOnce, определенную в справочнике по манифесту приложения ClickOnce.

Манифесты приложений для решений Office используют следующие элементы и атрибуты ClickOnce.

Элемент Description Атрибуты
<Элемент assembly> (приложение ClickOnce) Обязательно. Это элемент верхнего уровня. manifestVersion
<Элемент assemblyIdentity> (Приложение ClickOnce) Обязательно. Определяет основную сборку приложения ClickOnce. name

version

Publickeytoken

processorArchitecture

language
<Элемент trustInfo> (приложение ClickOnce) Определяет требования к безопасности приложения. нет
<элемент entryPoint> (приложение ClickOnce) Обязательно. Определяет точку входа в код приложения для выполнения. name

dependencyName

customHostSpecified
<Элемент зависимостей> (приложение ClickOnce) Обязательно. Определяет все зависимости, необходимые для выполнения приложения. При необходимости определяет сборки, которые требуется установить предварительно. нет
<Элемент file> (Приложение ClickOnce) Обязательно. Определяет все не являющиеся сборками файлы, используемые приложением. Может включать данные изоляции модели COM, связанные с этим файлом. name

size

Манифесты приложений для решений Office имеют указанный ниже элемент в пространстве имен co.v1 .

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

Эти манифесты приложений также имеют в пространстве имен vstav3 указанные ниже элементы и атрибуты.

<addIn>
  <entryPointsCollection>
    <entryPoints>
      <entryPoint>
      </entryPoint>
    </entryPoints>
  </entryPointsCollection>
  <update></update>
  <postActions>
    <postAction>
      <postActionData>
      </postActionData>
    <postAction>
  </postActions>
  <application>
    <customizations>
      <customization>
      </customization>
    </customizations>
  </application
</addIn>
Элемент Description Атрибуты
<Элемент customHostSpecified> (разработка Office в Visual Studio) Обязательно. Помечает манифест как решение Office. нет
<элемент addin> (разработка Office в Visual Studio) Обязательно. Сохраняет точки входа в одном пространстве имен. нет
<элемент entryPointsCollection> (разработка Office в Visual Studio) Обязательно. Группирует все сборки для одного или нескольких решений Office. id
<элемент entryPoints> (разработка Office в Visual Studio) Обязательно. Группирует все сборки для запуска решения Office. нет
<элемент entryPoint> (разработка Office в Visual Studio) Обязательно. Указывает сборку, запускаемую в решении Office. class

Контракт
<Элемент update> (разработка Office в Visual Studio) Обязательно. Настраивает обновления для решения. enabled

expiration
<Элемент postActions> (разработка Office в Visual Studio) Необязательно. Группирует все действия, выполняемые после развертывания, которые запускаются после установки решений Office. нет
<Элемент postAction> (разработка Office в Visual Studio) Необязательно. Указывает действие, выполняемое после развертывания. нет
<Элемент postActionData> (разработка Office в Visual Studio) Необязательно. Настраивает данные для действия, выполняемого после развертывания. нет
<Элемент application> (разработка Office в Visual Studio) Обязательно. Инкапсулирует сведения о приложении в один узел. нет
<> Элемент настройки (разработка Office в Visual Studio) Обязательно. Сохраняет все сведения о ведущем приложении в отдельном пространстве имен. нет
<элемент настройки> (разработка Office в Visual Studio) Обязательно. Сохраняет сведения о ведущем приложении в отдельном пространстве имен. xmlns
<Элемент document> (разработка Office в Visual Studio) Является обязательным только для решений на уровне документа. Хранит сведения о настройках. solutionId
<элемент appAddin> (разработка Office в Visual Studio) Является обязательным только для решений на уровне приложения. Хранит сведения о настройках. application

Loadbehavior

keyName
<Элемент friendlyName> (разработка Office в Visual Studio) Необязательно. Хранит имя надстройки VSTO, которое будет отображаться в списке установленных надстроек VSTO. нет
<Элемент description> (разработка Office в Visual Studio) Требуется только для надстроек VSTO. Сохраняет описание, которое отображается в списке установленных программ. нет
<Элемент formRegions> (разработка Office в Visual Studio) Является обязательным только для надстроек VSTO для Outlook, включающих области форм. нет
<Элемент formRegion> (разработка Office в Visual Studio) Является обязательным только для надстроек VSTO для Outlook, включающих области форм. Имя
<элемент vstoRuntime> (разработка Office в Visual Studio) Обязательно. Указывает конкретную версию среды выполнения средств Visual Studio для Office, поддерживаемую решением Office. release

version

supportUrl

Замечания

Манифесты приложений и развертывания в решениях Office можно менять вручную. После этого необходимо повторно подписать манифесты приложения и развертывания с помощью Инструмент создания и изменения манифестов (mage.exe и mageui.exe). Для получения дополнительной информации см. Практическое руководство. Повторное подписание манифестов приложения и развертывания.

Расположение файла

Манифест приложения определяется для отдельной версии решения. По этой причине манифест приложения следует хранить отдельно от манифеста развертывания. Visual Studio помещает файлы, зависящие от версии, в подкаталоге "Файлы приложений" в подкаталоге публикации в подкаталоге "Файлы приложений".

Синтаксис имени файла

Имя файла манифеста приложения должно быть полным именем и расширением приложения, как указано в элементе assemblyIdentity , за которым следует расширение .manifest. Например, манифест приложения, ссылающийся на настройку OutlookAddIn1.dll , будет использовать следующий синтаксис имени файла.

OutlookAddIn1.dll.manifest

См. также