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

  • Статья

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

Примечание.

Сведения об использовании Visual Studio для создания надстроек Office см. в статье Разработка надстроек Office в Visual Studio.

Необходимые компоненты

Создание проекта надстройки с помощью генератора 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.

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

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

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

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

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

    npm run build

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

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

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

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

См. также