Создание проектов надстроек Office с помощью генератора Yeoman

Генератор Yeoman для надстроек Office (также называется Yo Office) — это интерактивное средство командной строки на основе Node.js, которое создает проекты разработки надстроек Office. Эти проекты основаны на Node.js. Если требуется, чтобы серверный код надстройки был в . Язык на основе NET (например, C# или VB.Net) или вы хотите, чтобы надстройка размещалась на сервере IIS, используйте Visual Studio для создания надстройки.

Проекты, создаваемые средством, имеют следующие характеристики.

• Они имеют стандартную конфигурацию npm , которая включает package.json файл.
• Они включают несколько полезных скриптов для сборки проекта, запуска сервера, загрузки неопубликованных надстроек в Office и других задач.
• Они используют webpack в качестве средства упаковки и базового средства выполнения задач.
• В режиме разработки они размещаются на localhost с помощью webpack-dev-server на основе Node.js webpack, ориентированной на разработку версии сервера Express , поддерживающей горячую перезагрузку и повторную компиляцию при изменении.
• По умолчанию все зависимости устанавливаются средством, но установку можно отложить с помощью аргумента командной строки.
• Они включают полный манифест надстройки.
• У них есть надстройка уровня "Hello World", которая готова к запуску сразу после завершения работы средства.
• Они включают polyfill и транспилер, настроенный для транспиля typeScript и последних версий JavaScript в ES5 JavaScript. Эти функции гарантируют, что надстройка поддерживается во всех средах выполнения webview, в которых могут выполняться надстройки Office, включая Trident (интернет-Обозреватель).

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

• 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.

Использование средства

Запустите средство с помощью следующей команды в системной строке (не в окне bash). При этом будет создан новый проект в новой папке в текущем каталоге.

yo office 

Много необходимо загрузить, поэтому может потребоваться 40 секунд, прежде чем средство запустится. Средство задает ряд вопросов. Для некоторых просто введите ответ на запрос. Для других вы получите список возможных ответов. Если указан список, используйте клавиши со стрелками вверх и стрелка вниз, чтобы выбрать его, а затем нажмите клавишу ВВОД.

Первый вопрос задает вам выбор между несколькими типами проектов. Доступны следующие варианты:

• Проект области задач надстройки Office
• Excel, PowerPoint и (или) Word области задач с унифицированным манифестом для Microsoft 365 (предварительная версия)
• Проект области задач надстройки Office с использованием платформы React
• Пользовательские функции Excel с использованием общей среды выполнения
• Пользовательские функции Excel с помощью среды выполнения, доступной только для JavaScript
• Проект области задач надстройки Office, поддерживающий единый вход
• Проект области задач надстройки Office с поддержкой единого входа вложенной проверки подлинности приложений (предварительная версия)
• Проект надстройки Office, содержащий только манифест

Следующий вопрос задает выбор между TypeScript и JavaScript. (Этот вопрос пропускается, если вы выбрали параметр только манифест в предыдущем вопросе.)

Затем вам будет предложено присвоить надстройке имя. Указанное имя будет использоваться в манифесте надстройки, но его можно изменить позже. Это также имя папки для проекта.

Затем вам будет предложено выбрать приложение Office, в котором должна работать надстройка. На выбор можно выбрать шесть приложений: Excel, OneNote, Outlook, PowerPoint, Project и Word. Необходимо выбрать только один, но позже вы можете изменить манифест для поддержки дополнительных приложений Office. Исключением является Outlook. Манифест, поддерживающий Outlook, не может поддерживать любое другое приложение Office.

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

Ответив на все вопросы, генератор создает проект и устанавливает зависимости. Сообщения WARN могут отображаться в выходных данных npm на экране. Их можно игнорировать. Вы также можете увидеть сообщения об обнаружении уязвимостей. Вы можете игнорировать их сейчас, но в конечном итоге вам потребуется исправить их, прежде чем надстройка будет выпущена в рабочую среду. Чтобы получить дополнительные сведения об устранении уязвимостей, откройте браузер и выполните поиск по запросу "уязвимость npm".

В случае успешного создания в командном окне появится сообщение Поздравляем! , за которым следуют некоторые рекомендуемые дальнейшие действия. (Если вы используете генератор в рамках краткого руководства или краткого руководства, проигнорируйте следующие действия в командном окне и выполните инструкции, приведенные в этой статье.)

yo office --skip-install

Параметр только манифеста

Этот параметр создает только манифест для надстройки. Результирующий проект не имеет Hello World надстройки, скриптов или зависимостей. Используйте этот параметр в следующих сценариях.

• Вы хотите использовать другие средства, отличные от тех, которые по умолчанию устанавливает и настраивает проект генератора Yeoman. Например, вы хотите использовать другой пакетировщик, транспилер, средство выполнения задач или сервер разработки.
• Вы хотите использовать платформу разработки веб-приложений, кроме React, например Vue.

Word, PowerPoint или Excel с параметром унифицированного манифеста

Унифицированный манифест для Microsoft 365 доступен в предварительной версии для надстроек Excel, PowerPoint и Word. Его не следует использовать для рабочих надстроек, но вы можете выбрать этот параметр в Yo Office, чтобы создать надстройку для одного (или всех трех) из этих приложений Office. Вам будет предложено выбрать приложение Office. Вы также можете выбрать все , чтобы создать надстройку, которую можно установить во всех трех приложениях Office. Созданный проект использует TypeScript.

Использование параметров командной строки

Вы также можете добавить параметры в yo office команду . Наиболее распространенные из них:

• yo office --details: выводятся краткие сведения обо всех остальных параметрах командной строки.
• yo office --skip-install: это помешает генератору установить зависимости.

Подробные сведения о параметрах командной строки см. в файле сведений для генератора на сайте генератора Yeoman для надстроек Office.

Устранение неполадок

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