Teilen über

Debuggen der Funktionen „initialize“ und „onReady“

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie mit initialisieren Ihres Office-Add-Ins vertraut sind.

Das Paradoxe beim Debuggen der Funktionen Office.initialize und Office.onReady besteht darin, dass ein Debugger nur an einen Prozess anfügen kann, der ausgeführt wird. Diese Funktionen werden jedoch sofort ausgeführt, wenn der Laufzeitprozess des Add-Ins gestartet wird, bevor ein Debugger angefügt werden kann. In den meisten Fällen hilft der Neustart des Add-Ins nach dem Anfügen eines Debuggers nicht, da durch einen Neustart des Add-Ins der ursprüngliche Laufzeitprozess und der angefügte Debugger geschlossen und ein neuer Prozess gestartet wird, dem kein Debugger angefügt ist.

Glücklicherweise gibt es zwei Möglichkeiten, diese Funktionen zu debuggen, die in den folgenden Abschnitten beschrieben werden.

Debuggen mit Office im Web

Führen Sie zum Debuggen mit Office im Web die folgenden Schritte aus.

  1. Laden Sie das Add-In quer, und führen Sie es in Office im Web aus. Dies erfolgt in der Regel durch Öffnen des Aufgabenbereichs eines Add-Ins oder Ausführen eines Funktionsbefehls. Das Add-In wird im gesamten Browserprozess ausgeführt, nicht in einem separaten Prozess wie in Office Desktop.
  2. Öffnen Sie die Entwicklertools des Browsers. Dies erfolgt in der Regel durch Drücken von F12. Der Debugger in den Tools wird an den Browserprozess angefügt.
  3. Wenden Sie breakpoints nach Bedarf auf den Code in der - oder Office.onReady -Office.initializeFunktion an.
  4. Starten Sie den Aufgabenbereich oder den Funktionsbefehl des Add-Ins wie in Schritt 1 neu. Durch diese Aktion wird der Browserprozess oder der Debugger nicht geschlossen. Die Office.initialize - oder Office.onReady -Funktion wird erneut ausgeführt, und die Verarbeitung wird an Ihren Haltepunkten beendet.

Tipp

Ausführlichere Informationen finden Sie unter Debuggen von Add-Ins in Office im Web.

Debuggen mit Office unter Windows

Um die Initialisierungssequenz Ihres Add-Ins zu debuggen, konfigurieren Sie Ihre Umgebung so, dass Microsoft WebView2-Entwicklertools automatisch geöffnet werden, wenn das Add-In gestartet wird.

  1. Schließen Sie die Office-Anwendung, in der Sie das Add-In debuggen möchten.
  2. Legen Sie die Umgebungsvariable WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS so fest, dass sie den Wert --auto-open-devtools-for-tabsenthält.
  3. Öffnen Sie die Office-Anwendung.
  4. Führen Sie das Add-In aus.
  5. Die Microsoft Edge-Entwicklertools sollten automatisch geöffnet werden. Verwenden Sie das Tool wie beim Debuggen eines Aufgabenbereichs, wie unter Debuggen eines Aufgabenbereich-Add-Ins mit Microsoft Edge-Entwicklertools angegeben.

Hinweis

Möglicherweise werden andere Instanzen des Microsoft Edge-Entwicklertools automatisch geöffnet, da sich diese Umgebungsvariable auf alle WebView2-Instanzen in Ihrem System auswirkt.

Siehe auch

  • Last updated on