この記事では、現在の IDE の外部でアドインのクライアント側コード (JavaScript または TypeScript) をデバッグする方法について説明します。
Microsoft Edge 開発者ツールを使用して作業ウィンドウ アドインをデバッグする
注:
アドインに関数を実行する アドイン コマンド がある場合、関数は、Microsoft Edge 開発者ツールを起動できない非表示のブラウザー ランタイム プロセスで実行されるため、この記事で説明する手法を使用して関数のコードをデバッグすることはできません。
アドインをサイドロードして実行します。
注:
Outlook でアドインをサイドロードするには、「 テスト用の Outlook アドインをサイドロードする」を参照してください。
次のいずれかの方法で Microsoft Edge 開発者ツールを実行します。
- アドインの作業ウィンドウにフォーカスがあることを確認し、Ctrl+Shift+Iキーを押します。
- 作業ウィンドウを右クリック (または長押し) してコンテキスト メニューを開き、[ 検査] を選択するか、 パーソナリティ メニュー を開 いて [デバッガーのアタッチ] を選択します。 (Outlook ではパーソナリティ メニューはサポートされていません)。
注:
新しい Outlook on Windows デスクトップ クライアントでは、Microsoft Edge 開発者ツールにアクセスするためのコンテキスト メニューやキーボード ショートカットはサポートされていません。 代わりに、コマンド プロンプトから
olk.exe --devtoolsを実行する必要があります。 詳細については、「 新しい Outlook on Windows 用 Outlook アドインを開発する」の「アドインをデバッグする」セクションを参照してください。[ ソース ] タブを開きます。
次の手順で、デバッグするファイルを開きます。
- ツールの上部のメニュー バーの右端にある [.. .] ボタンを選択し、[ 検索] を選択します。
- デバッグするファイルのコード行を検索ボックスに入力します。 これは、他のファイルにはないはずです。
- [更新] ボタンを選択します。
- 検索結果で行を選択して、検索結果の上のペインでコード ファイルを開きます。
ブレークポイントを設定するには、コード ファイル内の行番号を選択します。 コード ファイル内の行に赤いドットが表示されます。 右側のデバッガー ウィンドウで、ブレークポイントが [ ブレークポイント ] ドロップダウンに登録されます。
必要に応じてアドインの関数を実行して、ブレークポイントをトリガーします。
ヒント
ツールの使用方法の詳細については、「 Microsoft Edge 開発者ツールの概要」を参照してください。
アドインでダイアログをデバッグする
アドインで Office Dialog API を使用している場合、ダイアログは作業ウィンドウとは別のプロセス (存在する場合) で実行され、その個別のプロセスからツールを開始する必要があります。 次の手順に従ってください。
アドインを実行します。
ダイアログを開き、フォーカスがあることを確認します。
次のいずれかの方法で Microsoft Edge 開発者ツールを開きます。
- Ctrl+Shift+I または F12 キーを押します。
- ダイアログを右クリック (または選択して長押し) してコンテキスト メニューを開き、[ 検査] を選択します。
作業ウィンドウのコードと同じツールを使用します。 この記事 の「Microsoft Edge 開発者ツールを使用して作業ウィンドウ アドインをデバッグ する」を参照してください。
初期化をデバッグするために Microsoft Edge 開発者ツールを自動的に開く
アドインの初期化シーケンスをデバッグするには、アドインの起動時に Microsoft WebView2 開発者ツールが自動的に開く環境を構成します。
- アドインをデバッグする予定の Office アプリケーションを閉じます。
-
--auto-open-devtools-for-tabs値を含むようにWEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS環境変数を設定します。 - Office アプリケーションを開きます。
- アドインを実行します。
- Microsoft Edge 開発者ツールが自動的に開きます。 「Microsoft Edge 開発者ツールを使用して作業ウィンドウ アドインをデバッグする」で指定されているように、作業ウィンドウのデバッグ時と同じツールを使用します。
注:
この環境変数はシステム内のすべての WebView2 インスタンスに影響するため、Microsoft Edge 開発者ツールの自動オープンの他のインスタンスが表示される場合があります。
Office Add-ins