ローカル以外のサーバーで Office アドインをテストおよびデバッグする

  • [アーティクル]

localhost で開発とテストを完了し、ローカル以外のサーバーまたはクラウド アカウントからアドインをステージングしてテストする場合は、Node.js ベースのアドイン プロジェクトに対して ツール office-addin-debugging を 使用できます。 (このツールは、Visual Studio で作成されたプロジェクトではサポートされていません)。

注:

Windows コンピューターで作業している場合は、ローカル以外のテスト用の別のオプションがあります。 ネットワーク共有からのテストについては、「Office アドインのサイドロード」を参照してください。

Teams Toolkit または Office Yeoman ジェネレーター (Yo Office) を使用して作成されたプロジェクト

プロジェクトが Teams Toolkit または Office Yeoman Generator (Yo Office) を使用して作成された場合、office-addin-debugging ツールは既にインストールされており、package.json ファイルにはツールを呼び出すstartスクリプトとstopスクリプトがあります。 ローカル以外のテストに使用するには、マニフェスト内の URL のドメイン部分を更新して、ステージング サーバー (または必要に応じて CDN) を指すようにします。 次に、コマンド ライン (または Visual Studio Code TERMINAL) で npm run start を実行して、テストとデバッグのためにアドインをサイドロードします。

重要

office-addin-debugging ツールは、Windows レジストリまたは Mac の特別なフォルダーにアドインを登録します。 Outlook アドインの場合は、Exchange にアドインも登録されます。 開発時の微妙なバグを回避するには、常に npm run stop を実行してテスト セッションを終了し、これらの登録が削除され、サーバー プロセスが完全に停止していることを確認します。 サーバー、コマンド ライン ウィンドウ (または TERMINAL)、Visual Studio Code、または Office アプリケーションを手動で閉じても、これらの登録は削除されません。

その他のプロジェクト

プロジェクトが Teams Toolkit または Yo Office で作成されていない場合は、プロジェクトのルートで npx を使用してツールを実行します。 start コマンドの後にマニフェストへの相対パスを指定して呼び出します。 次に例を示します。

npx office-addin-debugging start manifest.json

このコマンドは、テストとデバッグのためにアドインをサイドロードします。 このツールは、アドインのみのマニフェストでも機能します。

start コマンドには多くのオプションがあります。 詳細については、 office-addin-debugging のツールの README を参照してください。

重要

office-addin-debugging ツールは、Windows レジストリまたは Mac の特別なフォルダーにアドインを登録します。 Outlook アドインの場合は、Exchange にアドインも登録されます。 開発時の微妙なバグを回避するには、常に npx office-addin-debugging stop を実行してテスト セッションを終了し、これらの登録が削除され、サーバー プロセスが完全に停止していることを確認します。 サーバー、コマンド ライン ウィンドウ (または TERMINAL)、Visual Studio Code、または Office アプリケーションを手動で閉じても、これらの登録は削除されません。 start コマンドで --prod オプションを使用した場合は、stop コマンドで同じオプションを使用します。