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

Статья
02/20/2013

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

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

Элемент	Описание	Атрибуты
Элемент <assembly> (приложение ClickOnce)	Обязательный.Элемент верхнего уровня.	manifestVersion
Элемент <assemblyIdentity> (приложение ClickOnce)	Обязательный.Определяет основную сборку приложения ClickOnce.	name version publicKeyToken processorArchitecture language
Элемент <trustInfo> (приложение ClickOnce)	Определяет требования безопасности приложения.	None
Элемент <entryPoint> (приложение ClickOnce)	Обязательный.Определяет точку входа в код приложения для выполнения.	name dependencyName customHostSpecified
Элемент <dependency> (приложение ClickOnce)	Обязательный.Определяет все зависимости, необходимые для выполнения приложения.При необходимости определяет сборки, которые требуется установить предварительно.	None
Элемент <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>

Элемент	Описание	Атрибуты
Элемент <customHostSpecified> (разработка для Office в Visual Studio)	Обязательный.Помечает манифест как решение Office.	None
Элемент <addin> (разработка для Office в Visual Studio)	Обязательный.Хранит точки входа в одном пространстве имен.	None
Элемент <entryPointsCollection> (разработка для Office в Visual Studio)	Обязательный.Группирует все сборки для одного или нескольких решений Office.	id
Элемент <entryPoints> (разработка для Office в Visual Studio)	Обязательный.Группирует все сборки для запуска решения Office.	None
Элемент <entryPoint> (разработка для Office в Visual Studio)	Обязательный.Указывает сборку, запускаемую в решении Office.	class contract
Элемент <update> (разработка для Office в Visual Studio)	Обязательный.Настраивает конфигурацию обновлений для решения.	enabled expiration
Элемент <postActions> (разработка для Office в Visual Studio)	Необязательный.Группирует все действия, выполняемые после развертывания, которые запускаются после установки решений Office.	None
Элемент <postAction> (разработка для Office в Visual Studio)	Необязательный.Указывает действие, выполняемое после развертывания.	None
Элемент <postActionData> (разработка для Office в Visual Studio)	Необязательный.Настраивает данные для действия, выполняемого после развертывания.	None
Элемент <application> (разработка для Office в Visual Studio)	Обязательный.Служит оболочкой в виде единого узла для хранения сведений о приложении.	None
Элемент <customizations> (разработка для Office в Visual Studio)	Обязательный.Хранит все сведения о ведущем приложении в отдельном пространстве имен.	None
Элемент <customization> (Office Development in Visual Studio)	Обязательный.Хранит сведения о ведущем приложении в отдельном пространстве имен.	xmlns
Элемент <document> (разработка для Office в Visual Studio)	Является обязательным только для решений на уровне документа.Хранит сведения о настройках.	solutionId
Элемент <appAddin> (разработка для Office в Visual Studio)	Является обязательным только для решений на уровне приложения.Хранит сведения о настройках.	application loadBehavior keyName
Элемент <friendlyName> (разработка для Office в Visual Studio)	Необязательный.Хранит имя надстройки, которое будет отображаться в списке установленных надстроек.	None
Элемент <description> (разработка для Office в Visual Studio)	Является обязательным только для надстроек на уровне приложения.Хранит описание, которое будет отображаться в списке установленных программ.	None
Элемент <formRegions> (разработка для Office в Visual Studio)	Требуется только для надстройки outlook, включающей области формы.	None
Элемент <formRegion> (разработка для Office в Visual Studio)	Требуется только для надстройки outlook, включающей области формы.	Name
Элемент <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

См. также

Ссылки

Манифесты развертывания для решений Office

Манифест приложения ClickOnce

Поделиться через