Erstellen von Office-Add-In-Projekten mit dem Teams-Toolkit
Ein primäres Tool für die Entwicklung von Teams-Apps ist das Teams-Toolkit. Sie können Office-Add-Ins mit dem Teams-Toolkit erstellen.
Add-Ins, die mit dem Teams-Toolkit erstellt wurden, verwenden das einheitliche Manifest für Microsoft 365.
Hinweis
Das einheitliche Manifest für Microsoft 365 kann in Outlook-Produktions-Add-Ins verwendet werden. Es ist nur als Vorschau für Excel-, PowerPoint- und Word-Add-Ins verfügbar.
Tipp
Es gibt eine weitere Visual Studio Code-Erweiterung, die Office-Add-Ins erstellt, die nur das Add-In-Manifest verwenden. Weitere Informationen finden Sie unter Erstellen von Office-Add-In-Projekten mithilfe des Office Add-Ins Development Kit für Visual Studio Code.
Hinweis
Office-Add-Ins, die das einheitliche Manifest für Microsoft 365 verwenden, werden direkt in Office im Web, in outlook unter Windows und in Office unter Windows unterstützt, die mit einem Microsoft 365-Abonnement, Version 2304 (Build 16320.00000) oder höher verbunden sind.
Wenn das App-Paket, das das einheitliche Manifest enthält, in AppSource oder im Microsoft 365 Admin Center bereitgestellt wird, wird ein reines Add-In-Manifest aus dem einheitlichen Manifest generiert und gespeichert. Dieses Reine Add-In-Manifest ermöglicht die Installation des Add-Ins auf Plattformen, die das einheitliche Manifest nicht direkt unterstützen, einschließlich Office für Mac, Office auf Mobilgeräten, Abonnementversionen von Office unter Windows vor 2304 (Build 16320.00000) und unbefristete Versionen von Office unter Windows.
Installieren Sie die neueste Version des Teams-Toolkits in Visual Studio Code, wie unter Installieren des Teams-Toolkits beschrieben.
Wichtig
Sie können ein Outlook-Add-In mit der neuesten veröffentlichten Version von Teams Toolkit erstellen. Um ein Add-In für Excel, PowerPoint oder Word zu erstellen, installieren Sie die Vorabversion, wie unter Installieren einer Vorabversion beschrieben. Das Toolkit erstellt Projekte, die das einheitliche Manifest für Microsoft 365 verwenden. Die Unterstützung für dieses Manifest in Excel, PowerPoint und Word ist nur in der Vorschau verfügbar.
Erstellen eines Office-Add-In-Projekts
Öffnen Sie Visual Studio Code, und wählen Sie das Symbol Teams Toolkit in der Aktivitätsleiste aus.
Wählen Sie Neue App erstellenaus.
Das Dropdownmenü Neues Projekt wird geöffnet. Die aufgeführten Optionen variieren je nach Version des Teams-Toolkits. Wählen Sie Office-Add-In aus.
Das Dropdownmenü App-Features mit einem Office-Add-In wird geöffnet. Die aufgeführten Optionen variieren je nach Version des Teams-Toolkits. Wählen Sie Aufgabenbereich aus.
Wenn Sie ein Outlook-Add-In erstellen, zeigt das Toolkit ein Dropdownmenü programmiersprache an. Wählen Sie entweder TypeScript oder JavaScript aus. (Für Excel-, PowerPoint- und Word-Add-Ins wird immer ein TypeScript-Projekt erstellt.)
Wenn Sie ein Outlook-Add-In erstellen, zeigt das Toolkit ein Framework-Dropdownmenü an. Wählen Sie Standard oder React aus. (Für Excel-, PowerPoint- und Word-Add-Ins wird immer ein Standardprojekt erstellt.)
Wählen Sie im daraufhin geöffneten Dialogfeld Arbeitsbereichsordner den Ordner aus, in dem Sie das Projekt erstellen möchten.
Geben Sie dem Projekt (ohne Leerzeichen) einen Namen, wenn Sie dazu aufgefordert werden. Teams Toolkit erstellt das Projekt mit grundlegenden Dateien und Gerüsten. Anschließend wird das Projekt in einem zweiten Visual Studio Code-Fenster geöffnet. Schließen Sie das ursprüngliche Visual Studio Code-Fenster.
Hinweis
Das generierte Projekt ist so konfiguriert, dass es in Excel, Outlook, PowerPoint und Word installiert werden kann. Sie können das Manifest und die Quelldateien nach Bedarf bearbeiten, um zu ändern, welche Office-Anwendungen unterstützt werden.
Navigieren Sie im Visual Studio Code-TERMINAL zum Stammverzeichnis des Projekts, und führen Sie aus
npm install
.Vergewissern Sie sich nach Abschluss der Installation, dass Sie Ihr Add-In aus Visual Studio Code querladen können. Die Schritte zum Querladen hängen von der Office-Anwendung ab, in der Sie das Add-In testen möchten.
Querladen in Excel, PowerPoint oder Word
Hinweis
Dieser Abschnitt gilt nur, wenn Sie das Add-In auf einem Windows-Computer entwickeln. Wenn Sie auf einem Mac arbeiten, können Sie das Add-In testen, indem Sie das Add-In von Ihrem Microsoft 365-Administrator als integrierte App im Microsoft 365 Admin Center bereitstellen lassen.
Wählen Sie In Visual Studio Codeausführenanzeigen | aus. Wählen Sie im Dropdownmenü AUSFÜHREN UND DEBUGGEN eine der folgenden Optionen aus:
- Excel Desktop (Edge Chromium)
- PowerPoint Desktop (Edge Chromium)
- Word Desktop (Edge Chromium)
Drücken Sie F5. Das Projekt wird erstellt, und ein Node dev-server-Fenster wird geöffnet. Dieser Vorgang kann einige Minuten dauern. Schließlich wird die Desktopversion der ausgewählten Office-Anwendung geöffnet.
Hinweis
Wenn Sie zum ersten Mal ein Office-Add-In quer auf Ihren Computer geladen haben (oder das erste Mal seit mehr als einem Monat), werden Sie möglicherweise aufgefordert, ein altes Zertifikat zu löschen und/oder ein neues zu installieren. Stimmen Sie beiden Eingabeaufforderungen zu.
Im Menüband Start wird eine Contoso-Add-In-Registerkarte mit zwei Schaltflächen angezeigt. Verwenden Sie eine Schaltfläche, um eine Aktion im geöffneten Office-Dokument auszuführen. Verwenden Sie die andere , um den Aufgabenbereich des Add-Ins zu öffnen.
Hinweis
Unabhängig davon, welche Schaltfläche Sie auswählen, wird eine WebView-Aufforderung Zum Beenden beim Laden angezeigt. Wählen Sie OK aus.
Um das Debuggen zu beenden und das Add-In zu deinstallieren, wählen Sie Debuggen in Visual Studio Code ausführen | beenden aus.
Querladen in Outlook
Stellen Sie sicher, dass Ihr Konto in Ihrem Microsoft 365-Entwicklermandanten auch ein E-Mail-Konto in Outlook desktop ist. Wenn dies nicht der Fall ist, befolgen Sie die Anleitung unter Hinzufügen eines E-Mail-Kontos zu Outlook.
Schließen Sie den Outlook-Desktop.
Öffnen Sie in Visual Studio Code teams Toolkit.
Vergewissern Sie sich im Abschnitt KONTEN , dass Sie bei Microsoft 365 angemeldet sind.
Wählen Sie In Visual Studio Codeausführenanzeigen | aus. Wählen Sie im Dropdownmenü AUSFÜHREN UND DEBUGGEN die Option Outlook Desktop (Edge Chromium) aus, und drücken Sie dann F5. Das Projekt wird erstellt, und ein Node dev-server-Fenster wird geöffnet. Dieser Vorgang kann einige Minuten dauern, und dann wird Outlook Desktop geöffnet.
Hinweis
Wenn Sie zum ersten Mal ein Office-Add-In quer auf Ihren Computer geladen haben (oder das erste Mal seit mehr als einem Monat), werden Sie möglicherweise aufgefordert, ein altes Zertifikat zu löschen und/oder ein neues zu installieren. Stimmen Sie beiden Eingabeaufforderungen zu.
Öffnen Sie den PosteingangIhrer Microsoft 365-Kontoidentität , und öffnen Sie eine beliebige Nachricht. Eine Contoso-Add-In-Registerkarte mit zwei Schaltflächen wird im Menüband Start (oder im Menüband Nachricht angezeigt, wenn Sie die Nachricht in einem eigenen Fenster geöffnet haben).
Klicken Sie auf die Schaltfläche Aufgabenbereich anzeigen , und ein Aufgabenbereich wird geöffnet. Klicken Sie auf die Schaltfläche Aktion ausführen , und am oberen Rand der Nachricht wird eine kleine Benachrichtigung angezeigt.
Hinweis
Unabhängig davon, welche Schaltfläche Sie auswählen, wird eine WebView-Aufforderung Zum Beenden beim Laden angezeigt. Wählen Sie OK aus.
Um das Debuggen zu beenden und das Add-In zu deinstallieren, wählen Sie Debuggen in Visual Studio Code ausführen | beenden aus.
Entwickeln Ihres Projekts
Jetzt können Sie das Projekt ändern und entwickeln. Befolgen Sie an Stellen, an denen die Anleitungen in der Dokumentation zu Office-Add-Ins abhängig davon, welcher Manifesttyp verwendet wird, die Anweisungen für das einheitliche Manifest.
Office Add-ins