Freigeben über


Ü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.

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.

Allgemeine Hinweise

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

Debuggen unter Windows

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

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