initialize 機能と onReady 機能をデバッグする

注:

この記事では、 Office アドインの初期化に精通していることを前提としています。

Office.initialize 関数と Office.onReady 関数のデバッグのパラドックスは、デバッガーは実行中のプロセスにのみアタッチできますが、デバッガーをアタッチする前に、アドインのランタイム プロセスが起動するとすぐに実行されます。 ほとんどの場合、デバッガーがアタッチされた後にアドインを再起動しても役に立ちません。アドインを再起動すると、元のランタイム プロセス とアタッチされたデバッガーが 閉じられ、デバッガーがアタッチされていない新しいプロセスが開始されるためです。

幸いなことに、次のセクションで説明するこれらの関数をデバッグする方法は 2 つあります。

Office on the webを使用したデバッグ

Office on the webでデバッグするには、次の手順を使用します。

1. アドインOffice on the webをサイドロードして実行します。 これは通常、アドインの作業ウィンドウを開くか 、関数コマンドを実行することによって行われます。 アドインは、デスクトップ Office と同様に別のプロセスではなく、ブラウザー プロセス全体で実行されます。
2. ブラウザーの開発者ツールを開きます。 これは通常、 F12 キーを押すことによって行われます。 ツールのデバッガーがブラウザー プロセスにアタッチされます。
3. Office.initialize または Office.onReady 関数のコードに必要に応じてブレークポイントを適用します。
4. 手順 1 で行ったのと同じように、アドインの作業ウィンドウまたは関数コマンドを再起動します。 このアクションは、ブラウザー プロセスやデバッガーを閉じ ません 。 Office.initializeまたはOffice.onReady関数が再度実行され、ブレークポイントで処理が停止します。

ヒント

詳細については、「Office on the webでのアドインのデバッグ」を参照してください。

Windows 上の Office を使用したデバッグ

アドインの初期化シーケンスをデバッグするには、アドインの起動時に Microsoft WebView2 開発者ツールが自動的に開く環境を構成します。

1. アドインをデバッグする予定の Office アプリケーションを閉じます。
2. --auto-open-devtools-for-tabs値を含むようにWEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS環境変数を設定します。
3. Office アプリケーションを開きます。
4. アドインを実行します。
5. Microsoft Edge 開発者ツールが自動的に開きます。 「Microsoft Edge 開発者ツールを使用して作業ウィンドウ アドインをデバッグする」で指定されているように、作業ウィンドウのデバッグ時と同じツールを使用します。

注:

この環境変数はシステム内のすべての WebView2 インスタンスに影響するため、Microsoft Edge 開発者ツールの自動オープンの他のインスタンスが表示される場合があります。

関連項目

• Office アドインのランタイム