Office アドインに適したテスト、デバッグ、展開のオプションを理解する

7 分

このユニットでは、Office アドインのテスト、デバッグ、および展開のオプションについて説明します。ユニットの終了時までに、アドインをサイドロードしてテストする方法、アドインをデバッグするための Visual Studio、Visual Studio Code、ブラウザー開発者ツールの使用法、および展開に使用できるさまざまなオプションについて学習します。

Office アドインに最適な展開オプションの選択

Office アドインを開発し、ユーザーが使用できるよう準備する中で、どの展開オプションが最適であるかを決定する必要があります。次の表は、その際に考慮すべき要因を示しています。

考慮する要因	例
アドインのライフサイクル段階	ローカルでの開発者テスト、一般公開の準備
アドインの操作や機能のサポート	作業ウィンドウアドイン、コンテンツアドイン、アドインコマンド
対象となる Office アプリケーション	Excel、Outlook
対象プラットフォーム	Windows、macOS
ユーザーベースの範囲	所属組織、一般ユーザー

展開オプション

アドインを展開するにはいくつかのオプションがあります。次の表で、各オプションとその使用場面について説明します。

オプション	説明	最適な場面
サイドロード	アドインをローカルでインストールします。	開発者のビルドおよびテスト用アドイン
一元展開	Microsoft 365 管理センターを使用して、アドインをユーザーに配布します。	組織内の Microsoft 365 で、またはハイブリッド環境で使用するアドイン
SharePoint カタログ	SharePoint を介してアドインをユーザーに配布します。	オンプレミス環境を使用している組織で使用できる作業ウィンドウまたはコンテンツアドイン。Excel、Word、または PowerPoint が対象ですが、macOS はターゲットプラットフォームではありません
AppSource	アドインを一般ユーザーが使用できるようにします。	一般ユーザーが使用できるように準備されたアドイン
Exchange サーバー	Exchange を介してアドインをユーザーに配布します。	環境で Microsoft Entra ID サービスを使用していない組織で使用できる Outlook アドイン
ネットワーク共有	共有フォルダーを使用して、ネットワークユーザーがアドインを使用できるようにします。	アドインの開発とユーザーは Windows 上

Office アドインに適したテストとデバッグを理解する

アドインのライフサイクルのさまざまな時点で、機能を確認してバグを修正する必要があります。アドインのテストとデバッグについては、いくつかの選択肢があります。

アドインのサイドロード

Windows、macOS、および Web ブラウザーで、テストとデバッグのためにアドインをローカルにインストール (サイドロード) できます。また、iPad に Excel アドインや Word アドインをサイドロードすることもできます。 Node.js、インターネットインフォメーションサービス (IIS)、または他の手段を用いて、アドインを開発用マシン上で Web ホストします。

Office アドイン用の Yeoman ジェネレーターを使用してプロジェクトを作成する場合は、コマンドラインプロンプトで npm run start を実行してアドインを開始して Windows 上の Excel にサイドロードできます。または、Web ブラウザーで npm run start:web を実行できます。ただし、ブラウザーの Excel へは手動でサイドロードする必要があります。

Visual Studio (VS) を使用してプロジェクトを作成する場合は、VS デバッグモードでプロジェクトを実行すると、Windows 上の Excel に自動的にサイドロードされます。

アドインのデバッグ

アドインは次の方法でデバッグできます。

ブラウザー組み込み開発者ツールを備えた Web ブラウザー
Visual Studio (この IDE を使用してアドインを用意した場合)
Visual Studio Code (カスタム関数プロジェクトのみの場合)
Windows と macOS でのランタイムログ記録

特定のプラットフォームでアドインをデバッグする必要がある場合は、他にも役立つツールがあります。このセクションでは、Windows と macOS のいくつかのオプションについて次に説明します。

Windows

Windows 10 の場合、アドインが Microsoft Edge または Internet Explorer のどちらで実行されているかによって使用するツールが異なります。 Microsoft Edge で実行する次の条件が満たされていない場合、アドインは Internet Explorer 11 で実行されます。

Windows 10 (バージョン 1903 以降)
Microsoft 365 サブスクリプション (ビルド 16.0.11629 以降)

Microsoft Edge の場合、Microsoft Edge DevTools をインストールして使用します。 Internet Explorer の場合、使用している Office のバージョンに応じて F12 開発者ツールを実行します。

32 ビット版 Office の場合: C:\Windows\System32\F12\IEChooser.exe
64 ビット版 Office の場合: C:\Windows\SysWOW64\F12\IEChooser.exe

Office 2016 以降で作業ウィンドウアドインをデバッグするために使用可能なオプションとして、デバッガーをアタッチできます。次の図に示すように、[デバッガーのアタッチ] は [設定] メニューから使用できますが、サポートされるツールは Visual Studio 2015 Update 3 以降です。このツールでは JavaScript デバッグのみが可能です。

Windows の Excel で [デバッガーのアタッチ] 項目を表示したパーソナリティメニューのスクリーンショット。

[デバッガーのアタッチ] 項目が表示されている [設定] メニュー

[設定] メニューが表示されない場合、または Visual Studio (VS) を既に使用している場合は、VS で[プロセスにアタッチ] を使用して、Microsoft Edge または Internet Explorer (該当する方) でアドインをデバッグできます。

macOS

サイドロードした作業ウィンドウとコンテンツアドインの場合、macOS High Sierra および Office バージョン 16.9.1 (ビルド 18012504) 以降で Safari Web Inspector を使用できます。サポートされている Office アプリケーションは次のとおりです。

Excel
Outlook
PowerPoint
Word

マニフェストを検証する

アドインのマニフェストを検証するには、次のいずれかのオプションを使用できます。

Office アドイン用の Yeoman ジェネレーター
office-addin-manifest validate コマンド
libxml

必要な Office クライアントとプラットフォームをテストする

自身または想定ユーザーがアドインを使用する Office のバージョンとプラットフォームで、アドインをテストします。

私的に使用するか、または組織に限定する

アドインを自分または組織に限定して使用する場合は、アドインが使用される Office のバージョンとプラットフォームでテストします。たとえば、組織用の Word アドインを開発しており、同僚が通常、Windows 上の Microsoft Edge と Word 2019 で作業している場合は、アドインをそのブラウザーと Word のバージョンでテストします。

一般ユーザー向け

アドインを AppSource を介して公開する場合は、AppSource 検証ポリシーを調べ、アドインのレビューと検証をできるだけ円滑に行う必要があります。重要な検証の要件は次のとおりです。

ブラウザー: Internet Explorer 11 以降、Microsoft Edge、Chrome、Firefox、Safari (macOS)
Office: アドインのマニフェスト構成ファイルのセクション Hosts で指定したすべてのアプリケーション
オペレーティングシステム: Windows、macOS、iPad - Outlook アドインでモバイルがサポートされている場合は、iOS と Android を含めます

AppSource 検証ポリシー 4.12 では、想定されるクライアントとプラットフォームのサポート要件をより詳細に説明しています。

まとめ

このユニットでは、Office アドインのテスト、デバッグ、および展開のオプションについて説明しました。アドインをサイドロードしてテストする方法、アドインをデバッグするための Visual Studio、Visual Studio Code、ブラウザー開発者ツールの使用法、および展開に使用できるさまざまなオプションについても学習しました。