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

  • Статья

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

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

Примечание.

Унифицированный манифест для Microsoft 365 можно использовать в рабочих надстройках Outlook. Он доступен только в качестве предварительной версии для надстроек Excel, PowerPoint и Word.

Совет

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

Примечание.

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

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

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

Важно!

Вы можете создать надстройку Outlook с помощью последней выпущенной версии Набора средств Teams. Чтобы создать надстройку для Excel, PowerPoint или Word, установите предварительную версию, как описано в разделе Установка предварительной версии. Набор средств создает проекты, использующие унифицированный манифест для Microsoft 365. Поддержка этого манифеста в Excel, PowerPoint и Word доступна только для предварительной версии.

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

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

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

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

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

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

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

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

  5. Если вы делаете надстройку Outlook, в наборе средств отображается раскрывающееся меню Язык программирования . Выберите TypeScript или JavaScript. (Для надстроек Excel, PowerPoint и Word всегда создается проект TypeScript.)

  6. Если вы делаете надстройку Outlook, в наборе средств отображается раскрывающееся меню Framework . Выберите По умолчанию или React. (Для надстроек Excel, PowerPoint и Word всегда создается проект по умолчанию.)

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

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

    Примечание.

    Созданный проект настраивается для установки в Excel, Outlook, PowerPoint и Word. При необходимости можно изменить манифест и исходные файлы, чтобы изменить поддерживаемые приложения Office.

  9. В Visual Studio Code TERMINAL перейдите к корню проекта и выполните команду npm install.

  10. После завершения установки убедитесь, что надстройку можно загрузить из Visual Studio Code. Действия для загрузки неопубликованных приложений зависят от приложения Office, в котором вы хотите протестировать надстройку.

Загрузка неопубликованных приложений в Excel, PowerPoint или Word

Примечание.

Этот раздел применяется только в том случае, если надстройка разрабатывается на компьютере с Windows . Если вы работаете на компьютере Mac, вы можете протестировать надстройку, заверив ее администратором Microsoft 365 как интегрированное приложение в центре Microsoft 365 Admin.

  1. Выберите Просмотр | выполнить в Visual Studio Code. В раскрывающемся меню ЗАПУСК И ОТЛАДКА выберите один из следующих параметров:

    • Excel Desktop (Edge Chromium)
    • PowerPoint Desktop (edge Chromium)
    • Word Desktop (Edge Chromium)

  2. Нажмите клавишу F5. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут. В конечном итоге откроется классическая версия выбранного приложения Office.

    Примечание.

    Если вы впервые загружаете неопубликованную надстройку Office на компьютере (или впервые за месяц), вам может быть предложено удалить старый сертификат и (или) установить новый. Примите оба запроса.

  3. На ленте Главная появится вкладка Надстройка Contoso с двумя кнопками. Используйте одну кнопку, чтобы выполнить действие в открытом документе Office. Используйте другой, чтобы открыть область задач надстройки.

    Примечание.

    Независимо от выбранной кнопки появится запрос WebView Остановить при загрузке . Нажмите OK.

  4. Чтобы остановить отладку и удалить надстройку, выберите Запустить | остановить отладку в Visual Studio Code.

Загрузка неопубликованных приложений в Outlook

  1. Убедитесь, что ваша учетная запись в клиенте разработчика Microsoft 365 также является учетной записью электронной почты в классической версии Outlook. Если это не так, следуйте указаниям в статье Добавление учетной записи электронной почты в Outlook.

  2. Закройте рабочий стол Outlook.

  3. В Visual Studio Code откройте Набор средств Teams.

  4. В разделе УЧЕТНЫе записи убедитесь, что вы вошли в Microsoft 365.

  5. Выберите Просмотр | выполнить в Visual Studio Code. В раскрывающемся меню ЗАПУСК И ОТЛАДКА выберите параметр Outlook Desktop (Edge Chromium) и нажмите клавишу F5. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут, после чего откроется рабочий стол Outlook.

    Примечание.

    Если вы впервые загружаете неопубликованную надстройку Office на компьютере (или впервые за месяц), вам может быть предложено удалить старый сертификат и (или) установить новый. Примите оба запроса.

  6. Откройте папку "Входящие"удостоверения учетной записи Microsoft 365 и откройте любое сообщение. Вкладка Надстройка Contoso с двумя кнопками появится на ленте Главная (или на ленте Сообщение , если вы открыли сообщение в собственном окне).

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

    Примечание.

    Независимо от выбранной кнопки появится запрос WebView Остановить при загрузке . Нажмите OK.

  8. Чтобы остановить отладку и удалить надстройку, выберите Запустить | остановить отладку в Visual Studio Code.

Разработка проекта

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