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

Развертывание надстроек уровня приложения (система 2003)

  • Статья

Обновлен: Ноябрь 2007

Применение

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office.

Тип проекта

  • Проекты уровня приложения

Версия Microsoft Office

  • Microsoft Office 2003

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Развертывание надстройки Microsoft Office 2003, созданной с помощью Visual Studio Tools for Office, обычно означает работу со следующими файлами:

  • первичная сборка надстройки и любые зависимые сборки, например ресурсы, вспомогательные сборки или библиотеки;

  • манифест приложения;

  • манифест развертывания (если применимо).

При развертывании решения следует учитывать следующие рекомендации:

Для развертывания надстройки выполните следующие шаги:

  • скопируйте манифест приложения, созданный процессом построения, и требуемые записи реестра на каждый клиентский компьютер;

  • скопируйте сборки надстроек (и, при необходимости, манифест развертывания) в расположение развертывания.

В качестве местоположения развертывания может использоваться локальная папка клиентского компьютера или удаленное местоположение, например сетевая папка. Дополнительные сведения см. в разделах Модели развертывания (система 2003) и Практическое руководство. Развертывание решений Office (система 2003).

ms269007.alert_note(ru-ru,VS.90).gifПримечание.

Не существует параметра развертывания, дающего конечным пользователям возможность использования диалогового окна Надстройки модели COM в приложениях Microsoft Office 2003 для установки надстроек, созданных при помощи Visual Studio Tools for Office.

Использование проекта программы установки

При создании проекта надстройки при помощи Visual Studio Tools for Office проект установки автоматически добавляется в решение. Если необходимо развернуть решение напрямую на клиентском компьютере, этот проект установки можно использовать для создания файла установщика Windows (MSI-файла). Установщик копирует файлы решения на клиентский компьютер и создает записи реестра, необходимые для запуска надстройки. Дополнительные сведения о проекте программы установки см. в разделе Проекты установки для надстроек уровня приложения (система 2003). Дополнительные сведения о необходимых записях реестра см. в разделе Записи реестра для надстроек уровня приложения.

Ограничения проекта программы установки

Проект программы установки по умолчанию имеет некоторые ограничения:

  • По умолчанию проект установки не устанавливает политику безопасности. Сборка надстроек и все сборки, на которые имеются ссылки, должны обладать полным доверием для выполнения. В проект установки можно добавить действие конфигурации политики безопасности. Кроме того, соответствующую политику безопасности может установить администратор. Дополнительные сведения см. в разделе Требования безопасности при выполнении решений Office (для системы 2003).

  • По умолчанию проект установки не проверяет наличие и не устанавливает среду выполнения Visual Studio Tools for Office и основную сборку взаимодействия для приложения Microsoft Office. Если эти компоненты не установлены на компьютере конечного пользователя, то надстройка не будет выполняться. Дополнительные сведения о требованиях см. в разделе Практическое руководство. Подготовка компьютеров пользователей для выполнения решений (система 2003)..

Использование мастера публикации

Для включения автоматического процесса обновления сборок воспользуйтесь Мастером публикации. Мастер публикации создает для решения манифест развертывания и копирует все требуемые файлы в местоположение развертывания.

Команда контекстного меню проекта Опубликовать в Обозревателе решений запускает Мастер публикации. После указания папки, в которую требуется опубликовать решение, мастер копирует в эту папку манифест развертывания. Мастер также копирует сборки и обновленный манифест приложения в подпапку основной папки развертывания. Имя подпапки содержит номер версии. Если параметр Автоматически увеличивать номер версии после каждой публикации установлен в панели ПубликацияКонструктора проектов, то при каждой публикации решения создается новая подпапка. Более старые версии остаются доступны. Манифесты приложения и развертывания позволяют решению всегда использовать правильную сборку. Дополнительные сведения см. в разделах Манифесты приложения и развертывания в решениях Office, Практическое руководство. Развертывание файлов решения с помощью "Мастера публикации" (на базе системы 2003) и Страница публикации в конструкторе проектов (выпуск 2007 системы Microsoft Office).

Ограничения мастера публикации

Мастер публикации имеет некоторые ограничения:

  • Мастер публикации не создает записи реестра, требуемые для запуска надстройки. Если Мастер публикации используется для развертывания надстройки, то эти записи необходимо создать самостоятельно — например, с помощью файла реестра (.reg). Мастер публикации также не перезаписывает и не удаляет записи реестра, созданные на компьютере разработчика при построении проекта. Дополнительные сведения о построении проектов см. в разделе Общие сведения о процессе построения решений Office. Дополнительные сведения о необходимых записях реестра см. в разделе Записи реестра для надстроек уровня приложения.

  • Мастер публикации не предоставляет полного доверия сборке надстройки в политике безопасности конечного пользователя. Сборка надстроек и все сборки, на которые имеются ссылки, должны обладать полным доверием для выполнения. Дополнительные сведения см. в разделе Требования безопасности при выполнении решений Office (для системы 2003).

Обновление развернутых сборок (управление версиями)

При развертывании решения с именем OutlookAddin1 в папку C:\DeployFolder структура файла будет выглядеть следующим образом:

C:\DeployFolder

В этой папке содержатся следующие файлы и подпапки:

  • Манифест развертывания (OutlookAddin1.application).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    В этой папке содержатся следующие файлы:

    • сборки;

    • манифест приложения (OutlookAddin1.dll.manifest);

    • копия манифеста развертывания.

При обновлении сборки и повторной публикации решения структура каталога будет выглядеть следующим образом:

C:\DeployFolder

В этой папке содержатся следующие файлы и подпапки:

  • Манифест развертывания (обновленный для ссылки на манифест приложения в C:\DeployFolder\OutlookAddin1_1.0.0.1).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    В этой папке содержатся следующие файлы:

    • исходные сборки;

    • исходный манифест приложения;

    • исходный манифест развертывания.

    C:\DeployFolder\OutlookAddin1_1.0.0.1

    В этой папке содержатся следующие файлы:

    • обновленные сборки;

    • обновленный манифест приложения;

    • копия обновленного манифеста развертывания.

Структура будет повторяться при каждом обновлении сборки надстройки.

Использование MSBuild из командной строки

Для публикации решения также можно использовать MSBuild в командной строке. При использовании MSBuild в командной строке файлы решения можно опубликовать в одно расположение и одновременно изменить манифест развертывания и обновленный манифест приложения для ссылки на другое расположение. Для публикации решения с помощью MSBuild в командной строке используйте следующий синтаксис:

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Например, если требуется опубликовать проект C# под названием OutlookAddin1 в общую папку \\PublishServer\PublishFolder, а манифест развертывания, обновленный манифест приложения и сборку надстройки в будущем планируется переместить в \\DeploymentServer\DeploymentFolder, необходимо выполнить следующую команду:

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\OutlookAddin1\OutlookAddin1.csproj

Дополнительные сведения об использовании MSBuild в командной строке см. в разделе Построение ClickOnce-приложений из командной строки.

Развертывание надстроек в Windows Vista

Если конечные пользователи выполняют приложение в системе Windows Vista, то при настройке развертывания необходимо учитывать ограничения безопасности Windows Vista. В противном случае пользователи не смогут установить обновления.

Если Мастер публикации используется для публикации обновлений надстроек в сетевое расположение или расположение HTTP , то конечные пользователи компьютеров под управлением Windows Vista смогут загрузить обновления сборок только при следующих условиях:

  • Манифест приложения установлен в папку на компьютере конечного пользователя, которая может быть изменена приложением со стандартными разрешениями.

    —либо—

  • Пользователь работает с приложением Microsoft Office с разрешениями администратора.

При публикации обновления надстройки среда выполнения Visual Studio Tools for Office пытается скопировать обновленный манифест приложения на компьютер конечного пользователя при следующем открытии приложения пользователем. Затем среда выполнения использует информацию в обновленном манифесте для загрузки обновленной сборки. Приложения Windows Vista, запущенные со стандартными разрешениями, не могут перезаписать файлы в определенных папках, включая папку %ProgramFiles%. Поэтому если манифест приложения установлен в папку, требующую разрешений администратора, приложение может загрузить обновленную сборку только в том случае, если пользователь запускает приложение как администратор. Пользователь также может запустить приложение со стандартными разрешениями, если манифест приложения установлен в папку, не требующую разрешений администратора, например %UserProfile%.

ms269007.alert_note(ru-ru,VS.90).gifПримечание.

Проект установки, созданный с помощью проектов надстроек, по умолчанию устанавливает манифест приложения в папку %CommonProgramFiles%.

Манифесты приложения и развертывания

Манифесты приложения и развертывания позволяют надстройке обновляться последней сборкой. Дополнительные сведения см. в разделе Манифесты приложения и развертывания в решениях Office.

Изменение манифестов приложения и развертывания для решения может потребоваться несколько раз за время его существования. Есть две основных причины для обновления манифестов:

См. также

Основные понятия

Развертывание решений Office (система 2003)

Проекты установки для надстроек уровня приложения (система 2003)

Проекты установки и развертывания

Ссылки

Записи реестра для надстроек уровня приложения