Публикация надстроек SharePoint с помощью Visual Studio

Статья
04/08/2023

Узнайте, как опубликовать Надстройка SharePoint с помощью Microsoft Visual Studio 2013 или Visual Studio 2012. Если с надстройкой связано веб-приложение, то сначала необходимо развернуть его.

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

Предварительные требования

Microsoft Visual Studio 2013 или Visual Studio 2012 и Средства разработчика Office для Visual Studio. Сведения о том, как скачать средства, см. в разделе "Инструменты" на странице скачивания. (Новый диспетчер публикации недоступен в Visual Studio 2012 или более ранних версиях.)
Microsoft SharePoint

Публикация с помощью Visual Studio 2013

Если с размещаемым у поставщика Надстройка SharePoint связано веб-приложение, для начала разверните файлы для него. Затем, как и для всех Надстройки SharePoint, запакуйте Надстройка SharePoint и опубликуйте его.

Важно!

Чтобы убедиться, что идентификатор клиента SharePoint и значения секрета клиента публикуются вместе с веб-проектом, что позволяет веб-содержимому получать доступ к данным SharePoint, опубликуйте проект надстройки SharePoint на странице Публикация надстройки . Чтобы открыть эту страницу, откройте контекстное меню надстройки SharePoint, а не контекстное меню веб-приложения, а затем выберите команду Опубликовать .

Этап 1. Развертывание веб-приложения

Надстройка SharePoint обычно имеет связанное хост-приложение, которое необходимо развернуть на веб-сервере. Дополнительные сведения об использовании мастера публикации в Интернете см. в статье Практическое руководство. Развертывание веб-проекта с помощью публикации по щелчку в Visual Studio.

Открытие страницы публикации надстроек

В обозревателе решений откройте контекстное меню для проекта Надстройка SharePoint и выберите команду Опубликовать.
Откроется страница публикации надстроек.

Выбор или создание профиля

В списке Текущий профиль выберите профиль для импорта или нажмите кнопку <Создать...> для создания профиля.

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

Если выбрать <Создать ...>, откроется мастер создания профиля публикации . С помощью этого мастера можно импортировать профиль публикации от поставщика услуг размещения сайтов, например Azure, или создать новый профиль, а затем вручную добавить имя сервера, учетные данные и другие параметры. Если создать новый профиль, а не импортировать существующий, потребуется указать значения идентификатора клиента и секрета клиента, как описано в статьях Руководство по регистрации надстроек для SharePoint и Создание или обновление идентификаторов и секретов клиентов в панели мониторинга продавца Майкрософт.

Если вы планируете отправить надстройку SharePoint в Магазин Office, обязательно используйте значения идентификатора клиента и секрета клиента, созданные на панели мониторинга продаж. Вы можете использовать идентификаторы клиентов и значения секретов клиента, созданные с помощью страницы appregnew.aspx на этапе разработки, но надстройки, которые вы отправляете в Магазин Office, должны использовать идентификаторы клиентов и секреты клиентов, полученные на панели мониторинга продаж. Кроме того, следует создать профиль публикации на сайте Azure, а затем импортировать его в Visual Studio, а не в мастере создания профиля публикации . При создании профиля в Azure все параметры на вкладке Подключение предоставляются в Visual Studio. Дополнительные сведения об импорте или создании профиля публикации см. в разделе Создание профиля публикации.

Совет

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

Развертывание проекта веб-приложения

На вкладке Публикация надстройки нажмите кнопку Развернуть проект веб-приложения. Откроется диалоговое окно Публикация веб-сайта.
Заполните пустые поля на вкладках Подключение и Параметры.

Если требуется изменить способ публикации файлов для Надстройка SharePoint, или надстройка использует внешнюю базу данных, откройте вкладку Параметры. См. раздел "Настройка вкладки "Параметры"" статьи Развертывание проекта веб-приложения с помощью публикации одним щелчком в Visual Studio.
Чтобы узнать, какие элементы будут изменены при развертывании веб-приложения, нажмите кнопку Начало предварительного просмотра на вкладке Предварительный просмотр.
Нажмите кнопку Опубликовать, чтобы развернуть проект веб-приложения.

Этап 2. Упаковка надстройки

На вкладке Публикация надстройки нажмите кнопку Упаковать надстройку. Откроется мастер Публикация надстроек для Office и SharePoint.
В текстовом поле Где размещен ваш веб-сайт? введите URL-адрес сайта, на котором будут размещены файлы Надстройка SharePoint.

Необходимо указать адрес, начинающийся с префикса https. См . статью Почему мои надстройки должны быть защищены SSL?.

Примечание.

Веб-сайты Azure автоматически предоставляют конечную точку HTTPS. Если надстройка публикуется на сайте Магазина Office или в Магазине Office, адрес должен начинаться с префикса https. Тем не менее, если надстройка публикуется на локальном сайте, необходимо использовать префикс "http".

В текстовом поле Идентификатор клиента надстройки уже должен появиться идентификатор клиента, введенный в профиле публикации.

Если до этого момента использовалось замещающее значение идентификатора клиента, то теперь необходимо добавить фактический идентификатор клиента. Эти сведения встроены в APP-пакет и позволяют веб-содержимому связываться с SharePoint на динамическом сайте.
Нажмите кнопку Готово.

Visual Studio создает файлы, необходимые для публикации надстройки SharePoint, а затем открывает папку выходных данных публикации. Сведения об установке надстройки см. в статье Установка надстроек SharePoint и управление ими 2013.

Этап 3. Публикация надстройки SharePoint в Магазине Office

Чтобы отправить надстройку SharePoint в Магазин Office, выполните указанные ниже действия.

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

См . раздел Использование панели мониторинга продаж для отправки решения в AppSource.
Выберите добавить новое приложение, заполните сведения и отправьте надстройку в Магазин Office. Дополнительные сведения см . в разделе Отправка решения в AppSource с помощью панели мониторинга продаж.

Публикация с помощью Visual Studio 2012

Когда Надстройка SharePoint будет готово к упаковке, откройте мастер публикации надстроек Office, который подготовит файлы Надстройка SharePoint к публикации.

Этап 1. Упаковка надстройки SharePoint

В обозревателе решений откройте контекстное меню для проекта Надстройка SharePoint и выберите команду Опубликовать.

Запустится мастер публикации надстроек Office. Страницы мастера зависят от типа Надстройка SharePoint, которое вы упаковываете. Для надстройки с размещением в SharePoint появляется только страница Сводка. Для надстройки, размещаемой у поставщика, также отображаются страницы Профиль и Размещение.
Если Надстройка SharePoint размещается у поставщика, укажите имя профиля публикации в списке Выбор профиля для публикации и нажмите кнопку Далее.

В профиле публикации сохраняются сведения, введенные вами на странице Размещение.
В списке Место размещения веб-сайта укажите URL-адрес веб-приложения, в котором будет размещаться Надстройка SharePoint.
В полях в разделе Удостоверение надстройки укажите идентификатор клиента и секрет клиента для надстройки, а затем нажмите кнопку Далее.

См. статью Авторизация и проверка подлинности надстроек SharePoint.
Для всех типов Надстройки SharePoint установите флажок Открыть папку выходных данных после успешной упаковки, если он еще не установлен, и нажмите кнопку Готово.

Visual Studio создает все файлы, необходимые для публикации Надстройка SharePoint. Эти файлы можно найти в папке app.Publish выходных данных проекта (например, %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish). В ней содержится APP-файл Надстройка SharePoint и несколько файлов веб-приложения (если Надстройка SharePoint размещается в облаке). Все Надстройки SharePoint включают APP-файл, представляющий собой манифест надстройки для публикации Надстройка SharePoint. Надстройки SharePoint с размещением у поставщика также включают файлы для публикации ведущего веб-приложения.

Этап 2. Публикация веб-приложения

Если Надстройка SharePoint размещается у поставщика, то с ним связано веб-приложение, которое необходимо опубликовать на веб-сервере. Visual Studio создает пакет развертывания и сценарий для выполнения этой задачи.

Пакет развертывания проекта веб-приложения содержится в сжатом (.zip) файле в папке app.publish . Помимо ZIP-файла, в папке app.publish находятся следующие файлы.

Файл	Описание
Имя_проекта.deploy.cmd	Это пакетный файл командной строки, который вызывает средство веб-развертывания, что позволяет упростить установку пакета с помощью командной строки.
Имя_проекта.SetParameters.xml	Этот файл содержит параметры, которые передаются в средство веб-развертывания при использовании файла deploy.cmd для установки пакета. Настройки пакета Visual Studio определяют значения по умолчанию для всех параметров. Вы можете изменить эти значения, например, если нужно установить веб-приложение на нескольких серверах и использовать разные параметры для каждого из них.
Имя_проекта.SourceManifest.xml	Этот файл содержит параметры, которые Visual Studio передает в средство веб-развертывания и которые это средство использует для создания веб-пакета. Этот файл требуется средству веб-развертывания только для создания пакета. Он не используется при установке пакета.

Пошаговые инструкции см. в статье Практическое руководство. Установка пакета развертывания с помощью файла deploy.cmd, созданного с помощью Visual Studio.

Этап 3. Публикация надстройки SharePoint

Чтобы опубликовать надстройку SharePoint, отправьте файл манифеста надстройки (.app) надстройки в Магазин Office, каталог надстроек Office, SharePoint, общую папку или каталог Exchange. Манифест надстройки находится в папке app.publish , например %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish. Дополнительные сведения о публикации надстройки SharePoint см. в статье Авторизация и проверка подлинности надстроек SharePoint.

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