22
24

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 3 years have passed since last update.

VS Code の拡張機能、Teams Toolkit を使ってマイクロソフト Teams のアプリを開発しよう

Last updated at Posted at 2021-08-06

みなさん、いかがお過ごしでしょうか👋

前回の Microsoft Teams 開発者プラットフォームに関連する記事では、TabBot、そしてメッセージ拡張機能といった機能を構築する方法を紹介しました。それらのチュートリアルでは Teams アプリ機能の種類や概念についてに焦点をあてるために App Studio を使用し、手動で最小限のローカル環境のみをセットアップする方法をとりました。

今回のチュートリアルでは、最近リリースされた開発者ツールを使っての開発方法を紹介したいと思います。
toolkit-cover-1000x420.png
この VS Code 用の Teams Toolkit (プレビュー版)を使うと複雑な Teams アプリを構築するのに必要な、統合されたアイデンティティ、クラウド ストレージへのアクセス、Microsoft Graph からのデータ取得、および Azure および M365 の他のサービスを使用することが以前よりラクにできるようになります。

さて、開始する前にまず必要な作業環境の準備ができているかチェックしましょう。

📓 始める前に

まず、チーム クライアントでカスタム アプリを「サイドロード」できるかどうかを確認します。開始する前にカスタム Teams アプリを有効にするをオンにし、カスタム アプリのアップロードを有効にします。

または、無料の Microsoft 365 開発者プログラムにサインアップして、サンプル データ パックが付属された開発者テナントのサンドボックスを取得してください。

そして最新バージョンの Visual Studio Code を入手してください。(以前のバージョンでは、ツールキットでは動作しない場合があります)。

🖥 Teams Toolkit のインストール

まず、VS Code を起動し、Teams アプリの開発に役立つ拡張機能をインストールしていきましょう。

左側のアクティビティバーの拡張機能アイコンを選択し、Microsoft Teams ツールキットをインストールします。2 つの異なるバージョンのチーム、ツールキットが表示される場合は、このチュートリアルで使う「プレビュー」バージョン 2.x を選択してください。
vscode-teams-toolkit2-install.png

🔧 オプションツール

Teams ツールキット拡張機能は、必要に応じて以下のツールが自動的にインストールされます。ただし、Linux (WSL を含む) を使用する場合は、次のツールを自分でインストールしてから使用する必要があります。

🧰 ツールキットで新規プロジェクトの作成をする

Microsoft Teams 左側のアクティビティバーのアイコンを選択し Create New Project をクリックし新しいプロジェクトの作成を開始します。そしてポップアップされるメニューから、Create a new Teams app を選択します。
vscode-teams-toolkit2-new-project.png

Select capabilities セクションで機能を選択します。このチュートリアルでは、Bot のみを選択して Tab を選択解除し、OKを選択します。
vscode-teams-toolkit2-bot.png

Bot registration セクションで、Create a new bot registration を選択し、新規ボットの登録をします。
vscode-teams-toolkit2-bot-registration.png

Programming Language セクションで、JavaScript を選択します。
vscode-teams-toolkit2-javascript.png

次にワークスペースを選択します。プロジェクトのワークスペース内に新しいフォルダが作成されます。
vscode-teams-toolkit2-workspace.png

アプリの名前を入力してください。
vscode-teams-toolkit2-name.png
設定にはしばらく時間がかかりますのでしばらく待ちましょう。

このプロセスでツールキットが自動的に次のことをしています:

  • M365 テナント内での Azure アクティブ ディレクトリ アプリケーションの登録
  • アプリ マニフェストの作成
  • アプリをサポートするために Azure Functions コア ツールを使用して API をローカルで実行
  • ローカルホストからチームクライアントへのセキュアなトンネルを提供する ngrok のインストールと設定

🤖 サンプルボットをローカルで実行する

プロジェクトを設定したら、テンプレート アプリがどのようなものか見ていきましょう。
vscode-teams-toolkit2-code.png

まず詳しく見ていく前に、先にこのサンプル アプリをビルドしてローカルで実行しましょう。

キーボードの F5 キーを押してデバッグ モードを有効にします。

もしくは、このようにサイドメニューからデバッグアイコンをクリックします。
vscode-teams-toolkit2-run.png
アプリが初めてビルドされる際には、すべての依存関係がダウンロードされますので完了までに数分かかる場合があります。

完了すると、チームの Web クライアントが自動的にブラウザー ウィンドウで開かれます。Add をクリックしてローカルにインストールします。
vscode-teams-toolkit2-app-install.png

アプリをインストールしたら、 Bot を試してみましょう。
vscode-teams-toolkit2-app-running.png

🔏 ユーザー権限の付与

この Bot 用の show コマンドを試してみると、アプリが次のように情報を表示する許可を求めることがわかります。
vscode-teams-toolkit2-app-graph.png

続行 (Continue) をクリックすると、認証画面が開きます。
vscode-teams-toolkit2-app-graph-auth.png

つまり、アプリ (およびサードパーティ製アプリ) は、ユーザーの同意なしではユーザーの情報を自動的に取得することはできないのです。


次のチュートリアルでは、ユーザー情報にアクセスする Microsoft Graph について説明し、チームの実装方法について説明しますので、ご期待👋

🇺🇸 この記事は先に英語で書いたものを和訳しています。原文(英語)で読みたいという方は dev.to のリンクからどうぞ!

22
24
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
22
24

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?