Ü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 Add-Ins oder Add-Ins für die Spamberichterstattung: Debuggen von ereignisbasierten Add-Ins und Spamberichts-Add-Ins.
• Debuggen eines Add-Ins im neuen Outlook auf Windows-Desktopclient: 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): Debuggen mit den Webview2-Debugtools. Weitere Informationen finden Sie unter Debuggen von Add-Ins mithilfe von Entwicklertools in Microsoft Edge.

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.

Versionen von office.js zum Debuggen

Es gibt Debugversionen der Office JavaScript-Bibliotheken. Diese Versionen sind besser lesbar und einfacher mit einem Debugger zu durchlaufen. Verwenden Sie sie, wenn die Office-JavaScript-APIs nicht wie erwartet funktionieren. Vermeiden Sie es, sie zu verwenden, wenn Sie Ihr Add-In veröffentlichen und bereitstellen.

Die Debugversionen befinden sich an den folgenden CDN-Speicherorten.

• Office JavaScript-API-Bibliothek: https://appsforoffice.microsoft.com/lib/1/hosted/office.debug.js
• Office JavaScript-API-Bibliothek (Vorschau): https://appsforoffice.microsoft.com/lib/beta/hosted/office.debug.js

Siehe auch

• Runtimes in Office-Add-Ins