Манифесты приложений для решений 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