Freigeben über

Versionshinweise zu SharePoint-Framework v1.8.0

  • Artikel

Wir werden in den kommenden Tagen und Wochen weitere aktualisierte Dokumentationen und Anleitungsvideos veröffentlichen. Ihr Feedback zu benötigten Assets und Themen ist mehr als willkommen.

Veröffentlicht: 14. März 2019

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.7.1 auf v1.8.0

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

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

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

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

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

  2. Stellen Sie sicher, dass im devDependency Abschnitt von package.json- ein Eintrag vorhanden ist, der auf "@microsoft/sp-tslint-rules": "1.8.0"verweist.

  3. Fügen Sie ein @microsoft/rush-stack-compiler-x-x-x-Paket als in devDependencypackage.json hinzu. Ausführliche Informationen zur richtigen Version finden Sie im Abschnitt Unterstützung für TypeScript 2.7, 2.9 und 3.x (allgemeine Verfügbarkeit).

  4. Aktualisieren Sie die Datei tsconfig.json , um die TypeScript-Konfiguration für Ihre Version des @microsoft/rush-stack-compiler-x-x zu erweitern. Ändern Sie hierzu den Anfang der Datei wie folgt:

    • Für @microsoft/rush-stack-compiler-2-7 würde der Anfang der Datei tsconfig.json wie folgt aussehen:

      {
   "extends": "./node_modules/@microsoft/rush-stack-compiler-2.7/includes/tsconfig-web.json",
   "compilerOptions": { // ommitted for brevity }
}

    • Für @microsoft/rush-stack-compiler-3-3 würde der Anfang der Datei tsconfig.json wie folgt aussehen:

      {
   "extends": "./node_modules/@microsoft/rush-stack-compiler-3.3/includes/tsconfig-web.json",
   "compilerOptions": { // ommitted for brevity }
}

  5. Beheben Sie alle neuen und relevanten TSLint-Fehler, die jetzt mit einem neueren Compiler ausgelöst werden. Bei großen Projekten kann dies eine Weile dauern. Das Standardverhalten der TypeScript-Compiler wird strenger, aber Ihr Code ist dafür besser.

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

SPFx-Entwicklung für Teams-Registerkarten (allgemeine Verfügbarkeit)

Teams Registerkarten-Lösungen, die SPFx verwenden, werden jetzt vollständig unterstützt. Fügen Sie TeamsTab zur Eigenschaft supportedHosts im Webpart-Manifest hinzu und stellen Sie sie im App-Katalog bereit. Von dort aus können Sie die Lösung auswählen und auf die Schaltfläche "Mit Teams synchronisieren" klicken. Das Webpart wird jetzt als App in Teams angezeigt. Wenn ein Webpart auf einer Teams-Registerkarte gehostet wird, hat es über den Webpart-Kontext Zugriff auf das Teams SDK. Es gibt die folgenden Änderungen gegenüber der Beta-Version in 1.7:

  • Anfängliche und zukünftige Konfigurationen werden über den Eigenschaftenbereich gehandhabt
  • Die Manifesteigenschaft canUpdateConfiguration kann auf false gesetzt werden, um die Konfiguration nach der Erstkonfiguration zu deaktivieren
  • Reduzierter JavaScript-Overhead zum Hosten des Webparts
  • „Mit Teams synchronisieren“-Funktion zum Automatisieren der Erstellung und des Hochladens von Teams-Manifesten
  • Update teams-js to v1.4.1
  • Das Gebietsschema wird vom aktuellen Teams-Gebietsschema gesteuert

Weitere Informationen zu:

App-Seiten (allgemeine Verfügbarkeit)

Wir erhalten häufig Anfragen nach einem Single-Page-App-Framework in SPFx. Wir hoffen, dass App-Seiten die meisten Ziele rund um SPAs erfüllen und gleichzeitig ein ähnliches Entwicklungsmodell und eine ähnliche Benutzererfahrung bieten. App-Seiten sind ein neues modernes SharePoint-Seitenlayout, das ein einzelnes Webpart auf der gesamten Seite hostet und das Erscheinungsbild (Navigation, Kopfzeile, Design usw.) konsistent hält. Durch Hinzufügen von SharePointFullPage zur supportedHosts-Eigenschaft des Webpart-Manifests wird beim Erstellen einer neuen Seite eine App-Seite mit der Webpart-Option hinzugefügt.

Das Webpart kann konfiguriert werden (es sei denn, die Eigenschaft canUpdateConfiguration ist false), aber das Seitenlayout/der Inhalt kann nicht geändert werden. Die Endbenutzererstellung von App-Seiten sollte noch in diesem Monat mit der neuen Seitenerstellungserfahrung eingeführt werden. In der Zwischenzeit gibt es eine statische Seite (unter _layouts/15/appPageHost.aspx?componentId=yourComponentGuidHere), die jede Komponente in einer App-Seite hostet. Diese Seite wird gerade eingeführt und sollte je nach Mandant zum Zeitpunkt der Veröffentlichung oder ein oder zwei Tage später verfügbar sein.

Weitere Informationen zu:

Domänenisolierte Webparts (allgemeine Verfügbarkeit)

Die Ausführung von SPFx-Komponenten auf der aktuellen Seite ist einfach und schnell. Es gibt jedoch Szenarien, in denen eine stärkere Isolation gewünscht wird. Domänenisolierte Webparts werden in einem Iframe mit einer separaten Domäne ausgeführt, die unterschiedliche Berechtigungen von der Hostseite haben kann. Auf diese Weise kann beispielsweise ein Webpart auf die E-Mail des aktuellen Benutzers zugreifen, ohne dass dem gesamten Code, der im Mandanten ausgeführt wird, dieselbe Zugriffsebene zugewiesen wird.

Die Domäne und ihre AAD-App werden für den Mandanten erstellt und verwaltet – der Mandantenadministrator muss die von der Lösung angeforderten Berechtigungen genehmigen. Für Endbenutzer sieht das Webpart aus und verhält sich wie jedes andere Webpart. Derzeit unterstützen domänenisolte Webparts nur dynamische Daten im Seitenkontext. Eine vollständige Teil-zu-Teil-Kommunikation wird in einem zukünftigen Update verfügbar sein.

Weitere Informationen zu:

Bibliothekskomponenten (Developer Preview)

Sie können jetzt Bibliotheken erstellen, auf die andere SPFx-Komponenten verweisen können. Sie sind etwas schwierig zu verwenden, daher werden wir ein separates Dokument veröffentlichen, in dem sie genauer beschrieben werden. Der Trick besteht darin, dass Sie Ihre Bibliothek in einem npm-Feed (intern ist in Ordnung) veröffentlichen müssen, um sie zu verwenden.

Weitere Informationen zu:

Unterstützung für TypeScript 2.7, 2.9 und 3.x (allgemeine Verfügbarkeit)

In dieser Version haben wir daran gearbeitet, die TypeScript-Version von der von Ihnen verwendeten SPFx-Version zu trennen. Sie können jetzt die Version von TypeScript angeben, die Sie unabhängig vom Build-System selbst verwenden möchten. Sie können jeden hier aufgeführten Compiler verwenden: https://www.npmjs.com/search?q=%40microsoft%2Frush-stack-compiler.

Hinweis

Der von Ihnen verwendete Compiler muss in Ihrer Datei tsconfig.json mit einem Verweis auf "extends": "./node_modules/@microsoft/rush-stack-compiler-2.7/includes/tsconfig-web.json" widergespiegelt werden, der der Version des von Ihnen eingeschlossenen rush-stack-compilers entspricht.

Wir haben im letzten Moment festgestellt, dass einige der aktuellen Versionen der @microsoft/rush-stack-compiler-Pakete nicht ordnungsgemäß funktionieren. Wenn Sie feststellen, dass die npm-Installation Warnungen zu Peerabhängigkeiten für TypeScript ausgibt und der Build mit Beschwerden fehlschlägt, dass kein Compiler gefunden wird, verwenden Sie eine frühere Version des Pakets.

Die folgenden Versionen des @microsoft/rush-stack-compiler sollten mit der entsprechenden TypeScript-Version verwendet werden.

  • TypeScript v2.7
    • @microsoft/rush-stack-compiler-2.7@0.5.7
  • TypeScript v2.9
    • @microsoft/rush-stack-compiler-2.9@0.6.8
  • TypeScript v3.0
    • @microsoft/rush-stack-compiler-3.0@0.5.9
  • TypeScript v3.3
    • @microsoft/rush-stack-compiler-3.3@0.1.6

Design von Webpartvarianten in modernen SharePoint-Seiten

Moderne SharePoint-Seiten haben kürzlich ein Feature mit Abschnittshintergrundfarben veröffentlicht. Webparts können ihr Design aktualisieren, um die Hintergrundfarbe widerzuspiegeln, über die das Webpart gerendert wird. Das Festlegen der supportsThemeVariants-Eigenschaft im Webpart-Manifest auf true deaktiviert das Standardverhalten, immer einen weißen Hintergrund zu rendern.

Webparts können dann den SPFx ThemeProvider verwenden, um über Änderungen der Hintergrundfarbe benachrichtigt zu werden.

Weitere Informationen zu:

Änderungen in dieser Version

PropertyPane-Code aus @microsoft/sp-webpart-base entfernt

Wir verschieben den Code des Eigenschaftenbereichs in ein anderes Paket (@microsoft/sp-property-pane), das die gesamte Logik des Eigenschaftenbereichs enthält, die zuvor in @microsoft/sp-webpart-base vorhanden war. Lösungen, die derzeit ausgeführt werden, funktionieren weiterhin (wir leiten die Aufrufe entsprechend weiter), aber die APIs des öffentlichen Eigenschaftenbereichs auf der @microsoft/sp-webpart-base sind in SPFx v1.8 veraltet und werden in spFx v1.9 entfernt.

Ihre Codeänderungen müssen einfach das importierte Paket ändern. Sie haben genau die gleichen Typen und Signaturen; Sie befinden sich in einem anderen Paket. Dadurch können wir den Code des Eigenschaftenbereichs (und alle seine abhängigen Pakete) nur bei Bedarf laden.

Veraltete und entfernte Elemente in dieser Version

Legacy Fabric CSS-Nutzung

Seit der Veröffentlichung von SPFx v1.0 haben wir der Seite eine Reihe von Fabric-CSS hinzugefügt. Obwohl wir die Funktionsweise von Fabric CSS seitdem geändert haben, haben wir der Seite weiterhin die alte Version von Fabric CSS hinzugefügt. Dies führte dazu, dass eine beträchtliche Menge an unnötigem CSS hinzugefügt wurde. Ab SPFx 1.8.0 laden Lösungen das alte Fabric CSS nicht mehr.

Wenn Ihre Lösung weiterhin das Verhalten vor 1.8.0 benötigt, fügen Sie ”loadLegacyFabricCss”: true zu Ihrem Komponentenmanifest hinzu.

Wenn Ihre Stile nach dem Upgrade auf 1.8.0 nicht richtig funktionieren, müssen Sie diese Einstellung möglicherweise ändern.

Stattdessen kann Ihre Lösung das Fabric.css-Stylesheet wie folgt importieren:

import 'office-ui-fabric-react/dist/css/fabric.css';

Bekannte Probleme und Einschränkungen

Die neue Benutzeroberfläche zum Erstellen von App-Seiten hängt von der neuen Hinzufügen einer Seite Benutzeroberfläche auf modernen Seiten ab. Dies wird jetzt ausgerollt, aber die Freigabe in Ihrem Mandanten kann einige Tage zurückliegen.

Wie im Abschnitt TypeScript-Unterstützung erwähnt, treten bei einigen der neueren Builds des @microsoft/rush-stack-compilers , den wir verwenden, Probleme auf. Die früheren Versionen funktionieren. Wir werden Updates und Benachrichtigungen veröffentlichen, wenn dies behoben ist.

Das aktualisierte vom Anbieter gehostete Modell zum Hosten von Microsoft Teams-Lösungen in SharePoint Online (mit dem Teams SDK) befindet sich noch in der Vorschau.

Die Unterstützung dynamischer Daten für isolierte Domänenteile ist auf die Datenquelle des Seitenkontexts beschränkt. Vollständige Unterstützung für dynamische Daten über die iFrame-Grenze hinweg wird in einem zukünftigen Update bereitgestellt.