localhost で開発とテストを完了し、ローカル以外のサーバーまたはクラウド アカウントからアドインをステージングしてテストする場合は、Node.js ベースのアドイン プロジェクトに対して ツール office-addin-debugging を 使用できます。 (このツールは、Visual Studio で作成されたプロジェクトではサポートされていません)。
注:
Windows コンピューターで作業している場合は、ローカル以外のテスト用の別のオプションがあります。 ネットワーク共有からのテストについては、「Office アドインのサイドロード」を参照してください。
Microsoft 365 Agents Toolkit または Office Yeoman Generator (Yo Office) で作成されたプロジェクト
プロジェクトが Agents 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 アプリケーションを手動で閉じても、これらの登録は削除されません。
その他のプロジェクト
プロジェクトが Agents 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 コマンドで同じオプションを使用します。
Office Add-ins