Развертывание решения Office с помощью ClickOnce

Решение Office можно развернуть за меньшее количество шагов, если вы используете ClickOnce. При публикации обновлений решение автоматически обнаружит и установит их. Однако ClickOnce требует установки решения отдельно для каждого пользователя компьютера. Поэтому следует рассмотреть возможность использования установщика Windows (.msi), если ваше решение будет запускаться несколькими пользователями на одном компьютере.

В этом разделе

• Публикация решения

• Выбор способа предоставления доверия решению

• Помощь пользователям в установке решения

• Поместите документ решения на компьютер конечного пользователя (только настройки на уровне документа)

• Поместите документ решения на сервер под управлением SharePoint (только настройки на уровне документа)

• Создание пользовательского установщика

• Публикация обновления

• Изменение расположения установки решения

• Откат решения до более ранней версии

  Дополнительные сведения о развертывании решения Office путем создания файла установщика Windows см. в статье "Развертывание решения Office с помощью установщика Windows".

Публикация решения

Решение можно опубликовать с помощью мастера публикации или конструктора проектов. В этой процедуре вы будете использовать конструктор проектов , так как он предоставляет полный набор параметров публикации. См. Мастер публикации (разработка Office в Visual Studio).

Публикация решения

1. В Обозреватель решений выберите узел, названный в честь вашего проекта.

2. В строке меню выберите "Проект", "СвойстваProjectName".

3. В конструкторе проектов выберите вкладку "Публикация ", на которой показана следующая иллюстрация.

   

4. В поле "Расположение папки публикации" (ftp-сервер или путь к файлу) введите путь к папке, в которой конструктор проектов копирует файлы решения.

   Можно ввести любой из следующих типов путей.

   • Локальный путь (например, C:\FolderName\FolderName\FolderName).

   • Путь в формате Универсальной Системы Именования (UNC) к папке в вашей сети (например, \\ServerName\FolderName).

   • Относительный путь (например, PublishFolder\, который является папкой, в которой проект публикуется по умолчанию).

5. В поле URL-адрес папки установки введите полный путь к расположению, где конечные пользователи будут находить решение.

   Если вы еще не знаете расположение, не введите ничего в это поле. По умолчанию ClickOnce ищет обновления в папке, из которой пользователи устанавливают решение.

6. Нажмите кнопку "Предварительные требования".

7. В диалоговом окне "Предварительные требования" установите флажок "Создать программу установки" для установки необходимых компонентов .

8. В списке Выбор необходимых компонентов для установки установите флажки для Windows Installer 4.5 и подходящего пакета .NET Framework.

   Например, если решение предназначено для .NET Framework 4.5, установите флажки для установщика Windows 4.5 и Microsoft .NET Framework 4.5 Full.

9. Если решение предназначено для .NET Framework 4.5, установите флажок "Инструменты Visual Studio 2010 для среды выполнения Office ".

   Замечание

   По умолчанию этот флажок не отображается. Чтобы отобразить этот флажок, необходимо создать пакет bootstrapper. См. статью "Создание пакета начальной загрузки" для надстройки VSTO Office 2013 с помощью Visual Studio 2012.

10. В разделе "Укажите расположение установки для необходимых компонентов", выберите один из отображаемых параметров и нажмите кнопку "ОК ".

    В таблице ниже представлено описание каждого из этих параметров.

    Вариант	Description
    Скачивание необходимых компонентов с веб-сайта поставщика компонентов	Пользователю будет предложено скачать и установить эти предварительные требования от поставщика.
    Скачивание необходимых компонентов из того же расположения, что и мое приложение	Необходимое программное обеспечение устанавливается с решением. При выборе этого параметра Visual Studio копирует все необходимые пакеты в расположение публикации. Для работы этого параметра необходимые пакеты должны находиться на компьютере разработки.
    Скачивание необходимых компонентов из следующего расположения	Visual Studio копирует все необходимые пакеты в указанное расположение и устанавливает их с помощью решения.

    Диалоговое окно "Предварительные требования".

11. Нажмите кнопку "Обновления" , укажите, как часто требуется, чтобы надстройка VSTO или настройка каждого пользователя проверяла наличие обновлений, а затем нажмите кнопку "ОК ".

    Замечание

    Если вы развертываете с помощью компакт-диска или съемного диска, выберите кнопку «Никогда не проверять наличие обновлений».

    Сведения о публикации обновления см. в статье "Публикация обновления".

12. Нажмите кнопку " Параметры ", просмотрите параметры в диалоговом окне "Параметры " и нажмите кнопку "ОК ".

13. Нажмите кнопку "Опубликовать сейчас ".

    Visual Studio добавляет следующие папки и файлы в папку публикации, указанную ранее в этой процедуре.

    • Папка "Файлы приложений ".

    • Программа установки.

    • Манифест развертывания, указывающий на манифест развертывания самой последней версии.

      Папка "Файлы приложений " содержит вложенную папку для каждой из опубликованных версий. Каждая вложенная папка для конкретной версии содержит следующие файлы.

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

    • Манифест развертывания.

    • Сборки для настройки.

      На следующем рисунке показана структура папки публикации для надстройки VSTO Outlook.

      

    Замечание

    ClickOnce добавляет расширение .deploy к сборкам, чтобы безопасная установка служб IIS не блокировала файлы из-за небезопасного расширения. Когда пользователь устанавливает решение, ClickOnce удаляет расширение .deploy .

14. Скопируйте файлы решения в расположение установки, указанное ранее в этой процедуре.

Выбор способа предоставления доверия решению

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

Если вы развертываете настройку на уровне документа и хотите поместить документ в папку на компьютере пользователя или сделать документ доступным на сайте SharePoint, убедитесь, что Office доверяет расположению документа. См . раздел "Предоставление доверия к документам".

Помощь пользователям в установке решения

Пользователи могут установить решение, выполнив программу установки, открыв манифест развертывания или во время настройки на уровне документа, открыв документ напрямую. Рекомендуется установить решение с помощью программы установки. Другие два подхода не гарантируют, что необходимое программное обеспечение установлено. Если пользователи хотят открыть документ из расположения установки, они должны добавить его в список надежных расположений в Центре управления безопасностью приложения Office.

Открытие документа настройки уровня документов

Пользователи могут открыть документ кастомизации на уровне документа непосредственно из папки установки или скопировать документ на локальный компьютер, а затем открыть эту копию.

Рекомендуется открыть копию документа на своих компьютерах, чтобы несколько пользователей не пытались одновременно открывать одну и ту же копию. Чтобы применить эту практику, можно настроить программу установки для копирования документа на пользовательские компьютеры. См. поместить документ решения на компьютер конечного пользователя (настройки только на уровне документа).

Установка решения путем открытия манифеста развертывания с веб-сайта IIS

Пользователи могут установить решение Office, открыв манифест развертывания из Интернета. Однако безопасная установка служб IIS блокирует файлы с расширением VSTO . Для развертывания решения Office с помощью IIS необходимо определить тип MIME.

Добавление типа MIME VSTO в IIS 6.0

1. На сервере, на котором выполняется IIS 6.0, выберите Пуск>Все программы>Администрирование>Диспетчер интернет-служб (IIS).

2. Выберите имя компьютера, папку веб-сайтов или веб-сайт, который вы настраиваете.

3. В строке меню выберите Действия>Свойства.

4. На вкладке заголовков HTTP нажмите кнопку "Типы MIME ".

5. В окне "Типы MIME" нажмите кнопку "Создать ".

6. В окне типа MIME введите VSTO в качестве расширения, введите приложение/x-ms-vsto в качестве типа MIME, а затем примените новые параметры.

   Замечание

   Чтобы изменения вступили в силу, необходимо перезапустить службу публикации в Интернете или дождаться перезапуска рабочего процесса. Затем необходимо очистить кэш диска браузера, а затем снова попытаться открыть VSTO-файл .

Добавление типа VSTO MIME в IIS 7.0

1. На сервере, на котором запущена служба IIS 7.0, нажмите кнопку "Пуск>всех программ>"Аксессуары.

2. Откройте контекстное меню командной строки и выберите команду "Запуск от имени администратора".

3. В поле "Открыть" введите следующий путь и нажмите кнопку "ОК ".

   %windir%\system32\inetsrv
   

4. Введите следующую команду и примените новые параметры.

   set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
   

   Замечание

   Чтобы изменения вступили в силу, необходимо перезапустить службу публикации в Интернете, или дождаться перезапуска рабочего процесса. Затем необходимо очистить кэш диска браузера, а затем снова попытаться открыть VSTO-файл .

Поместите документ решения на компьютер конечного пользователя (только настройки на уровне документа)

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

В следующих процедурах предполагается, что имя проекта — ExcelWorkbook , и вы публикуете решение в созданную папку C:\publish на компьютере.

Создание класса, определяющего действие после развертывания

1. В строке меню выберите "Файл>Добавить>Новый проект".

2. В диалоговом окне "Добавление нового проекта " в области "Установленные шаблоны " выберите папку Windows .

3. В области шаблонов выберите шаблон библиотеки классов .

4. В поле "Имя" введите FileCopyPDA и нажмите кнопку "ОК ".

5. В обозревателе решений выберите проект FileCopyPDA .

6. В строке меню выберите Проект>Добавить ссылку.

7. На вкладке .NET добавьте ссылки на Microsoft.VisualStudio.Tools.Applications.Runtime и Microsoft.VisualStudio.Tools.Applications.ServerDocument.

8. Переименуйте класс FileCopyPDAв , а затем замените содержимое файла кодом. Этот код выполняет следующие задачи:

   • Копирует документ на рабочий стол пользователя.

   • Изменяет свойство _AssemblyLocation с относительного пути на полностью квалифицированный путь для манифеста развертывания.

   • Удаляет файл, если пользователь удаляет решение.

     • C#
     • ВБ

     using Microsoft.VisualStudio.Tools.Applications.Deployment;
     using Microsoft.VisualStudio.Tools.Applications;
     using System.IO;
     
     namespace FileCopyPDA
     {
         public class FileCopyPDA : IAddInPostDeploymentAction
         {
             public void Execute(AddInPostDeploymentActionArgs args) 
             {
                 string dataDirectory = @"Data\ExcelWorkbook.xlsx";
                 string file = @"ExcelWorkbook.xlsx";
                 string sourcePath = args.AddInPath;
                 Uri deploymentManifestUri = args.ManifestLocation;
                 string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
                 string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
                 string destFile = System.IO.Path.Combine(destPath, file);
     
                 switch (args.InstallationStatus)
                 {
                     case AddInInstallationStatus.InitialInstall:
                     case AddInInstallationStatus.Update:
                         File.Copy(sourceFile, destFile);
                         ServerDocument.RemoveCustomization(destFile);
                         ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                         break;
                     case AddInInstallationStatus.Uninstall:
                         if (File.Exists(destFile))
                         {
                             File.Delete(destFile);
                         }
                         break;
                 }
             }
         }
     }
     

   ---

Создание и публикация решения

1. В обозревателе решений откройте контекстное меню для проекта FileCopyPDA и нажмите кнопку "Сборка".

2. Откройте контекстное меню для проекта ExcelWorkbook , а затем нажмите кнопку "Сборка".

3. Откройте контекстное меню проекта ExcelWorkbook и нажмите кнопку "Добавить ссылку".

4. В диалоговом окне "Добавить ссылку " выберите вкладку "Проекты" , выберите FileCopyPDA и нажмите кнопку "ОК ".

5. В обозревателе решений выберите проект ExcelWorkbook .

6. На строке меню выберите Проект>Создать папку.

7. Введите Данные и нажмите клавишу Ввод.

8. В обозревателе решений выберите папку "Данные ".

9. В строке меню выберите "Добавить существующий элемент>".

10. В диалоговом окне "Добавить существующий элемент" перейдите в выходной каталог проекта ExcelWorkbook , выберите файл ExcelWorkbook.xlsx и нажмите кнопку "Добавить ".

11. В обозревателе решений выберите файл ExcelWorkbook.xlsx .

12. В окне "Свойства" измените свойство Действие сборки на Содержимое и свойство Копировать в выходной каталог на Копировать, если новее.

    После выполнения этих действий проект будет выглядеть так, как показано на следующем рисунке.

    

13. Опубликуйте проект ExcelWorkbook .

Изменение манифеста приложения

1. Откройте каталог решения c:\publish с помощью Проводник файлов Windows.

2. Откройте папку "Файлы приложений ", а затем откройте папку, соответствующую последней опубликованной версии решения.

3. Откройте файл ExcelWorkbook.dll.manifest в текстовом редакторе, например Блокноте.

4. </vstav3:update> После элемента добавьте следующий код. Для атрибута <vstav3:entryPoint> класса элемента используйте следующий синтаксис: NamespaceName.ClassName. В следующем примере пространство имен и имена классов совпадают, поэтому итоговое имя точки входа равно FileCopyPDA.FileCopyPDA.

   <vstav3:postActions>
     <vstav3:postAction>
       <vstav3:entryPoint
         class="FileCopyPDA.FileCopyPDA">
         <assemblyIdentity
           name="FileCopyPDA"
           version="1.0.0.0"
           language="neutral"
           processorArchitecture="msil" />
       </vstav3:entryPoint>
       <vstav3:postActionData>
       </vstav3:postActionData>
     </vstav3:postAction>
   </vstav3:postActions>
   

Повторно подпишите манифесты приложения и манифесты развертывания

1. В папке %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook скопируйте файл сертификата ExcelWorkbook_TemporaryKey.pfx , а затем вставьте его в папку PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion .

2. Откройте командную строку Visual Studio и измените каталоги на папку c:\publish\Application Files\ExcelWorkbook_MostRecentPublishedVersion (например, c:\publish\Application Files\ExcelWorkbook_1_0_0_4).

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

   mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
   

   Появляется сообщение "ExcelWorkbook.dll.manifest успешно подписан".

4. Перейдите в папку c:\publish , а затем обновите и подпишите манифест развертывания, выполнив следующую команду:

   mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
   celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
   

   Замечание

   В предыдущем примере замените MostRecentVersionNumber номером версии последней опубликованной версии решения (например, 1_0_0_4).

   Появилось сообщение "ExcelWorkbook.vsto успешно подписано".

5. Скопируйте файл ExcelWorkbook.vsto в каталог c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber .

Поместите документ решения на сервер под управлением SharePoint (только настройки на уровне документа)

Вы можете опубликовать настройку на уровне документа конечным пользователям с помощью SharePoint. Когда пользователи переходят на сайт SharePoint и открывают документ, среда выполнения автоматически устанавливает решение из общей сетевой папки на локальный компьютер пользователя. После локальной установки решения настройка по-прежнему будет работать, даже если документ копируется в другом месте, например на рабочем столе.

Размещение документа на сервере под управлением SharePoint

1. Добавьте документ решения в библиотеку документов на сайте SharePoint.

2. Выполните действия для одного из следующих подходов:

   • Используйте средство настройки Office, чтобы добавить сервер под управлением SharePoint в Центр управления безопасностью в Word или Excel на всех пользовательских компьютерах.

     См. статью "Политики безопасности и параметры" в Office 2010.

   • Убедитесь, что каждый пользователь выполняет следующие действия.

     1. На локальном компьютере откройте Word или Excel, перейдите на вкладку "Файл " и нажмите кнопку "Параметры ".

     2. В диалоговом окне "Центр управления безопасностью " нажмите кнопку "Надежные расположения ".

     3. Установите флажок "Разрешить надежные расположения" в моей сети (не рекомендуется), а затем нажмите кнопку "Добавить новое расположение ".

     4. В поле "Путь " введите URL-адрес библиотеки документов SharePoint, содержащей отправленный документ (например, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).

        Не добавляйте имя веб-страницы по умолчанию, например default.aspx или AllItems.aspx.

     5. Установите флажок "Вложенные папки" этого расположения также являются доверенными , а затем нажмите кнопку "ОК ".

        Когда пользователи открывают документ с сайта SharePoint, откроется документ и устанавливается настройка. Пользователи могут скопировать документ на рабочий стол. Настройка по-прежнему будет выполняться, так как свойства в документе указывают на сетевое расположение документа.

Создание пользовательского установщика

Вы можете создать настраиваемый установщик для решения Office, а не использовать программу установки, созданную для вас при публикации решения. Например, можно использовать скрипт входа для запуска установки или пакетный файл для установки решения без взаимодействия с пользователем. Эти сценарии лучше всего работают, если предварительные требования уже установлены на компьютерах конечных пользователей.

В рамках пользовательского процесса установки вызовите средство установщика для решений Office (VSTOInstaller.exe), которое устанавливается в следующем расположении по умолчанию:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Если инструмент не находится в этом расположении, вы можете использовать раздел реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath или HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath, чтобы найти путь к этому инструменту.

С VSTOinstaller.exeможно использовать следующие параметры.

При запуске VSTOinstaller.exeмогут появиться следующие коды ошибок.

Публикация обновления

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

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

Изменение расположения установки решения

После публикации решения можно добавить или изменить путь установки. Может потребоваться изменить путь установки по одной или нескольким причинам:

• Программа установки была скомпилирована до того, как путь установки был известен.

• Файлы решения были скопированы в другое расположение.

• Сервер, на котором размещены файлы установки, имеет новое имя или расположение.

  Чтобы изменить путь установки решения, необходимо обновить программу установки, а затем пользователи должны запустить ее. Для настройки на уровне документа пользователи также должны обновить свойство в документе, чтобы указать новое расположение.

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

1. Откройте окно командной строки и измените каталоги на папку установки.

2. Запустите программу установки и включите /url параметр, который принимает новый путь установки в виде строки.

   В следующем примере показано, как изменить путь установки на расположение на веб-сайте Fabrikam, но его можно заменить на нужный путь:

   setup.exe /url="http://www.fabrikam.com/newlocation"
   

   Замечание

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

   Замечание

   Чтобы отобразить текущее значение URL-адреса, выполните команду setup.exe /url.

   Для кастомизации на уровне документа пользователям необходимо открыть документ, а затем обновить его в свойстве _AssemblyLocation. Ниже описано, как пользователи могут выполнять эту задачу.

Обновление свойства _AssemblyLocation в документе

1. На вкладке "Файл" выберите "Сведения", на котором показана следующая иллюстрация.

   

2. В списке свойств выберите "Дополнительные свойства", на котором показана следующая иллюстрация.

   

3. На вкладке "Настраиваемые " в списке свойств выберите _AssemblyLocation, как показано на следующем рисунке.

   

   Поле "Значение" содержит идентификатор манифеста развертывания.

4. Перед идентификатором введите полный путь к документу, за которым следует вертикальная черта, в формате Путь|Идентификатор (например, File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

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

5. Нажмите кнопку "ОК ", а затем сохраните и закройте документ.

6. Запустите программу установки без параметра /URL, чтобы установить решение в указанном расположении.

Откат решения до более ранней версии

При откате решения вы возвращаете пользователей на более раннюю версию этого решения.

Откат решения

1. Откройте папку с установленным решением.

2. В папке публикации верхнего уровня удалите манифест развертывания ( VSTO-файл ).

3. Найдите вложенную папку для версии, в которую требуется откатить.

4. Скопируйте манифест развертывания из этой вложенной папки в папку публикации верхнего уровня.

   Например, чтобы откатить решение, называемое OutlookAddIn1, с версии 1.0.0.1 до версии 1.0.0.0, скопируйте файл OutlookAddIn1.vsto из папки OutlookAddIn1_1_0_0_0. Вставьте файл в папку публикации верхнего уровня, перезаписав манифест развертывания для конкретной версии для OutlookAddIn1_1_0_0_1 , который уже был там.

   На следующем рисунке показана структура папок публикации в этом примере.

   

   При следующем открытии приложения или настраиваемого документа пользователь обнаруживает изменение манифеста развертывания. Более ранняя версия решения Office выполняется из кэша ClickOnce.

Связанный контент

• Развертывание решения Office
• Публикация решений Office
• Практическое руководство. Публикация решения Office с помощью ClickOnce
• Практическое руководство. Установка решения Office ClickOnce
• Практическое руководство. Публикация решения Office на уровне документа на сервере SharePoint с помощью ClickOnce
• Создание настраиваемого установщика для решения Office ClickOnce