Разработка надстроек Office с помощью Visual Studio Code

В этой статье описано, как разработать надстройку Office с помощью Visual Studio Code (VS Code).

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

• Visual Studio Code

• Средство создания проекта. У вас есть следующие варианты.

  • Генератор Yeoman для надстроек Office (также называется Yo Office). Инструкции по установке и использованию см. в статье Создание проектов надстроек Office с помощью генератора Yeoman. С помощью этого средства вы можете создавать надстройки, которые используют либо манифест только надстройки, либо унифицированный манифест для Microsoft 365. Для получения дополнительных сведений о различиях начните с манифеста надстроек Office.
  • Набор средств агентов Microsoft 365 для Visual Studio Code. Инструкции по установке см. в разделе Установка набора средств агентов. Инструкции по использованию см. в статье Создание проектов надстроек Office с помощью microsoft 365 Agents Toolkit. С помощью этого средства можно создавать надстройки, использующие унифицированный манифест для Microsoft 365.

  Примечание.

  Унифицированный манифест для Microsoft 365 можно использовать в рабочих надстройках Outlook. Он доступен только в качестве предварительной версии для надстроек Excel, PowerPoint и Word.

Разработка надстройки с помощью VS Code

Чтобы работать с проектом, откройте корневую папку проекта с помощью VS Code.

Оба средства создают базовую надстройку с ограниченными возможностями. Вы можете настроить надстройку, изменив файлы манифеста, HTML, JavaScript, TypeScript или CSS в VS Code. Общее описание структуры проекта и файлов в проекте надстройки, созданном генератором Yeoman, см. в рекомендациях по генератору Yeoman в 5-минутном кратком руководстве, соответствующем типу созданной надстройки.

Тестирование и отладка надстройки

Методы тестирования, отладки и устранения неполадок надстроек Office различаются в зависимости от платформы и средства, используемого для создания проекта. Дополнительные сведения см. в разделах Тестирование и отладка надстроек Office и Создание проектов надстроек Office с помощью microsoft 365 Agents Toolkit.

Публикация надстройки

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

При разработке надстройки можно запускать надстройку на локальном веб-сервере (localhost), но если вы готовы опубликовать ее для доступа других пользователей, вам потребуется развернуть веб-приложение на веб-сервере или в службе веб-хостинга (например, в Microsoft Azure) и изменить манифест, указав URL-адрес разворачиваемого приложения.

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

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

   npm run build
   

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

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

3. В VS Code откройте файл манифеста надстройки, расположенный в корневом каталоге проекта. Замените все вхождения https://localhost:3000 URL-адресом веб-приложения, развернутого на веб-сервере на предыдущем этапе.

4. Выберите метод, который вы хотите использовать для развертывания надстройки Office, и следуйте инструкциям по публикации надстройки.

См. также

• Основные принципы надстроек Office
• Разработка надстроек Office
• Проектирование надстроек Office
• Тестирование и отладка надстроек Office
• Публикация надстроек Office