Übersicht über das Debuggen von Office Add-Ins

Das Debuggen von Office Add-Ins ist im Wesentlichen identisch mit dem Debuggen von Webanwendungen. Ein einzelner Satz von Tools funktioniert jedoch nicht für alle Add-In-Entwickler. Dies liegt daran, dass Add-Ins unter verschiedenen Betriebssystemen entwickelt und plattformübergreifend ausgeführt werden können. Dieser Artikel hilft Ihnen dabei, eine ausführliche Anleitung zur Fehlersuche in Ihrer Entwicklungsumgebung zu finden.

Tipp

Dieser Artikel befasst sich mit dem Debuggen im engeren Sinne, d.h. dem Setzen von Haltepunkten und dem Durchlaufen des Codes. Informationen zu Tests und zur Problembehandlung finden Sie unter Testen von Office Add-Ins und Beheben von Entwicklungsfehlern bei Office Add-Ins.

Hinweis

Obwohl Sie Ihr Add-In auf allen Plattformen testen sollten, die Sie unterstützen möchten, werden Sie nur sehr selten auf einer anderen Umgebung als Ihrem Entwicklungscomputer debuggen müssen. Aus diesem Grund werden in diesem Artikel „Ihr Entwicklungscomputer“ und „Ihre Entwicklungsumgebung“ verwendet, um auf die Umgebung zu verweisen, in der Sie debuggen. Wenn ein Problem im Code nur auf einer anderen Plattform als der auf Ihrem Entwicklungscomputer auftritt und Sie Breakpoints festlegen oder Code schrittweise durchlaufen müssen, um dies zu beheben, ist die Umgebung, auf der Sie debuggen, nicht wirklich Ihre Entwicklungsumgebung.

Server- oder clientseitig?

Das Debuggen des serverseitigen Codes eines Office Add-Ins entspricht dem Debuggen der serverseitigen Anwendung einer beliebigen Webanwendung. Lesen Sie die Debuganweisungen für Ihre IDE oder andere Tools. Im Folgenden sind Beispiele für einige der beliebtesten Tools aufgeführt.

• Debuggen von ASP.NET- oder ASP.NET Core-Apps in Visual Studio
• Debuggen von Express
• Node.js-Debughandbuch
• Node.js-Debuggen in VS Code
• Webpack debuggen

Der Rest dieses Artikels befasst sich nur mit dem Debuggen von clientseitigem JavaScript (das aus TypeScript transpiliert werden kann).

Spezialfälle

Es gibt einige Sonderfälle, in denen der Debuggingprozess für eine bestimmte Kombination aus Plattform, Office Anwendung und Entwicklungsumgebung vom normalen abweicht. Wenn Sie einen dieser Sonderfälle debuggen, verwenden Sie die Links in diesem Abschnitt, um die richtige Anleitung zu finden. Fahren Sie andernfalls mit Allgemeine Hinweise fort.

• Debuggen der Office.initialize- oder Office.onReady-Funktion: Debuggen Sie die „initialize“- und „onReady“-Funktionen.
• Debuggen einer benutzerdefinierten Excel-Funktion in einer nicht gemeinsam genutzten Laufzeit: Debuggen benutzerdefinierter Funktionen in einer nicht gemeinsam genutzten Laufzeit.
• Debuggen eines Funktionsbefehls in einer nicht gemeinsam genutzten Laufzeit:
  • Outlook-Add-Ins auf einem Windows-Entwicklungscomputer: Debug Funktionsbefehle in Outlook-Add-Ins
  • Andere Office-Anwendungs-Add-Ins oder Outlook auf einem Mac-Entwicklungscomputer: Debuggen eines Funktionsbefehls mit einer nicht freigegebenen Laufzeit.
• Debuggen eines ereignisbasierten oder spambasierten Outlook-Add-Ins: Debuggen von ereignisbasierten Add-Ins und Spamberichts-Add-Ins.
• Debuggen eines Add-Ins im neuen Outlook auf Windows-Desktopclient (Vorschau): Weitere Informationen finden Sie im Abschnitt "Debuggen Ihres Add-Ins" unter Entwickeln von Outlook-Add-Ins für das neue Outlook unter Windows.
• Debuggen eines Blazor-basierten Add-Ins: Debuggen Sie das Add-In auf die gleiche Weise wie eine Blazor-Webanwendung. Weitere Informationen finden Sie unter Debuggen ASP.NET Core Blazor WebAssembly.

Allgemeine Hinweise

Um Anleitungen zum Debuggen von clientseitigem Code zu erhalten, ist die erste Variable das Betriebssystem Ihres Entwicklungscomputers.

• Windows
• Mac
• Linux oder andere Unix-Variante

Debuggen unter Windows

Im Folgenden finden Sie allgemeine Anweisungen zum Debuggen unter Windows. Das Debuggen unter Windows hängt von Ihrer IDE ab.

• Visual Studio: Debuggen mithilfe der F12-Tools des Browsers. Weitere Informationen finden Sie unter Debuggen von Office Add-Ins in Visual Studio.

• Jede andere IDE (oder Sie möchten nicht innerhalb Ihrer IDE debuggen): Verwenden Sie die Entwicklertools, die dem Webview-Steuerelement zugeordnet sind, das Add-Ins auf Ihrem Entwicklungscomputer verwenden. Sehen Sie sich eines der folgenden Themen an:

  • Für die Trident-Webansicht: Debuggen von Add-Ins mithilfe von Entwicklertools für Internet Explorer
  • Für die EdgeHTML-Webansicht: Debuggen von Add-Ins mithilfe von Entwicklertools für Edge Legacy
  • Für die WebView2-Webansicht: Debuggen von Add-Ins mithilfe von Entwicklertools in Microsoft Edge (Chromium-basiert)

Informationen dazu, welche Runtime verwendet wird, finden Sie unter Browser und Webview-Steuerelemente, die von Office-Add-Ins und Runtimes in Office-Add-Ins verwendet werden.

Tipp

In neueren Versionen von Office besteht eine Möglichkeit zum Identifizieren des von Office verwendeten Webview-Steuerelements im Persönlichkeitsmenü eines beliebigen Add-Ins, in dem es verfügbar ist. (Das Persönlichkeitsmenü wird in Outlook nicht unterstützt.) Öffnen Sie das Menü, und wählen Sie Sicherheitsinformationen aus. Im Dialogfeld Sicherheitsinformationen unter Windows meldet die RuntimeMicrosoft Edge, Microsoft Edge Legacy oder Internet Explorer. Die Runtime ist in älteren Versionen von Office nicht im Dialogfeld enthalten.

Debuggen auf einem Mac

Verwenden Sie den Safari-Webinspektor. Anweisungen finden Sie unter Debuggen von Office Add-Ins auf einem Mac.

Debuggen unter Linux

Es gibt keine Desktopversion von Office für Linux. Daher müssen Sie das Add-In in Office im Web sideloaden, um es zu testen und zu debuggen. Eine Anleitung zum Debuggen finden Sie in Debug Add-Ins in Office im Web.

Hinweis

Es wird nicht empfohlen, Office-Add-Ins auf einem Linux-Computer zu entwickeln, außer in einem ungewöhnlichen Fall, in dem Sie sicher sein können, dass alle Benutzer des Add-Ins über Office im Web von einem Linux-Computer aus auf das Add-In zugreifen.

Debuggen von Add-Ins in Staging oder Produktion

Um ein Add-In zu debuggen, das sich bereits in Staging oder Produktion befindet, fügen Sie einen Debugger über die Benutzeroberfläche des Add-Ins an. Anweisungen finden Sie unter Anfügen eines Debuggers aus dem Aufgabenbereich.

Siehe auch

• Runtimes in Office-Add-Ins