Verwalten Ihres Office-Add-Ins

  • Artikel

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.

Breaking Changes in Office.js

Die Microsoft 365 Developer Platform ist bestrebt, die Kompatibilität Ihres Add-Ins sicherzustellen. 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 in AppSource 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 von AppSource veröffentlicht wurden.

Veraltete Richtlinie

APIs oder Tools mit besseren Alternativen sind möglicherweise veraltet. Microsoft unterzieht sich nach bestem Bemühen, etwas mindestens 24 Monate vor der Einstellung als veraltet zu deklarieren. Gleiches gilt für einzelne APIs, die allgemein verfügbar sind (GA): Microsoft deklariert eine API mindestens 24 Monate vor dem Entfernen aus der GA-Version als veraltet.

Veraltet bedeutet nicht unbedingt, dass das Feature oder die API entfernt und von Entwicklern nicht mehr verwendet werden kann. Dies zeigt, dass Microsoft die API oder das Feature nach ablauf des 24-monatigen Zeitraums nicht mehr unterstützt.

Wenn eine API als veraltet gekennzeichnet ist, wird dringend empfohlen, dass Sie so bald wie möglich zur neuesten Version 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.

Um mehr über App Assure zu erfahren, watch Bringen Sie Ihre Apps mit App Assure auf Microsoft Edge: 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.

Änderungen an Yeoman-Vorlagen und Webabhängigkeiten

Der Yeoman-Generator für Office-Add-Ins basiert auf einer Reihe von Bibliotheken von Microsoft und anderen. Diese Bibliotheken werden unabhängig von microsoft 365-Aktivitäten aktualisiert. Alle mit dem Generator erstellten 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.

office.js NPM-Paket

Das NPM-Paket von office-js ist eine Kopie der Inhalte, die im Office.js Content Delivery Network (CDN) gehostet werden. Es ist für Szenarien vorgesehen, in denen kein direkter Zugriff auf das CDN möglich ist. Das NPM-Paket soll keine Versionsverweise auf office.js bereitstellen. Es wird dringend empfohlen, immer das CDN zu verwenden, um sicherzustellen, dass Sie die neueste Version der Office JavaScript-APIs verwenden.

Aktuelle bewährte Methoden

Obwohl wir uns bemühen, abwärtskompatibel zu bleiben, entwickeln sich die von uns empfohlenen Muster und Methoden kontinuierlich weiter. Unsere Dokumentation ist bestrebt, die aktuellen bewährten Methoden darzustellen. Um über neue Features, die Ihre vorhandenen Funktionen verbessern können, auf dem Laufenden zu bleiben, nehmen Sie an unserem monatlichen Communityanruf für Office-Add-Ins teil.

Bereitstellen von Updates

Wenn Sie Features hinzufügen oder Fehler in Ihrem Add-In beheben, müssen Sie die Updates bereitstellen. Wenn Ihr Add-In von einem oder mehreren Administratoren in ihren Organisationen bereitgestellt wird, müssen einige Manifeständerungen vom Administrator den Updates zustimmen. Benutzer werden für das Add-In gesperrt, bis die Zustimmung erteilt wurde. Für die folgenden Manifeständerungen muss der Administrator erneut zustimmen.

Hinweis

Wenn Sie eine Änderung am Manifest vornehmen, müssen Sie die Versionsnummer des Manifests erhöhen.

  • Wenn das Add-In das XML-Manifest verwendet, finden Sie weitere Informationen unter Version-Element.
  • Wenn das Add-In das einheitliche Manifest verwendet, finden Sie weitere Informationen unter Versionseigenschaft.

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.