Руководство разработчика надстроек VSTO по веб-надстройкам Office
Итак, вы создали несколько надстроек VSTO для приложений Office, работающих в Windows, и теперь вы изучаете новый способ расширения Office, который будет работать в Windows, Mac и версии веб-браузера набора Office: Веб-надстройки Office.
Важно!
Надстройки COM и VSTO не поддерживаются в новой предварительной версии Outlook для Windows . Эти надстройки по-прежнему поддерживаются в классическом классическом клиенте Outlook для Windows. Дополнительные сведения см. в статье Разработка надстроек Outlook для новых приложений Outlook в Windows (предварительная версия).
Ваше понимание объектных моделей в Excel, Word и других приложениях Office очень поможет, так как объектные модели в веб-надстройках Office используют похожие шаблоны. Но вы столкнетесь с некоторыми препятствиями:
- Вы будете работать с другим языком (JavaScript или TypeScript) вместо C# или Visual Basic .NET. (Существует также способ, описанный далее, для повторного использования существующего кода в веб-надстройке.)
- Развертывание веб-надстроек Office отличается от развертывания надстроек VSTO.
- Веб-надстройки Office — это веб-приложения, которые выполняются в упрощенном элементе управления webview, встроенном в приложение Office, поэтому необходимо получить базовое представление о веб-приложениях и их размещении на веб-серверах или в облачных учетных записях.
По этим причинам большая часть этой статьи дублирует руководство по расширениям Office для начинающих. Мы добавили некоторые учебные ресурсы, которые помогут разработчикам надстроек VSTO использовать свой опыт, а также помочь им повторно использовать существующий код.
Шаг 0. Необходимые условия
- Веб-надстройки Office (другое название — надстройки Office) по сути являются веб-приложениями, внедренными в Office. Таким образом, сначала необходимо иметь базовое представление о веб-приложениях и их размещении в Интернете. Об этом доступно огромное количество информации в Интернете, книгах и онлайн-курсах. Если у вас нет знаний о веб-приложениях, можно начать поиск по запросу "Что такое веб-приложение?" в поисковой системе.
- Основным языком программирования, используемым при создании надстроек Office, является JavaScript или TypeScript. Если вы не знакомы с этими языками, но у вас есть опыт работы с VBA, VB.NET, C#, возможно, вам будет проще изучать TypeScript. Опять же, есть много информации об этих языках в Интернете, книгах и онлайн-курсах.
Шаг 1. Начните с основ
Мы знаем, что вам не терпится начать программирование, но есть некоторые вещи о надстройках Office, которые вы должны прочитать, прежде чем открывать свою IDE или редактор кода.
- Обзор платформы надстроек Office: узнайте, что такое надстройки Office Web и чем они отличаются от более старых способов расширения Office, таких как надстройки VSTO.
- Разработка надстроек Office. Ознакомьтесь с обзором разработки и жизненного цикла надстроек Office, включая инструменты, создание пользовательского интерфейса надстройки и использование API-интерфейсов JavaScript для взаимодействия с документом Office.
В этих статьях есть много ссылок, но если вы переходите к веб-надстройкам Office, рекомендуем вам вернуться сюда после их прочтения и продолжить со следующего раздела.
Шаг 2. Установите инструменты и создайте свою первую надстройку.
Теперь у вас есть общая картина, так что погрузитесь с одним из наших быстрых стартов. В целях изучения платформы мы рекомендуем быстрый запуск Excel. Существует версия, основанная на Visual Studio, и другая версия, основанная на Node.js и Visual Studio Code. Если вы переходите с надстроек VSTO, скорее всего, вам будет удобнее работать с версией Visual Studio.
Шаг 3. Код
Вы не можете научиться водить, читая руководство пользователя, поэтому начните программировать с этого учебника Excel. Вы будете использовать библиотеку Office JavaScript и немного XML в манифесте надстроек. Нет необходимости запоминать что-либо, потому что на следующем шаге будет представлен их дополнительный обзор.
Шаг 4. Знакомство с библиотекой JavaScript
Получите общую картину библиотеки JavaScript для Office с помощью учебника Общие сведения об API JavaScript для Office из учебного курса Microsoft Learn.
Затем изучите API JavaScript для Office с помощью средства Script Lab — песочницы для запуска и изучения API.
Специальный ресурс для разработчиков надстроек VSTO
Это отличный момент для знакомства с примером надстройки JavaScript SalesTracker для Excel. Она была создана для выделения похожих элементов и различий между надстройками VSTO и веб-надстройками Office, а в файле сведений примера указываются важные моменты сравнения.
Шаг 5. Знакомство с манифестом
Получите представление о целях манифеста веб-надстройки и общие сведения о его XML-разметке или JSON в манифесте надстроек Office.
Шаг 6 (только для разработчиков VSTO). Повторное использование кода VSTO
Вы можете повторно использовать некоторые фрагменты кода надстроек VSTO в веб-надстройках Office, перенося их в серверную часть своего веб-приложения и предоставляя к ним доступ для JavaScript или TypeScript в виде веб-API. В качестве инструкций см. документ Руководство. Обмен кодом между надстройкой VSTO и надстройкой Office с использованием общей библиотеки кода.
Дальнейшие действия
Поздравляем с окончанием схемы обучения разработчиков надстроек VSTO для веб-надстроек Office! Вот несколько предложений для дальнейшего изучения нашей документации:
Учебные материалы и краткое руководство для других приложений Office.
Другие важные темы:
Office Add-ins
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по