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

  • Статья

Основным инструментом для разработки приложений Teams является Набор средств Teams. Вы можете создавать надстройки Office с помощью набора средств Teams со следующими ограничениями.

  • Надстройки, созданные с помощью набора средств Teams, используют унифицированный манифест для Microsoft 365.

  • В настоящее время можно создавать только надстройки Outlook. Мы прилагаем все усилия, чтобы включить поддержку в наборе средств Teams для надстроек для других приложений и платформ Office.

    Примечание.

    Надстройки Office, использующие единый манифест Microsoft 365, поддерживаются непосредственно в Office в Интернете, в новом Outlook для Windows и в Office для Windows, подключенных к подписке Microsoft 365 версии 2304 (сборка 16320.00000) или более поздней.

    Если пакет приложения, содержащий унифицированный манифест, развертывается в AppSource или Центре администрирования Microsoft 365 , то, если манифест имеет допустимое свойство alternateIcons, из единого манифеста создается только манифест надстройки и сохраняется. Только этот манифест надстройки позволяет устанавливать надстройку на платформах, которые не поддерживают унифицированный манифест напрямую, включая Office для Mac, Office на мобильных устройствах, версии Office для Windows по подписке до 2304 (сборка 16320.00000) и бессрочные версии Office в Windows.

Установите последнюю версию набора средств Teams в Visual Studio Code, как описано в разделе Установка набора средств Teams.

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

  1. Откройте Visual Studio Code и выберите значок Teams Toolkit на панели действий.

    Значок набора средств Teams.

  2. Выберите Создать приложение.

  3. В раскрывающемся списке Новый проект выберите Надстройка Outlook.

    Четыре параметра в раскрывающемся списке Новый проект. Четвертый вариант называется надстройкой Outlook.

  4. В раскрывающемся списке Функции приложения с помощью надстройки Outlook выберите Область задач.

    Два параметра в раскрывающемся списке Функции приложения с помощью надстройки Outlook. Выбран первый параметр

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

  6. При появлении запроса присвойте проекту имя (без пробелов). Teams Toolkit создаст проект с базовыми файлами и шаблонами. Затем проект откроется во втором окне Visual Studio Code. Закройте исходное окно Visual Studio Code.

  7. В visual Studio Code TERMINAL перейдите к корню проекта и запустите npm install.

  8. Перед внесением изменений в проект убедитесь, что можно загрузить неопубликованную надстройку Outlook из Visual Studio Code. Выполните следующие действия.

    1. Убедитесь, что ваша учетная запись в клиенте разработчика Microsoft 365 также является учетной записью электронной почты в классической версии Outlook. Если это не так, следуйте указаниям в статье Добавление учетной записи электронной почты в Outlook.
    2. Закройте рабочий стол Outlook.
    3. В Visual Studio Code откройте Набор средств Teams.
    4. В разделе УЧЕТНЫе записи убедитесь, что вы вошли в Microsoft 365.
    5. Выберите ViewRun in Visual Studio Code (Просмотреть | запуск в Visual Studio Code). В раскрывающемся меню ЗАПУСК И ОТЛАДКА выберите параметр Outlook Desktop (Edge Chromium) и нажмите клавишу F5. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут. Со временем откроется рабочий стол Outlook.
    6. Откройте папку "Входящие"удостоверения учетной записи Microsoft 365 и откройте любое сообщение. Вкладка Надстройка Contoso с двумя кнопками появится на ленте Главная (или на ленте Сообщение , если вы открыли сообщение в собственном окне).
    7. Нажмите кнопку Показать область задач , и откроется область задач. Нажмите кнопку Выполнить действие , и в верхней части сообщения появится небольшое уведомление.
    8. Чтобы остановить отладку и удалить надстройку, выберите Запустить | остановить отладку в Visual Studio Code.

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