Развертывание настроек уровня документа (системы 2003)
Обновлен: Ноябрь 2007
Применение |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Развертывание настроек уровня документа для Microsoft Office Word 2003 и Microsoft Office Excel 2003 обычно обозначает работу со следующими четырьмя файлами.
Файлом Word или Excel (шаблоном, документом или рабочей книгой), с которым работает конечный пользователь.
Сборкой содержащей скомпилированный пользовательский код и любые зависимые сборки, такие как ресурсы, вспомогательные сборки или библиотеки.
Манифест развертывания (если применимо).
Манифест приложения (если применимо).
При развертывании решения следует учитывать следующие рекомендации:
У пользователей должна быть установлена платформа .NET Framework. Дополнительные сведения см. в разделах Распространение .NET Framework и Работа с несколькими версиями .NET Framework.
У пользователей должна быть установлена среда выполнения Visual Studio Tools for Office. Дополнительные сведения см. в разделе Практическое руководство. Подготовка компьютеров пользователей для выполнения решений (система 2003)..
У всех конечных пользователей должны быть как минимум доступ для чтения документа Office и сборки.
И документ и сборка должны иметь полное доверие для решения Word или Excel. Если документ хранится на компьютере пользователя, документ автоматически имеет полное доверие. Однако сборка на компьютере пользователя не получает полное доверие автоматически. Дополнительные сведения см. в разделе Безопасность в решениях Office (система 2003).
Для развертывания решения необходимо скопировать в место развертывания документ и сборку, а также, если необходимо, манифест приложения и развертывания. Дополнительные сведения о типах развертывания см. в разделе Модели развертывания (система 2003).
В среду Visual Studio Tools for Office входит Мастер публикации, который создает для решения манифест развертывания и приложения и копирует все требуемые файлы в место развертывания. Однако это можно сделать и вручную. Дополнительные сведения см. в разделах Практическое руководство. Развертывание решений Office (система 2003) и Практическое руководство. Развертывание файлов решения с помощью "Мастера публикации" (на базе системы 2003).
Мастер публикации
Команда контекстного меню проекта Опубликовать в обозревателе решений запускает мастер публикации. После указания папки, в которую требуется опубликовать решение мастер копирует в эту папку документ и манифест развертывания. Дополнительные сведения см. в разделе Практическое руководство. Развертывание файлов решения с помощью "Мастера публикации" (на базе системы 2003).
Мастер также копирует сборки и обновленный манифест приложения в подпапку основной папки развертывания. Имя подпапки содержит номер версии. Если параметр Автоматически увеличивать номер версии после каждой публикации установлен в панели ПубликацияКонструктора проектов, то при каждой публикации решения создается новая подпапка. Более старые версии остаются доступны. Манифесты приложения и развертывания позволяют решению всегда использовать текущую сборку. Дополнительные сведения см. в разделах Манифесты приложения и развертывания в решениях Office, Практическое руководство. Развертывание файлов решения с помощью "Мастера публикации" (на базе системы 2003), Страница публикации в конструкторе проектов (выпуск 2003 системы Microsoft Office) и Мастер публикации (2003 система).
Обновление развернутых сборок (управление версиями)
При развертывании решения с именем ExcelWorkbook1 в папку C:\DeployFolder структура файла будет выглядеть следующим образом:
C:\DeployFolder
В этой папке содержатся следующие файлы и подпапки:
Книга Excel (ExcelWorkbook1.xls).
Манифест развертывания (ExcelWorkbook1.application).
C:\DeployFolder\ExcelApplication1_1.0.0.0
В этой папке содержатся следующие файлы:
Сборки.
Манифест приложения (ExcelWorkbook1.dll.manifest).
Копия рабочей книги.
Копия манифеста развертывания.
При обновлении сборки и повторной публикации решения структура каталога будет выглядеть следующим образом:
C:\DeployFolder
В этой папке содержатся следующие файлы и подпапки:
Рабочая книга (с обновленным внедренным манифестом приложения).
Манифест развертывания (обновленный для ссылки на манифест приложения в C:\DeployFolder\ExcelWorkbook1_1.0.0.1).
C:\DeployFolder\ExcelWorkbook1_1.0.0.0
В этой папке содержатся следующие файлы:
Исходные сборки.
Исходный манифест приложения.
Исходная рабочая книга.
Исходный манифест развертывания.
C:\DeployFolder\ExcelWorkbook1_1.0.0.1
В этой папке содержатся следующие файлы:
Обновленные сборки.
Обновленный манифест приложения.
Копия обновленной рабочей книги.
Копия обновленного манифеста развертывания.
Структура будет повторяться при каждом обновлении сборки. При обновлении документа или книги, в результате которого они становятся несовместимыми с текущей сборкой, необходимо провести развертывание решения в новую папку развертывания.
Использование MSBuild в командной строке
Для публикации решения также можно использовать MSBuild в командной строке. При использовании MSBuild в командной строке файлы решения можно опубликовать в одно расположение и одновременно изменить манифест приложения, встроенный в книгу или документ для ссылки на манифест развертывания в другом расположении. Для публикации решения с помощью MSBuild в командной строке используйте следующий синтаксис.
msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>
Например, если требуется опубликовать проект C# под названием ExcelWorkbook1 в общую папку \\PublishServer\PublishFolder, а манифест развертывания, внешний манифест приложения и сборку надстройки в будущем планируется переместить в \\DeploymentServer\DeploymentFolder, необходимо выполнить следующую команду.
msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\ExcelWorkbook1\ExcelWorkbook1.csproj
Дополнительные сведения об использовании MSBuild в командной строке см. в разделе Построение ClickOnce-приложений из командной строки.
Манифесты приложения и развертывания
Манифесты приложения и развертывания позволяют документу обновляться последней сборкой. Дополнительные сведения см. в разделе Манифесты приложения и развертывания в решениях Office.
Обновление манифестов развертывания
Изменение манифестов развертывания для решения может потребоваться несколько раз за время его существования. Есть две основных причины для обновления манифестов развертывания.
Производится развертывание новой версии сборки решения. Дополнительные сведения см. в разделе Практическое руководство. Обновление развернутых файлов сборки (выпуск 2003 системы).
Производится изменение расположения сборки решения. Дополнительные сведения см. в разделе Практическое руководство. Изменение расположения настроек уровня документа (система 2003).
Обновление манифестов приложения
Возможно, что непосредственное обновление манифеста существующего приложения, используемого в решении, никогда не потребуется. Обычно для загрузки нового манифеста приложения в решение создается новый манифест приложения и используется манифест развертывания. Однако есть две причины, по которым возможно потребуется непосредственное обновление манифеста приложения в документе.
Манифест развертывания и сборки были перемещены на новый сервер, так как исходный сервер временно не работает. В этом случае необходимо изменить пути к этим элементам в манифесте приложения. Дополнительные сведения см. в разделе Практическое руководство. Изменение расположения настроек уровня документа (система 2003).
Требуется удалить манифест приложения из документа. Например, необходимо заархивировать документ и выполнение кода (например, меняющего содержимое документа) нежелательно или требуется отправить завершенный документ за пределы рабочей группы без ссылок на код. Дополнительные сведения см. в разделе Практическое руководство. Удаление расширений управляемого кода из документов (система 2003).
Развертывание локализованных решений Microsoft Office
Большинство аспектов развертывания локализованных решений Visual Studio Tools for Office аналогичны аспектам, возникающим при развертывании других типов решений с помощью Visual Studio. Однако есть некоторые дополнительные рекомендации, касающиеся создания и распространения локализованных версий решений Visual Studio Tools for Office. Дополнительные сведения см. в разделах Глобализация и локализация решений Microsoft Office, Практическое руководство. Локализация решений Excel и Развертывание и локализация.
См. также
Задачи
Практическое руководство. Развертывание решений Office (система 2003)
Основные понятия
Развертывание решений Office (система 2003)
Развертывание надстроек уровня приложения (система 2003)
Модели развертывания (система 2003)
Автономные модели для решений Office (системы 2003)
Безопасное развертывание (Система 2003)