次の方法で共有

Office アドインをテストする

  • [アーティクル]

この記事では、Office アドインのテスト、デバッグ、トラブルシューティングに関するガイダンスを示します。

クロスプラットフォームおよび複数バージョンの Office をテストする

Office アドインは主要なプラットフォームで実行されるため、ユーザーが Office を実行している可能性のあるすべてのプラットフォームでアドインをテストする必要があります。 これには通常、Office on the Web、Office on Windows (永続的および Microsoft 365 サブスクリプションの両方)、Office on Mac、Office on iOS、および (Outlook アドインの場合) Android 上の Office が含まれます。 ただし、一部のプラットフォームで作業しているユーザーがいないことを確認できる場合もあります。 たとえば、ユーザーが Windows コンピューターとサブスクリプション Office を使用する必要がある会社のアドインを作成する場合、Office on Mac または永続的な Office on Windows をテストする必要はありません。

注:

Windows コンピューターでは、Windows と Office のバージョンによって、アドインで使用されるブラウザーまたは Webview コントロールが決まります。詳細については、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。この記事では、後で簡潔にするために、"ブラウザー コントロール" を使用して "ブラウザーまたは Webview コントロール" を意味します。

Office on the web 用にテストされたアドイン

アドインは、Microsoft Edge (Chromium ベースの WebView2)、Chrome、Safari など、すべての主要な最新のブラウザーを使用して、Office on the web でテストされます。 したがって、 AppSource に送信する前に、これらのプラットフォームとブラウザーでテストする必要があります。 検証の詳細については、「コマーシャル マーケットプレースの認定ポリシー」、特にセクション 1120.3、および Office アドイン アプリケーションと可用性のページを参照してください。

Internet Explorer または Microsoft Edge レガシ (EdgeHTML) で Office on the web が開かなくなりました。 そのため、AppSource では、これらのブラウザーで Web 上の Office はテストされません。 Office ではアドイン ランタイムに対してこれらのブラウザーが引き続きサポートされているため、アドインの実行方法にバグが発生したと思う場合は、 office-js リポジトリに問題を作成してください。 詳細については、「以前の Microsoft Webviews と Office バージョンをサポートする」および「EdgeHTML と WebView2 (Microsoft Edge) の問題のトラブルシューティング」を参照してください。

Windows 上の Office 用にテストされたアドイン

Windows の一部の Office バージョンでは、Internet Explorer と Microsoft Edge レガシに付属する Webview コントロールが引き続き使用されます。 AppSource では、アドインでこれらのブラウザー コントロールがサポートされているかどうかをテストします。 アドインでこれらのブラウザー コントロールがサポートされていない場合、AppSource は警告のみを発行し、アドインを拒否しません。 この例では、よりスムーズなユーザー エクスペリエンスを実現するために、アドインで正常なエラー メッセージを構成することをお勧めします。 詳細については、「以前の Microsoft Webview と Office バージョンをサポートする」を参照してください。

テスト用に Office アドインをサイドロードする

サイドロードを使用すると、最初にアドイン カタログに置かなくても、テスト用に Office アドインをインストールすることができます。 アドインをサイドロードする手順はプラットフォームによって異なり、一部のケースでは、製品ごとに異なります。 次の記事では、それぞれ、特定のプラットフォームまたは特定の製品内で Office アドインをサイドロードする方法について説明します。

注:

Microsoft 365 の統合マニフェストを使用する Office アドインは、Office on the web、新しい Outlook on Windows、および Microsoft 365 サブスクリプションバージョン 2304 (ビルド 16320.00000) 以降に接続された Office on Windows で直接サポートされます。 統合マニフェストを含むアプリ パッケージが、その種類のマニフェストを直接サポートしていないプラットフォームにサイドロードされた場合、マニフェストに有効な "alternateIcons" プロパティがある場合、アドインのみのマニフェストが統合マニフェストから生成され、このマニフェストがサイドロードされます。

単体テスト

アドイン プロジェクトに単体テストを追加する方法については、「Office アドインの単体テスト」を参照してください。

Office アドインのデバッグ

Office アドインをデバッグする手順は、プラットフォームと環境によって異なります。 詳細については、「 Office アドインのデバッグ」を参照してください。

Office アドイン マニフェストの検証

Office アドインを記述するマニフェスト ファイルを検証し、マニフェスト ファイルの問題のトラブルシューティングを行う方法については、「マニフェストの問題を検証し、トラブルシューティングを行う」を参照してください。

ユーザーのエラーのトラブルシューティング

よくある Office アドインの問題の解決方法については、「Office アドインでのユーザー エラーのトラブルシューティング」を参照してください。