Разработка надстроек Office с помощью Visual Studio Code
В этой статье описано, как разработать надстройку Office с помощью Visual Studio Code (VS Code).
Примечание.
Сведения об использовании Visual Studio для создания надстроек Office см. в статье Разработка надстроек Office в Visual Studio.
Необходимые компоненты
Node.js (последняя версия LTS). Посетите сайтNode.js , чтобы скачать и установить правильную версию для вашей операционной системы.
Последняя версия Yeoman и генератора Yeoman для надстроек Office. Выполните в командной строке указанную ниже команду, чтобы установить эти инструменты глобально.
npm install -g yo generator-office
Примечание.
Даже если вы уже установили генератор Yeoman, рекомендуем обновить пакет до последней версии из npm.
Пакет Office, подключенный к подписке Microsoft 365 (включая Office в Интернете).
Примечание.
Если у вас еще нет Office, вы можете получить подписку разработчика на Microsoft 365 E5 в рамках программы microsoft 365 для разработчиков. Дополнительные сведения см. в разделе Часто задаваемые вопросы. Кроме того, вы можете зарегистрироваться для получения бесплатной пробной версии на 1 месяц или приобрести план Microsoft 365.
Создание проекта надстройки с помощью генератора Yeoman
Если вы используете VS Code в качестве интегрированной среды разработки (IDE), следует создать проект надстройки Office с помощью генератора Yeoman для надстроек Office. Генератор Yeoman создает проект Node.js, которым можно управлять с помощью VS Code или любого другого редактора.
Чтобы создать надстройку Office с помощью генератора Yeoman, следуйте указаниям из 5-минутного краткого руководства, соответствующего типу надстройки, которую нужно создать.
Разработка надстройки с помощью VS Code
Когда генератор Yeoman закончит создание проекта надстройки, откройте корневую папку проекта с помощью VS Code.
Совет
В Windows вы можете перейти в корневой каталог проекта с помощью командной строки и ввести code .
, чтобы открыть эту папку в VS Code. На компьютере Mac потребуется добавить в путь команду code
перед использованием этой команды для открытия папки проекта в VS Code.
Генератор Yeoman создает простую надстройку с ограниченными возможностями. Вы можете настроить надстройку, изменив файлы манифеста, HTML, JavaScript, TypeScript или CSS в VS Code. Общее описание структуры проекта и файлов в проекте надстройки, созданном генератором Yeoman, см. в рекомендациях по генератору Yeoman в 5-минутном кратком руководстве, соответствующем типу созданной надстройки.
Создание проекта надстройки с помощью пакета средств разработки надстроек Office (предварительная версия)
Пакет средств разработки надстроек Office — это расширение Visual Studio Code, которое позволяет создавать новые проекты непосредственно из VS Code. Сведения об установке расширения и создании проектов на основе шаблонов и примеров см. в статье Создание проектов надстроек Office с помощью пакета средств разработки надстроек Office для Visual Studio Code.
Важно!
Расширение пакета средств разработки надстроек Office поддерживает только создание надстроек, использующих только манифест надстройки. В настоящее время также создаются только надстройки Excel, PowerPoint и Word. Поддержка Outlook находится в разработке, а также дополнительные примеры и другие улучшения. Мы приветствуем любые отзывы, которые у вас есть о средстве. Запросы на проблемы и функции должны отправляться через GitHub в репозитории расширения.
Тестирование и отладка надстройки
Методы тестирования, отладки и устранения неполадок надстроек Office зависят от платформы. Дополнительные сведения см. в статье Тестирование и отладка надстроек Office.
Публикация надстройки
Надстройка Office включает два основных компонента: файл манифеста и собственное веб-приложение. Манифест определяет различные параметры, включая способ интеграции надстройки с клиентами Office. Веб-приложение обслуживает HTML, JavaScript и другие файлы, которые предоставляют функциональные возможности и пользовательский интерфейс надстройки.
При разработке надстройки можно запускать надстройку на локальном веб-сервере (localhost
), но если вы готовы опубликовать ее для доступа других пользователей, вам потребуется развернуть веб-приложение на веб-сервере или в службе веб-хостинга (например, в Microsoft Azure) и изменить манифест, указав URL-адрес разворачиваемого приложения.
Если надстройка работает нужным образом и вы готовы опубликовать ее для доступа других пользователей, выполните следующие действия.
В командной строке корневого каталога проекта вашей надстройки выполните следующую команду, чтобы подготовить все файлы для рабочего развертывания.
npm run build
После завершения сборки папка dist в корневом каталоге проекта надстройки будет содержать файлы, разворачиваемые на следующих этапах.
Отправьте содержимое папки dist на веб-сервер, где будет размещена ваша надстройка. Вы можете использовать любой тип веб-сервера или службу веб-хостинга для размещения своей надстройки.
В VS Code откройте файл манифеста надстройки, расположенный в корневом каталоге проекта. Замените все вхождения
https://localhost:3000
URL-адресом веб-приложения, развернутого на веб-сервере на предыдущем этапе.Выберите метод, который вы хотите использовать для развертывания надстройки Office, и следуйте инструкциям по публикации надстройки.
См. также
Office Add-ins