Freigeben über

Versionshinweise zu SharePoint-Framework v1.6

  • Artikel

Diese Version enthält zwei Hauptfunktionen:

  • Die endgültige Version des WebAPI-Features, die erstmals in v1.4.1 vorgestellt wurde
  • Unterstützung für Erweiterungen, die mandantenweit konfiguriert werden sollen, ohne dass jeder Standort aktiviert oder konfiguriert werden muss.

Veröffentlicht: 5. September 2018

Wichtig

Auf dieser Seite werden Details zu einer bestimmten SPFx-Releaseversion erläutert. Es werden keine zusätzlichen SPFx-Voraussetzungen erläutert, die installiert werden müssen, um SPFx-Lösungen zu entwickeln, einschließlich Node.js, Yeoman und anderen Tools.

Informationen zu diesen Voraussetzungen finden Sie unter Einrichten Ihrer SharePoint-Framework-Entwicklungsumgebung.

Aktualisierung der Projekte von v1.5.1 auf v1.6

  1. Identifizieren Sie in der Projektdatei package.json alle SPFx v1.5.1-Pakete. Gehen Sie für jedes SPFx-Paket folgendermaßen vor:

    1. Deinstallieren Sie das vorhandene v1.5.1-Paket:

      npm uninstall @microsoft/{spfx-package-name}@1.5.1

    2. Installieren Sie das aktualisierte v1.6-Paket:

      npm install @microsoft/{spfx-package-name}@1.6.0 --save --save-exact

Tipp

Die CLI für Microsoft 365 bietet eine einfache schrittweise Anleitung zum Upgraden Ihrer Lösungen auf die aktuellste SharePoint-Framework-Version.

Neue Features und Funktionen

Web-API (allgemeine Verfügbarkeit)

Für das WebAPI-Feature wurden einige Änderungen in der allgemeinen Verfügbarkeit eingeführt. Der gesamte Zugriff auf AAD-geschützte Ressourcen wird von einem AAD-Anwendungs- und Dienstprinzipal eines Drittanbieters verarbeitet. Die Anwendung wird erstellt, wenn ein Mandantenadministrator zum ersten Mal einen Berechtigungsbereich genehmigt, und sie wird ohne Berechtigungen erstellt. Daher muss jede Verbindung, die Sie mit Daten herstellen (entweder über Microsoft Graph oder ein Aufruf an einen Endpunkt, der AAD für seine Berechtigungen verwendet) explizit zugelassen werden.

Wichtig

Alle Berechtigungen, die vor der Version v1.6.0 erteilt wurden, müssen erneut gewährt werden, da geändert wurde, welche AAD-Anwendung verwendet wird.

  • Verwenden Sie die Option MSGraphClient. Sie finden sie im Kontext Ihrer Komponente (Webpart oder Erweiterung). Aus Leistungsgründen wird der vollständige Code bei Bedarf geladen, sodass über eine Zusage darauf zugegriffen wird.
  • Beenden Sie die Verwendung von GraphHttpClient (falls sie damit noch nicht aufgehört haben). Irgendwann im nächsten Monat oder so wird es vollständig aus unserem Code entfernt werden. Alle Lösungen, die Sie verwenden, funktionieren dann nicht mehr.
  • Ähnlich wie MSGraphClient gibt es eine allgemeine AadHttpClient aus dem Kontext für Aufrufe an AAD-gesicherte Endpunkte und einen AadTokenProvider, mit dem Sie Authentifizierungstoken manuell abrufen können.

Mandantenweite Bereitstellung von Erweiterungen

Sie können jetzt mandantenweite Konfigurationen für Erweiterungen vornehmen. Die einfachste Möglichkeit (als Entwickler) für die Bereitstellung im Mandanten besteht darin, die Datei \SharePoint\ClientInstance.xml (mit einer neuen v1.6.0-Lösung erstellt) zu ändern. Dadurch wird ein Eintrag in einer neuen Liste im App-Katalog (Mandantenweite Erweiterungen) erstellt. Sie können diese Liste auch direkt als Besitzer eines App-Katalogs ändern.

Änderungen in dieser Version

Build- und Tooländerungen

In der Zukunft wird es keine Wrapper für gängige Buildtools mehr geben. Die ersten beiden sind die Compilerschritte „tslint“ und „ts“. Aufgrund dieser Änderungen wird Ihr vorheriger Code nicht ohne einige Änderungen kompiliert.

  • Zuerst benötigen Sie eine *.ts-Datei im Stammverzeichnis des Quellverzeichnisses (standardmäßig erstellen wir jetzt eine datei unter \src mit dem Namen index.ts, die leer ist).
  • Zweitens hat sich der Speicherort der Datei tslint.jsongeändert (von \config in den Stamm des Projekts) sowie das Format. Es gibt jetzt nur noch eine Standarddatei tslint.json. Am einfachsten ist es, ein neues Projekt zu erstellen und die Datei tslint.json aus ihr heraus zu kopieren.
  • Rufen Sie drittens die Datei „tsconfig.json“ aus dem Stammverzeichnis des neuen Projekts in Schritt 2 ab, und kopieren Sie sie in den Stamm des ursprünglichen Projekts. Wenn Sie Änderungen an der Datei tsconfig.json vorgenommen haben, sollten Sie sie zusammenführen.

Heraufstufung von CSS-Klassen zur allgemeinen Verfügbarkeit

Es wurden einige Klassen im paket @microsoft/sp-dialog gefunden, die als Beta gekennzeichnet waren. Sie wurden der Öffentlichkeit zugänglich gemacht.

Hinweis

Dies ist die letzte Version, in der die Buildtools „Node.js v6“ unterstützt werden.