Инструменты и пакеты SDK

  • Статья

Создание и разработка приложения Microsoft Teams с помощью средств, пакетов SDK и библиотек. Теперь корпорация Майкрософт предоставляет комплексную платформу для создания, разработки, тестирования, отладки и публикации приложения Teams, что делает весь процесс эффективным и оптимизированным. Teams предлагает следующую платформу:

Инструменты

Платформа Teams содержит различные инструменты для создания и разработки приложений Teams. Для создания приложения доступны следующие средства:

Инструменты Зачем это нужно? Среда Тестирование и отладка
Набор средств Teams Набор средств Teams упрощает начало разработки приложений для Teams. Вы можете начать с шаблона проекта для распространенных пользовательских приложений, созданных для сценариев организации (LOB), или начать с примера. Экономия времени на настройке с помощью автоматической регистрации и настройки приложений с помощью Visual Studio Code и Visual Studio. Visual Studio Code: JavaScript и TypeScript
Visual Studio: .NET и Blazor		 В Visual Studio Code и Visual Studio
Генератор Yeoman для Teams Генератор Yeoman или YoTeams позволяет создавать приложения Teams с помощью TypeScript и JavaScript на ваших условиях, в предпочитаемом редакторе и без внешних или сетевых зависимостей. TypeScript и JavaScript Н/Д
CLI набора средств Teams TeamsFx CLI — это текстовый интерфейс командной строки (CLI), который ускоряет разработку приложений Teams. Он предназначен для обеспечения работы с клавиатурой при создании приложений Teams. JavaScript и .NET Использование командной строки
Портал разработчика Teams Портал разработчика для Teams — это основной инструмент для настройки, распространения и управления приложениями Teams. С помощью портала разработчика можно создать базовый манифест приложения (ранее известный как манифест приложения Teams) и распространить приложение в Teams. Поддерживает все языки Портал разработчиков Teams

Дополнительные сведения о создании приложения Teams с помощью набора средств Teams и проекта Yeoman Teams.
  Набор средств Teams Проект Yeoman Teams
Переменные среды Использовать .env файл Использовать .env файл
Создание манифеста Набор средств Teams автоматически создается при создании проектов. манифест gulp
Развертывание приложения Teams Команда автоматического обновления использования Teams: Update Teams App клиент gulp: развертывание
Создание приложения Microsoft Entra Автоматическое создание при отладке или подготовке проекта. Пользователи также могут использовать существующее приложение Microsoft Entra, заполнив идентификатор приложения Teams в .env файле. Вручную
Добавление единого входа Предоставьте примеры с поддержкой единого входа и практические руководства по добавлению единого входа. Вручную
Регистрация бота или расширения сообщений Автоматическое создание при отладке или подготовке проекта. Пользователь также может указать собственный идентификатор бота. Вручную (Azure Bot)
Предоставление Node.js приложения Вкладка: localhost + HTTPS и другие: Dev Tunnel gulp ngrok-serve
Запуск приложения Node.js npm run teamsfx:dev gulp serve
Отладка одним щелчком F5 или отладка в Visual Studio Code и Visual Studio Н/Д

Пакеты SDK и библиотеки

Платформа Teams предоставляет различные пакеты SDK, библиотеки и API для создания и разработки приложений Teams.

На следующей схеме описаны различные пакеты SDK, библиотеки и их связи:

Снимок экрана: список всех средств и пакетов SDK, доступных для создания приложений Teams.

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

Пакеты SDK для платформы разработчиков Teams & библиотеки

Пакеты SDK и библиотеки Зачем это нужно? Связанные пакеты SDK и библиотеки
Пакет SDK TeamsFx TeamsFx упрощает задачи, используя единый вход Teams и доступ к облачным ресурсам в однострочных инструкциях с нулевой конфигурацией. Зависит от пакета SDK Bot Framework, клиентской библиотеки JavaScript для Teams и пакета SDK Microsoft Graph.
Его можно использовать с библиотекой ИИ Teams и адаптивными карточками.
Клиентская библиотека JavaScript для Teams Клиентская библиотека Teams JavaScript (TeamsJS) позволяет создавать размещенные интерфейсы в Teams, приложении Microsoft 365 и Outlook. Эти возможности включают размещение содержимого приложения в iFrame. Вы можете передать ссылку в SharePoint Framework (SPFx).
Его можно использовать с microsoft Graph SDK, адаптивными карточками и компонентами Fluent UI React.
SharePoint Framework (SPFx) SharePoint Framework (SPFx) предлагает модель страниц и веб-частей, которая полностью поддерживает разработку SharePoint на стороне клиента, легко интегрируется с данными SharePoint и расширяет возможности Microsoft Teams и Microsoft Viva. Его можно использовать с microsoft Graph SDK, адаптивными карточками и компонентами Fluent UI React.
На основе REST API SharePoint.
Пакет SDK Live Share Live Share — это пакет SDK, созданный для того, чтобы превратить приложения Teams в совместную работу с несколькими пользователями без необходимости написания выделенного внутреннего кода. Его можно использовать с microsoft Graph SDK, адаптивными карточками и компонентами Fluent UI React.
Вы можете передать ссылку на клиентскую библиотеку JavaScript Teams.

Основные пакеты SDK и библиотеки для создания приложения Teams

Пакеты SDK и библиотеки Зачем это нужно? Связанные пакеты SDK и библиотеки
Bot Framework SDK Microsoft Bot Framework и Служба Azure AI Bot — это коллекция библиотек, инструментов и служб, которые позволяют создавать, тестировать, развертывать интеллектуальных ботов и управлять ими. Bot Framework включает модульный расширяемый пакет SDK для создания ботов и подключения к службам ИИ. На основе службы Azure Bot.
Пакеты SDK Microsoft Graph Пакеты SDK Microsoft Graph предназначены для упрощения создания высококачественных, эффективных и устойчивых приложений, которые обращаются к Microsoft Graph. Пакеты SDK включают два компонента, такие как библиотека служб и базовая библиотека. На основе Microsoft Graph.
Библиотека ИИ Teams Библиотека ИИ Teams — это ориентированный на Teams интерфейс для общих языковых моделей на основе GPT и обработчиков намерений пользователей. Это снижает потребность в выполнении сложных и дорогостоящих задач по написанию и поддержанию логики бота для диалога для интеграции с крупными языковыми моделями (LLM). Зависит от пакета SDK Bot Framework.
На основе Azure OpenAI.

Дополнительные библиотеки и служебные программы пользовательского интерфейса для создания приложений Teams

Пакеты SDK и библиотеки Зачем это нужно? Связанные пакеты SDK и библиотеки
Адаптивные карточки Адаптивная карточка — это настраиваемая карточка, которая может содержать любое сочетание текста, речи, изображений, кнопок и полей ввода. Его можно использовать с пакетом SDK TeamsFx, клиентской библиотекой JavaScript для Teams и SharePoint Framework (SPFx).
Компоненты Fluent UI React Компоненты Fluent UI React представляют собой коллекцию элементов и средств пользовательского интерфейса, которые поступают в результате объединения различных библиотек компонентов на основе React, используемых в рабочей среде, таких как @fluentui/react и @fluentui/react-northstar. Его можно использовать с клиентской библиотекой JavaScript для Teams и SharePoint Framework (SPFx).
Fluid Framework Fluid Framework состоит из клиентских библиотек, которые помогают распределять и синхронизировать общее состояние. Эти библиотеки позволяют нескольким клиентам одновременно создавать и работать с общими структурами данных, используя шаблоны кодирования, аналогичные тем, которые используются для работы с локальными данными. Вы можете передать ссылку на пакет SDK для Live Share.
На основе Azure Fluid Relay.

Службы и API, защищенные идентификаторами Microsoft Entra

Пакеты SDK и библиотеки Зачем это нужно? Связанные пакеты SDK и библиотеки
Службы Azure Bot Служба Azure Bot — это коллекция библиотек, инструментов и служб, которые позволяют создавать, тестировать, развертывать интеллектуальных ботов и управлять ими. Используется для пакета SDK Bot Framework.
Azure OpenAI Служба Azure OpenAI предоставляет доступ к REST API к мощным языковым моделям OpenAI, включая серии моделей GPT-3, Codex и Embeddings. Кроме того, новая серия моделей GPT-4 и ChatGPT (gpt-35-turbo) теперь доступна в предварительной версии. Эти модели можно адаптировать к конкретной задаче, включая, помимо прочего, создание контента, формирование сводных данных, семантический поиск и перевод кода на естественном языке. Используется для библиотеки ИИ Teams.
Microsoft Graph Microsoft Graph открывает доступ к данным и средствам искусственного интеллекта в Microsoft 365. Благодаря этому вы получите единую модель программируемости, которую можно использовать для доступа к колоссальному объему данных в Microsoft 365, Windows и Enterprise Mobility + Security. Используйте многочисленные данные в Microsoft Graph и создавайте приложения с миллионной аудиторией для организаций и пользователей. Используется для пакета SDK для Microsoft Graph.
REST API SharePoint Вы можете удаленно взаимодействовать с данными SharePoint с помощью любой технологии, поддерживающей веб-запросы REST. С помощью интерфейса REST для SharePoint можно выполнять операции создания, чтения, обновления и удаления (CRUD). Используется для SharePoint Framework (SPFx).
Azure Fluid Relay Fluid Framework — это платформа, независимая от платформы с открытым кодом. Azure Fluid Relay — это управляемая служба для Fluid Framework, которая помогает разработчикам создавать возможности для совместной работы в режиме реального времени и реплицировать состояния между подключенными клиентами JavaScript в режиме реального времени. Используется для Fluid Framework.

Рекомендации

Средство Подробно
Набор средств Teams Мы рекомендуем использовать Набор средств Teams версии 5 для создания приложений, так как Набор средств Teams версии 4 доступен только с ограниченными возможностями.
CLI набора средств Teams Мы рекомендуем использовать teams Toolkit CLI версии 3 , так как TeamsFx CLI версии 1 и TeamsFx CLI версии 2 доступны только с ограниченными возможностями.