Versionshinweise zu SharePoint-Framework v1.12.1

Artikel
03/21/2023

In diesem Release wird ein neues Eigenschaftsereignis & in der Webpart-API eingeführt, um die Renderingbreite (und Änderungen) zu erkennen, die Unterstützung für Microsoft Teams-Lösungen zu verbessern und unterstützte Versionen von Node.js zu aktualisieren.

Veröffentlicht: 28. April 2021

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.

Aktualisieren von Projekten von v1.11.0 auf v1.12.1

Identifizieren Sie in der Datei package.json des Projekts alle SPFx v1.11.0-Pakete. Gehen Sie für jedes SPFx-Paket folgendermaßen vor:
1. Deinstallieren Sie das vorhandene v1.11.0-Paket:
```
npm uninstall @microsoft/{spfx-package-name}@1.11.0
```
2. Installieren Sie das aktualisierte {version-release}-Paket v1.12:
```
npm install @microsoft/{spfx-package-name}@1.12.1 --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

Die Schaltfläche Synchronisieren mit Teams im App-Katalog des Mandanten wird das in der Lösung definierte Teams-App-Manifest (falls vorhanden) verwenden, um ein Teams-App-Paket zu erstellen und in Microsoft Teams zu veröffentlichen. Wenn die App-Manifestdatei nicht vorhanden ist, wird SharePoint dynamisch eine neue generieren.
- Details finden Sie unter Bereitstellungsoptionen für SharePoint-Framework-Lösungen für Microsoft Teams.
Ein neues API wurde der SPFx-Webpart-Klasse hinzugefügt, um die gerenderte Breite eines Webparts zu bestimmen und optional ein Ereignis zu behandeln, wenn sie sich ändert.
- Weitere Details finden Sie unter Bestimmen der gerenderten Webpartgröße.
Erweitern Sie Listenbenachrichtigungen, damit sie sowohl für Listen wie für Dokumentenbibliotheken funktionieren.
Vorläufige Unterstützung für Besprechungsapps in Microsoft Teams mit dem SharePoint-Framework – für den vollständigen Support wird noch eine Korrektur für die serverseitige Regression benötigt

Änderungen in dieser Version

Unterstützung für Node.js v12.13.x & v14.15.x hinzugefügt
- Weitere Details finden Sie unter Einrichten Ihrer SharePoint-Framework-Entwicklungsumgebung.
- Gulp-CLI wird dringend empfohlen. Unsere vorherige Anleitung besagte, Gulp v3 oder v4 global zu installieren, aber die Anleitung des Gulp-Teams besagt, nur Gulp CLI global zu installieren. Mithilfe der Gulp CLI können Sie Projekte haben, die Gulp v3 verwenden und andere die Gulp v4 verwenden.
Für alle Projekte:
- Aktualisieren der Standardversion von TypeScript auf v3.7 (via @microsoft/rush-stack-compiler-3.7 v0.2.3)
- Aktualisieren der Gulp-Version, die für v4.0.2 verwendet wird
  
  Weitere Informationen finden Sie unter Gulp-Versionen & Node.js v12+
Für Projekte, die React verwenden:
- Aktualisieren der React-NPM-Pakete (React&React-DOM) auf v16.9.0
- Aktualisieren des Office UI Fabric React-NPM-Pakets / der Microsoft Fluent-Benutzeroberfläche (office-ui-fabric-react) auf v7.156.0.
Der Standardspeicherort für Ressourcen, welche in Bereitstellungen verwendet werden, wurde von ./temp/deploy zu ./releases/assets geändert. Für Projekte, die vor SPFx v1.12.1 erstellt wurden, sollten Sie die ./config/deploy-azure-storage.json-Dateieigenschaft workingDir auf den neuen Speicherort aktualisieren: "workingDir": "./release/assets/". Weitere Informationen finden Sie unter Bereitstellen Ihres clientseitigen SharePoint-Webparts zu Azure CDN: Konfigurieren der Azure Storage-Kontodetails.

Veraltete Funktionen und entfernte Elemente in dieser Version

Gulp v3 ist nicht unterstützt (weder global noch lokal installiert), wenn Node.js v12+ verwendet wird.
Lokale Workbench ist veraltet – dies ist die letzte Version, die Support für die lokale Workbench beinhaltet.
Dies ist die letzte Version, die einen einzelnen Generator enthalten wird, der lokal und für SharePoint Online funktioniert. Sie werden immer noch lokale Projekte erstellen können, müssen aber einen älteren Generator verwenden.
Der Task gulp serve ist veraltet und wurde in serve-deprecated umbenannt. Um dieses Problem zu behandeln, wurde gulpfile.js in neuen SPFx v1.12.1-Projekten so aktualisiert, dass ein Alias serve für den umbenannten serve-deprecated-Task hinzugefügt wird. Wenn Sie jedoch ein Projekt auf SPFx v1.12.1 aktualisieren, müssen Sie Ihre gulpfile.js-Datei bearbeiten, damit der gulp-Task weiterhin funktioniert.

Fügen Sie beim Upgrade von SPFx-Projekten auf Version 1.12.1 Folgendes vor der Zeile build.initialize(require('gulp')); ein:
```
var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};
```

Gulp-Versionen & Node.js v12+

Gulp v3 wird mit Node.js v12+ nicht unterstützt (siehe gulpjs/gulp/#2324).

Dies ist keine Änderung mit SPFx. Es wird hier erwähnt, um darauf aufmerksam zu machen, weil diese SPFx-Version Unterstützung für Node.js v12 hinzufügt.

Freigeben über