Freigeben über

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.

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.

Aktualisieren Des Add-Ins

Wenn Sie Ihr Add-In aktualisieren, müssen zwei Elemente berücksichtigt werden: die Webanwendung und das Manifest. Updates zu Ihrer Webanwendung erfordern keine Aktion ihrer Benutzer. Diese Benutzer verfügen nur über das Manifest in ihrer Office-Anwendung. Änderungen am Manifest erfordern jedoch, dass Benutzer aktualisiert werden müssen. Wenn Sie Ihr Add-In in AppSource 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 vornehmen, müssen Sie die Versionsnummer des Manifests erhöhen.

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

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.

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.