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

Пакет средств разработки надстроек Office помогает настроить среду, создать надстройки Office и отлаживать код в упрощенном интерфейсе.

Важно!

Расширение пакета средств разработки надстроек Office поддерживает только создание надстроек, использующих только манифест надстройки. В настоящее время также создаются только надстройки Excel, PowerPoint и Word. Поддержка Outlook находится в разработке, а также дополнительные примеры и другие улучшения. Мы приветствуем любые отзывы, которые у вас есть о средстве. Запросы на проблемы и функции должны отправляться через GitHub в репозитории расширения.

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

• Скачайте и установите Visual Studio Code.
• Node.js (последняя версия LTS). Посетите сайтNode.js , чтобы скачать и установить правильную версию для вашей операционной системы. Чтобы проверить, установлены ли эти средства, выполните команды и npm -v в терминалеnode -v.
• Office, подключенный к подписке Microsoft 365. Вы можете получить подписку Microsoft 365 E5 разработчика в рамках программы microsoft 365 для разработчиков. Дополнительные сведения см. в разделе Вопросы и ответы. Кроме того, вы можете зарегистрироваться для получения бесплатной пробной версии на 1 месяц или приобрести план Microsoft 365.

Установка пакета средств разработки

Вы можете установить пакет средств разработки надстроек Office с помощью расширений в Visual Studio Code или из Visual Studio Code Marketplace.

Visual Studio Code

1. Запуск Visual Studio Code.
2. Выберите Просмотр>расширений или CTRL+SHIFT+X. Вы также можете открыть расширения, выбрав вкладку Расширения на панели действий Visual Studio Code.
3. Введите пакет средств разработки надстроек Office в поле поиска.
4. Выберите Пакет средств разработки надстроек Office. На странице расширения пакета средств разработки надстроек Office, которая отображается в области main, выберите Установить. После успешной установки на панели действий Visual Studio Code появится значок комплекта средств разработки надстроек Office.

Рынок

1. Откройте страницу Комплект средств разработки надстроек Office в Visual Studio Code Marketplace.
2. Выберите Установить на веб-странице. Если появится запрос на то, что для расширения требуется Visual Studio Code, нажмите кнопку Продолжить.
3. Ваш браузер может попросить вас убедиться, что сайт пытается открыть Visual Studio Code. Разрешить открытие Visual Studio Code. Visual Studio Code откроется с файлом сведений о расширении пакета средств разработки надстроек Office.
4. Выберите Установить в Visual Studio Code. После успешной установки на панели действий Visual Studio Code появится значок комплекта средств разработки надстроек Office.

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

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

Создание надстройки на основе шаблона

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

1. Откройте Visual Studio Code и щелкните значок Комплект средств разработки надстроек Office на панели действий.
2. Выберите Создать новую надстройку в области задач расширения.
3. В активном меню быстрого выбора выберите приложение Office для надстройки.
4. Выберите шаблон надстройки из списка доступных шаблонов.
5. Выберите "JavaScript" или "TypeScript" в качестве языка программирования.
6. В открывшемся диалоговом окне Папка рабочей области выберите папку, в которой нужно создать проект.
7. При появлении запроса присвойте проекту имя (без пробелов). Пакет средств разработки надстроек Office создаст проект с базовыми файлами и шаблонами. Затем откроется проект во втором окне Visual Studio Code. Вы можете свободно закрыть исходное окно Visual Studio Code.

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

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

1. Откройте Visual Studio Code и щелкните значок Комплект средств разработки надстроек Office на панели действий.
2. Выберите Просмотреть примеры.
3. Выберите пример, который вы хотите просмотреть.
4. Нажмите кнопку Создать над открытым примером сведений.
5. В открывшемся диалоговом окне Папка рабочей области выберите папку, в которой нужно создать проект. Расширение копирует версию примера в ту папку. Затем откроется проект во втором окне Visual Studio Code. Вы можете свободно закрыть исходное окно Visual Studio Code.

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

Чтобы понять, как надстройка будет работать в приложении Office, используйте пакет средств разработки надстроек Office для запуска и отладки надстройки Office в локальной среде разработки.

Примечание.

Эти шаги совпадают с теми, которые перечислены в Visual Studio Code расширением при создании проекта.

1. Откройте расширение, щелкнув значок Комплект средств разработки надстроек Office на панели действий.
2. Выберите Предварительный просмотр надстройки Office (F5)
3. В меню Быстрый выбор выберите параметр {Office Application} Desktop (Edge Chromium), где "{Office Application}" — это соответствующее приложение, например "Excel" или "Word". Это приведет к запуску надстройки и отладке кода.

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

Прекращение тестирования надстройки Office

Завершив тестирование и отладку надстройки, всегда закрывайте надстройку, выполнив следующие действия. (Закрытие окна приложения Office или веб-сервера не приводит к отмене регистрации надстройки.)

1. Откройте расширение, щелкнув значок Комплект средств разработки надстроек Office на панели действий.
2. Выберите Остановить предварительный просмотр надстройки Office. При этом веб-сервер закрывается и надстройка удаляется из реестра и кэша.
3. Закройте окно приложения Office.

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

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

• Закройте все открытые экземпляры Office.
• Закройте предыдущий веб-сервер, запущенный для надстройки, с помощью параметра Остановить предварительный просмотр пакета средств разработки надстроек Office.

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

Сведения о запуске надстройки на Office в Интернете см. в статье Загрузка неопубликованных надстроек Office в Office в Интернете.

Сведения об отладке в более старых версиях Office см. в статье Отладка надстроек с помощью средств разработчика в устаревшая версия Microsoft Edge.