Настройка среды разработки

Это руководство поможет вам настроить средства для создания надстроек Office, следуя нашим кратким руководствам или руководствам. Если они уже установлены, вы можете приступить к краткому началу работы, например в этом кратком руководстве по Excel React.

Получить Microsoft 365

Вам нужна учетная запись Microsoft 365. Вы можете получить бесплатную 90-дневную возобновляемую подписку На Microsoft 365, которая включает все приложения Office, присоединившись к программе разработчика Microsoft 365.

Установка среды

Существует два типа сред разработки на выбор. Формирование шаблонов проектов надстроек Office, созданных в двух средах, отличается, поэтому если над проектом надстройки будет работать несколько пользователей, все они должны использовать одну и ту же среду.

  • Node.js среде: рекомендуется. В этой среде ваши средства устанавливаются и запускаются в командной строке. Серверная часть веб-приложения надстройки написана на JavaScript или TypeScript и размещается в среде выполнения Node.js. В этой среде существует множество полезных средств разработки надстроек, таких как кодировщик Office и средство выполнения задач или средство выполнения задач WebPack. Средство создания проектов и формирования шаблонов Yo Office часто обновляется.
  • Среда Visual Studio. Выберите эту среду, только если компьютером разработки является Windows, и вы хотите разработать серверную часть надстройки с помощью языка и платформы на основе .NET, например ASP.NET. Шаблоны проектов надстроек в Visual Studio обновляются не так часто, как в среде Node.js. Клиентский код нельзя отлаживать с помощью встроенного отладчика Visual Studio, но вы можете отлаживать клиентский код с помощью средств разработки браузера. Дополнительные сведения см. далее на вкладке среда Visual Studio .

Примечание.

Visual Studio для Mac не включает шаблоны шаблонов проектов для надстроек Office, поэтому, если компьютер разработки является Компьютером Mac, следует работать с Node.js среде.

Выберите вкладку для выбранной среды.

Ниже перечислены основные средства для установки.

  • Node.js
  • npm
  • Редактор кода по вашему выбору
  • Yo Office
  • Код кода JavaScript для Office

В этом руководстве предполагается, что вы знаете, как использовать программу командной строки.

Установка Node.js и npm

Node.js — это среда выполнения JavaScript, используемая для разработки современных надстроек Office.

Установите Node.js , скачав последнюю рекомендуемую версию с веб-сайта. Следуйте инструкциям по установке операционной системы.

npm — это реестр программного обеспечения открытый код, из которого можно скачать пакеты, используемые при разработке надстроек Office. Обычно он устанавливается автоматически при установке Node.js. Чтобы проверить, установлен ли npm и просмотреть установленную версию, выполните следующую команду в командной строке.

npm -v

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

npm install npm -g

Совет

Возможно, вы захотите использовать диспетчер версий Node, чтобы можно было переключаться между несколькими версиями Node.js и npm, но это не обязательно. Дополнительные сведения о том, как это сделать, см. в инструкциях npm.

Установка редактора кода

Для создания веб-частей можно использовать любой редактор кода или интерфейс IDE, поддерживающий клиентскую разработку, например:

Установка генератора Yeoman — Yo Office

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

npm install -g yo generator-office

Установка и использование кода JavaScript для Office

Корпорация Майкрософт предоставляет код JavaScript, помогающий перехватывать распространенные ошибки при использовании библиотеки JavaScript для Office. Чтобы установить код, выполните следующие две команды (после установки Node.js и npm).

npm install office-addin-lint --save-dev
npm install eslint-plugin-office-addins --save-dev

Если вы создаете проект надстройки Office с помощью средства генератора Yeoman для надстроек Office , остальная часть настройки выполняется за вас. Выполните код с помощью следующей команды в терминале редактора, например Visual Studio Code, или в командной строке. Проблемы, обнаруженные анализатором кода, отображаются в терминале или запросе, а также отображаются непосредственно в коде при использовании редактора, поддерживающего сообщения кода, например Visual Studio Code. (Сведения об установке генератора Yeoman см. в разделе Генератор Yeoman для надстроек Office.)

npm run lint

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

  1. В корневой папке проекта создайте текстовый файл с именем .eslintrc.json, если его еще нет. Убедитесь, что у него есть свойства с именами plugins и extends, как для массива типов. Массив plugins должен включать , "office-addins" а extends массив — "plugin:office-addins/recommended". Ниже приведен простой пример. Файл .eslintrc.json может иметь дополнительные свойства и дополнительные члены двух массивов.

    {
      "plugins": [
        "office-addins"
      ],
      "extends": [
        "plugin:office-addins/recommended"
      ]
    }
    
  2. В корневой папке проекта откройте файл package.json и убедитесь, что scripts массив содержит следующий член.

    "lint": "office-addin-lint check",
    
  3. Выполните код с помощью следующей команды в терминале редактора, например Visual Studio Code, или в командной строке. Проблемы, обнаруженные анализатором кода, отображаются в терминале или запросе, а также отображаются непосредственно в коде при использовании редактора, поддерживающего сообщения кода, например Visual Studio Code.

    npm run lint
    

Установка Script Lab

Script Lab — это средство для быстрого создания прототипов кода, которое вызывает API библиотеки JavaScript для Office. Script Lab сама является надстройкой Office и может быть установлена из AppSource на Script Lab. Существует версия для Excel, PowerPoint и Word, а также отдельная версия для Outlook. Сведения об использовании Script Lab см. в статье Изучение API JavaScript для Office с помощью Script Lab.

Дальнейшие действия

Попробуйте создать собственную надстройку или используйте Script Lab, чтобы попробовать встроенные примеры.

Создание надстройки Office

Вы можете быстро создать простую надстройку для Excel, OneNote, Outlook, PowerPoint, Project или Word с помощью 5-минутного краткого руководства по началу работы. Если вы уже ознакомились с кратким руководством и хотите создать более сложную надстройку, воспользуйтесь учебником.

Изучение API с помощью Script Lab

Изучите библиотеку встроенных примеров в Script Lab, чтобы ознакомиться с возможностями API JavaScript для Office.

См. также