Teams アプリパッケージ

2025-05-16

アプリパッケージは、Teams でアプリをインストールして実行するために必要なリソースを含むファイル形式であり、次のファイルが含まれている必要があります。

アプリマニフェスト: アプリの機能、必要なリソース、その他の重要な属性など、アプリの構成方法について説明します。
アプリアイコン: 各パッケージには、アプリの色とアウトラインアイコンが必要です。
カスタムアクティビティアイコン: アクティビティフィード通知で使用できるカスタマイズされたアイコン。

Microsoft Teams アプリを発行するには、アプリパッケージフォルダー内のファイルを圧縮し、適切な名前を指定する必要があります。

Teams でアプリがホストされない

ユーザーが Teams にアプリをインストールすると、構成ファイル (アプリマニフェストとも呼ばれます) とアプリのアイコンのみを含むアプリパッケージがインストールされます。アプリのロジックとデータストレージは、開発中の localhost や運用環境の Microsoft Azure など、他の場所でホストされます。 Teams は HTTPS 経由でこれらのリソースにアクセスします。

Teams アプリのアプリホスティングを示す図

注:

Microsoft Teams JavaScript クライアントライブラリ (TeamsJS) は、Teams、Microsoft 365 アプリ、Outlook でホストされているエクスペリエンスを作成するのに役立ちます。サーバー側アプリパッケージを作成するときは、バージョン 2.31.0 では TeamsJS ライブラリが完全にツリーシェイク可能であることに注意する必要があります。ツリーの揺れは、未使用のコードを排除する JavaScript 最適化です。詳細については、「 JavaScript ツリーの揺れによる読み込み時間のパフォーマンスの向上」を参照してください。

アプリマニフェスト

アプリマニフェストは、アプリの構成について説明します。これには、その機能、必要なリソース、その他の重要な属性と、アプリパッケージに manifest.json という名前が含まれます。

アプリを作成し、次のいずれかのプラットフォームを使用してアプリマニフェストを構成できます。

Teams Toolkit: アプリを作成、デバッグ、デプロイするための Microsoft Visual Studio Code と Visual Studio の一連のツールと拡張機能。アプリを作成すると、選択した機能に基づいてテンプレートファイルからアプリマニフェストが生成されます。その後、要件に基づいて Visual Studio Code または Visual Studio でカスタマイズし、マニフェストファイルを検証し、アプリパッケージを圧縮できます。
Teams 用開発者ポータル: アプリの作成、アプリマニフェストの構成、アプリパッケージの生成に役立つ Web ベースのプラットフォーム。 Teams 用開発者ポータルを使用してアプリを作成するには、「アプリの作成と登録」を参照してください。

ボット、タブ、メッセージ拡張機能、その他の機能をアプリに追加するには、アプリマニフェストを必要なアプリ機能で更新します。詳細については、「アプリ機能を使用したアプリのビルド」を参照してください。

アプリを Microsoft Teams ストアに発行するときは、アプリマニフェストが最新のアプリマニフェストスキーマを参照していることを確認します。サンプルアプリマニフェストについては、「 Hello world サンプルアプリ」を参照してください。

アプリのアイコン

アプリパッケージには、アプリアイコンの 2 つの .png バージョン (色とアウトラインバージョン) を含める必要があります。

注:

アプリにボットまたはメッセージ拡張機能がある場合、アイコンは Microsoft Azure Bot Service登録に含まれます。

アプリが Teams ストアのレビューに合格するには、これらのアイコンが次のサイズ要件を満たしている必要があります。

カラーアイコン

Teams: アイコンのカラーバージョンは、ほとんどの Teams シナリオで表示され、192x192 ピクセルである必要があります。アイコン記号 (96 x 96 ピクセル) は任意の色にすることができますが、単色または完全に透明な正方形の背景に配置する必要があります。

Teams では、アイコンが自動的にトリミングされ、複数のシナリオで角が丸い四角形とボットシナリオの六角形が表示されます。詳細を失わずにシンボルをトリミングするには、シンボルの周囲に 48 ピクセルのパディングを含める必要があります。
Outlook と Microsoft 365 (プレビュー): 32x32 色のアイコンと透明な背景を指定して、Outlook と Microsoft 365 でアプリを実行するときに一貫した外観を確保できます。指定しない場合は、角を丸めた縮小された色のアイコン (場合によっては不透明な背景) が使用されます。これは、ホスト環境と同じ外観を共有しない可能性があります。

Microsoft 365 ホストアプリケーション	シナリオ	必須
Teams	ほとんどの Teams シナリオで表示され、192 x 192 ピクセルである必要があります。	✔️
Outlook と Microsoft 365 (プレビュー)	Outlook または Microsoft 365 でアプリがピン留めされている場合。

アウトラインアイコン

アウトラインアイコンは、次の 2 つのシナリオで表示されます。

アプリが使用中の場合。
アプリが Teams の左側のアプリバーにピン留めされている場合。

アウトラインアイコンのデザインについては、次の仕様に従ってください。
- アイコンのサイズは 32 x 32 ピクセルにする必要があります。
- アイコンはエンタープライズセーフである必要があります。
- アイコンは、透明な背景を持つ白または白い背景で透明にする必要があります。他の色は使用できません。
- アウトラインアイコンには、シンボルの周囲に追加のパディングを含めることはできません。
- アイコンをランダムまたは無関係にすることはできません。通知の情報と一致させる必要があります。
- アイコンはアクセシビリティに優れたデザインである必要があります。