Share via

ツールと SDK

  • [アーティクル]

ツール、SDK、およびライブラリを使用して、Microsoft Teams アプリをビルドして開発します。 現在、Microsoft は、Teams アプリをシームレスに作成、開発、テスト、デバッグ、発行するための包括的なプラットフォームを提供し、プロセス全体を効率的かつ合理化します。 Teams には、次のプラットフォームが用意されています。

ツール

Teams プラットフォームには、Teams アプリを構築および開発するためのさまざまなツールが用意されています。 アプリをビルドするには、次のツールを使用できます。

ツール なぜ必要なのですか? 環境 テストとデバッグ
Teams ツールキット Teams Toolkit を使用すると、Teams のアプリ開発を簡単に開始できます。 組織 (LOB アプリ) シナリオ用に構築された一般的なカスタム アプリのプロジェクト テンプレートから始めるか、サンプルから開始できます。 Visual Studio Code と Visual Studio を使用した自動アプリの登録と構成により、セットアップにかかる時間を節約できます。 Visual Studio Code: JavaScript と TypeScript
Visual Studio: .NET と Blazor		 Visual Studio Code と Visual Studio で
Teams 用 Yeoman ジェネレーター Yeoman ジェネレーターまたは YoTeams を使用すると、任意のエディターで、外部またはオンラインの依存関係なしで、条件に対して TypeScript と JavaScript を使用して Teams アプリを作成できます。 TypeScript と JavaScript 該当なし
Teams ツールキット CLI TeamsFx CLI は、Teams アプリケーション開発を高速化するテキスト ベースのコマンド ライン インターフェイス (CLI) です。 これは、Teams アプリケーションを構築するときにキーボード中心のエクスペリエンスを提供することを目的としています。 JavaScript と .NET コマンド プロンプトを使用する
Teams の開発者ポータル Teams 用開発者ポータルは、Teams アプリを構成、配布、管理するための主要なツールです。 開発者ポータルでは、基本的なアプリ マニフェスト (以前は Teams アプリ マニフェスト) を作成し、アプリを Teams に配布できます。 すべての言語をサポート Teams の開発者ポータル

Teams Toolkit と Yeoman Teams プロジェクトを使用した Teams アプリの構築に関する詳細。
  Teams ツールキット Yeoman Teams プロジェクト
環境変数 ファイルを使用する.env ファイルを使用する.env
マニフェストの生成 Teams Toolkit は、プロジェクトの作成時に自動生成されます。 gulp マニフェスト
Teams アプリを展開する use コマンドを自動的に更新する Teams: Update Teams App gulp テナント: デプロイ
Microsoft Entra アプリを作成する プロジェクトのデバッグまたはプロビジョニング時に自動的に作成されます。 ユーザーは、ファイルに Teams アプリ ID を入力することで、既存のMicrosoft Entra アプリを.env使用することもできます。 Manual
SSO の追加 SSO 対応のサンプルと、SSO を追加するためのハウツー ガイドを提供します。 Manual
ボットまたはメッセージ拡張機能の登録 プロジェクトのデバッグまたはプロビジョニング時に自動的に作成されます。 ユーザーは、独自のボット ID を指定することもできます。 手動 (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、ライブラリ、およびその関係について説明します。

Teams アプリをビルドするために使用できるすべてのツールと SDK の一覧を示すスクリーンショット。

アプリをビルドするために別のライブラリを必要とするライブラリ。 プロジェクトは自動的に別のライブラリに取り込まれます。
アプリに別のライブラリへの参照を渡すライブラリ。
ライブラリは別のライブラリでよく使用されますが、正式な依存関係はありません。
基になるサービスまたは API であるライブラリ。

Teams 開発者プラットフォーム SDK & ライブラリ

SDK とライブラリ なぜ必要なのですか? 関連する SDK とライブラリ
TeamsFx SDK TeamsFx では、Teams シングル サインオン (SSO) を使用し、構成がゼロの単一行ステートメントにクラウド リソースにアクセスすることで、タスクが簡略化されます。 Bot Framework SDK、Teams JavaScript クライアント ライブラリ、Microsoft Graph SDK によって異なります。
Teams AI ライブラリとアダプティブ カードで使用できます。
Teams JavaScript クライアント ライブラリ 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を拡張するページおよび Web パーツ モデルを提供します。 Microsoft Graph SDK、アダプティブ カード、Fluent UI React コンポーネントで使用できます。
SharePoint REST API に基づく。
Live Share SDK Live Share は、専用のバックエンド コードを記述することなく、Teams アプリを共同作業のマルチユーザー エクスペリエンスに変えるために作成された SDK です。 Microsoft Graph SDK、アダプティブ カード、Fluent UI React コンポーネントで使用できます。
参照を Teams JavaScript クライアント ライブラリに渡すことができます。

Teams アプリを構築するためのコア SDK とライブラリ

SDK とライブラリ なぜ必要なのですか? 関連する SDK とライブラリ
Bot Framework SDK Microsoft Bot Frameworkと Azure AI Bot Serviceは、インテリジェント ボットの構築、テスト、デプロイ、管理を可能にするライブラリ、ツール、サービスのコレクションです。 Bot Framework には、ボットを構築し、AI サービスに接続するためのモジュール式の拡張可能な SDK が含まれています。 Azure Bot Serviceに基づく。
Microsoft Graph SDK Microsoft Graph SDK は、Microsoft Graph にアクセスする高品質で効率的で回復力のあるアプリケーションの作成を簡素化するように設計されています。 SDK には、サービス ライブラリとコア ライブラリなどの 2 つのコンポーネントが含まれています。 Microsoft Graph に基づく。
Teams AI ライブラリ Teams AI ライブラリは、GPT ベースの共通言語モデルとユーザー 意図エンジンへの Teams 中心のインターフェイスです。 これにより、大規模な言語モデル (LLM) と統合するための会話ボット ロジックの記述と保守の複雑でコストのかかるタスクを処理する必要が減ります。 Bot Framework SDK に依存します。
Azure OpenAI に基づく。

Teams アプリをビルドするための追加のライブラリと UI ユーティリティ

SDK とライブラリ なぜ必要なのですか? 関連する SDK とライブラリ
アダプティブ カード カスタマイズができるカードで、テキスト、音声、画像、ボタン、入力フィールドの任意の組み合わせを含めることができます。 TeamsFx SDK、Teams JavaScript クライアント ライブラリ、SharePoint Framework (SPFx) で使用できます。
Fluent UI React コンポーネント Fluent UI React コンポーネントは、運用環境で使用されるさまざまなReact ベースのコンポーネント ライブラリ (など@fluentui/react) を組み合わせた UI 要素と@fluentui/react-northstarツールのコレクションです。 Teams JavaScript クライアント ライブラリとSharePoint Framework (SPFx) で使用できます。
Fluid Framework Fluid Framework は、共有状態の分散と同期に役立つクライアント ライブラリで構成されます。 これらのライブラリを使用すると、複数のクライアントが、ローカル データの操作に使用されるものと同様のコーディング パターンを使用して、共有データ構造を同時に作成および操作できます。 参照を Live Share SDK に渡すことができます。
Azure Fluid Relay に基づく。

Microsoft Entra IDセキュリティで保護されたサービスと API

SDK とライブラリ なぜ必要なのですか? 関連する SDK とライブラリ
Azure Bot Services Azure Bot Serviceは、インテリジェント ボットの構築、テスト、デプロイ、管理を行うライブラリ、ツール、サービスのコレクションです。 Bot Framework SDK に使用されます。
Azure OpenAI Azure OpenAI Service は、GPT-3、Codex、Embeddings モデル シリーズを含む OpenAI の強力な言語モデルへの REST API アクセスを提供します。 さらに、新しいGPT-4とChatGPT(gpt-35-turbo)モデルシリーズがプレビューで利用可能になりました。 これらのモデルは、コンテンツの生成、要約、セマンティック検索、自然言語からコードへの翻訳など、特定のタスクに適応できます。ただし、これらに限定されません。 Teams AI ライブラリに使用されます。
Microsoft Graph Microsoft Graph は、Microsoft 365 のデータとインテリジェンスへの入り口です。 Microsoft Graph は、Microsoft 365、Windows、および Enterprise Mobility + Security の膨大な量のデータにアクセスする際に使用できる統合型プログラミング モデルを提供します。 Microsoft Graph の豊富なデータを使用して、数百万人のユーザーを操作する組織やコンシューマー向けのアプリを作成できます。 Microsoft Graph SDK に使用されます。
SharePoint REST API 表現状態転送 (REST) Web 要求をサポートする任意のテクノロジを使用して、SharePoint データをリモートで操作できます。 SharePoint によって提供される REST インターフェイスを使用して、基本的な作成、読み取り、更新、削除 (CRUD) 操作を実行できます。 SharePoint Framework (SPFx) に使用されます。
Azure Fluid Relay Fluid Framework は、プラットフォームに依存しないオープンソースフレームワークです。 Azure Fluid Relay は Fluid Framework のマネージド サービスであり、開発者がリアルタイムのコラボレーション エクスペリエンスを構築し、接続された JavaScript クライアント間で状態をリアルタイムでレプリケートするのに役立ちます。 Fluid Framework に使用されます。

推奨事項

ツール 詳細
Teams ツールキット Teams Toolkit v5 を使用してアプリをビルドすることをお勧めします。Teams Toolkit v4 は機能が制限されている場合にのみ使用できます。
Teams ツールキット CLI TeamsFx CLI v1 と TeamsFx CLI v2 は限られた機能でのみ使用できるように、Teams Toolkit CLI v3 を使用して Teams アプリをビルドすることをお勧めします。