Aktualisieren und Verwalten Ihres Office-Add-Ins

Nachdem Sie Ihr Add-In veröffentlicht haben, sollten Sie es über wichtige Änderungen aus Upstream Bibliotheken auf dem neuesten Stand halten. Das Patchen von Sicherheitsproblemen ist entscheidend für den Aufbau von Kundenvertrauen. Da diese Änderungen keine Auswirkungen auf das veröffentlichte Manifest haben, müssen Ihre Kunden keine Maßnahmen ergreifen, um die neuesten Versionen Ihres Add-Ins zu erhalten.

Auswählen Ihres Szenarios

Breaking Changes in Office.js

Wir sind bestrebt, breaking changes an der API-Oberfläche und dem Api-Verhalten zu vermeiden. Es gibt jedoch Fälle, in denen wir aus Sicherheits- oder Zuverlässigkeitsgründen Breaking Updates vornehmen müssen. In diesen seltenen Fällen werden die folgenden Schritte ausgeführt, um sicherzustellen, dass Die Benutzer Ihres Add-Ins nicht betroffen sind.

  • Ankündigungen, die die betroffenen Features und empfohlenen Änderungen beschreiben, werden im Microsoft 365-Entwicklerblog vorgenommen.
  • Wenn Ihr Add-In im Microsoft Marketplace veröffentlicht wird, werden Sie über die von Ihnen bereitgestellten Informationen kontaktiert.
  • Administratoren betroffener Microsoft 365-Mandanten (einschließlich Microsoft 365 Developer Program-Mandanten) werden nach Möglichkeit über das Nachrichtencenter kontaktiert. Es liegt in der Verantwortung des Administrators, Anbieter von Add-In-Lösungen zu kontaktieren, die außerhalb des Microsoft Marketplace veröffentlicht wurden.

Veraltete Richtlinie

Tools sind möglicherweise veraltet, wenn etwas Besseres verfügbar ist, und APIs in der Office JavaScript-Bibliothek (Office.js), die allgemein verfügbar (GA) sind, möglicherweise veraltet, wenn ihre Aufgabe mit neueren APIs besser erledigt wird. Microsoft bemüht sich nach besten Kräften, die Abschreibungen mindestens 24 Monate im Voraus zu deklarieren. Veraltet bedeutet nicht unbedingt, dass das Feature oder die API entfernt und von Entwicklern nicht mehr verwendet werden kann. Nach 24 Monaten unterstützt Microsoft das Tool oder die API jedoch nicht mehr, und das Tool wird möglicherweise eingestellt, und die API wird möglicherweise aus der GA-Version von Office.js entfernt.

Wenn eine API als veraltet markiert ist, wird dringend empfohlen, so bald wie möglich zu den Ersatz-APIs zu migrieren. In einigen Fällen wird angekündigt, dass neue Anwendungen die neuen APIs kurz nach der Einstellung der ursprünglichen APIs verwenden müssen. In diesen Fällen können nur aktive Anwendungen, die derzeit die veralteten APIs verwenden, diese weiterhin verwenden.

Wichtig

Die 24-monatige Veraltungsdauer wird beschleunigt, wenn eine lange Wartezeit ein Sicherheitsrisiko für Ihr Add-In oder Microsoft darstellt.

App Assure

Der App Assure-Dienst von Microsoft erfüllt das Versprechen von Microsoft zur Anwendungskompatibilität: Ihre Apps funktionieren unter Windows und Microsoft 365 Apps. App Assure-Techniker stehen zur Verfügung, um probleme zu beheben, die ohne zusätzliche Kosten auftreten können.

Wenn ein Problem mit der App-Kompatibilität auftritt, arbeiten App Assure-Techniker mit Ihnen zusammen, um das Problem zu beheben. Unsere Experten werden:

  • Hilfe bei der Problembehandlung und Identifizierung einer Grundursache.
  • Stellen Sie Anleitungen bereit, die Ihnen helfen, das Anwendungskompatibilitätsproblem zu beheben.
  • Engage mit unabhängigen Softwareanbietern (INDEPENDENT Software Vendors, ISVs) in Ihrem Namen, um einen Teil ihrer App zu korrigieren, damit sie auf der modernsten Version unserer Produkte funktionsfähig ist.
  • Arbeiten Sie mit Microsoft-Produktentwicklungsteams zusammen, um Produktfehler zu beheben.

Weitere Informationen zu App Assure finden Sie unter Bringen Ihrer Apps zu Microsoft Edge mit App Assure: Tipps und Tricks. Um Ihre Anforderung zur App-Kompatibilität mit App Assure zu übermitteln, füllen Sie das Microsoft FastTrack Registrierungsformular aus, oder senden Sie eine E-Mail an achelp@microsoft.com.

Aktualisieren Des Add-Ins

Wenn Sie Ihr Add-In aktualisieren, müssen zwei Elemente berücksichtigt werden: die Webanwendung und das Add-In-Paket, einschließlich des Manifests.

Aktualisieren der Webanwendung

Updates zu Ihrer Webanwendung erfordern keine Aktion ihrer Benutzer. Laden Sie neue HTML-, CSS-, Code- und andere Dateien in Ihre Webanwendung und CDNs hoch, und Ihre Benutzer werden die neuen Features automatisch sehen. Einige Add-In-Artefakte, z. B. Schaltflächensymbole, werden zwischengespeichert, wenn das Add-In zum ersten Mal installiert wird. Benutzern werden möglicherweise anfänglich keine aktualisierten Symbole angezeigt. Wenn Benutzer bei der Anzeige der älteren Symbole verwirrt sind, sollte das Schließen und erneute Öffnen der Office-Anwendung dazu führen, dass die neueste Version der Artefakte heruntergeladen wird. Wenn dies nicht der Fall ist, können Sie sie anweisen, alle Office-Anwendungen zu schließen und dann den Office-Cache zu löschen. Dadurch werden die zwischengespeicherten Artefakte aus allen installierten Add-Ins entfernt, aber sie werden beim nächsten Start der Office-Anwendung erneut heruntergeladen. Die einzige Auswirkung ist also eine sehr geringe Verzögerung bei der Anzeige der Symbole.

Aktualisieren der App-Paketdateien

Änderungen am Manifest oder an anderen Dateien im App-Paket erfordern jedoch, dass Benutzer aktualisiert werden müssen. Wenn Sie Ihr Add-In im Microsoft Marketplace veröffentlicht haben, müssen Sie Ihre Übermittlung aktualisieren. Weitere Informationen zu diesem Prozess finden Sie im Artikel Aktualisieren eines vorhandenen Angebots.

Wenn Sie eine Änderung am Manifest oder an einer Datei im App-Paket vornehmen, müssen Sie die Versionsnummer des Manifests erhöhen. (Dies schließt Änderungen an URLs im Manifest ein, die auf ergänzende Konfigurationsdateien im App-Paket verweisen, z. B. Copilot-Konfigurationsdateien.)

  • Wenn das Add-In das einheitliche Manifest verwendet, finden Sie weitere Informationen unter Versionseigenschaft.
  • Wenn das Add-In nur das Add-In-Manifest verwendet (in diesem Fall ist kein App-Paket vorhanden), finden Sie weitere Informationen unter Version-Element.

Wenn Ihr Add-In von einem oder mehreren Administratoren in ihren Organisationen bereitgestellt wird, erfordern einige Manifeständerungen, dass der Administrator den Updates zustimmen muss. Benutzer werden für das Add-In gesperrt, bis die Zustimmung erteilt wurde. Für die folgenden Manifeständerungen muss der Administrator erneut zustimmen.

Schützen Ihres Add-Ins

Add-In-Projekte, die mit dem Yeoman-Generator für Office-Add-Ins oder dem Microsoft 365 Agents Toolkit erstellt werden, basieren auf einer Reihe von Bibliotheken von Microsoft und anderen. Diese Bibliotheken werden unabhängig von microsoft 365-Aktivitäten aktualisiert. Ihre Projekte sollten beim Entwickeln, Veröffentlichen und Verwalten Ihres Add-Ins auf dem neuesten Stand gehalten werden. Mit den folgenden Tools können Sie sicherstellen, dass Ihr Projekt sichere Versionen von abhängigen Bibliotheken verwendet.

Diese Anleitung gilt auch für Kopien von Beispielen aus den Office-Add-In-Codebeispielen und anderen Quellen.

Problembehandlung

  • Meine Benutzer können nicht auf das aktualisierte Add-In zugreifen. Überprüfen Sie, ob die Manifestversion erhöht und die Marketplace-Übermittlung aktualisiert wurde.
  • Admin Zustimmungsdialoge werden nicht angezeigt. Stellen Sie sicher, dass berechtigungen/bereiche/ereignisse tatsächlich geändert wurden. Testen Sie in Ihrem Entwicklungsmandanten.

Engagement in der Community

Da Updates für die Microsoft 365 Developer Platform vorgeschlagen werden, werden wir auf Feedback hören. Melden Sie Bedenken, potenzielle Konsequenzen oder andere Fragen an die Kanäle, die unter Zusätzliche Ressourcen für Office-Add-Ins aufgeführt sind.

Bleiben Sie mit unserem monatlichen Community-Call für Office-Add-Ins über neue Features und die Weiterentwicklung bewährter Methoden auf dem Laufenden.

Siehe auch

  • Last updated on