Versionshinweise zu SharePoint Framework v1.5

Artikel
03/21/2023

Wichtige Änderungen sind die Einführung des neuen plusbeta-Modells sowie viele weitere Verbesserungen und zusätzliche Funktionen.

Veröffentlichung: 5. Juni 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.

Aktualisieren von Projekten von v1.4.1 auf v1.5

Ermitteln Sie in der package.JSON-Projektdatei alle SPFx-v1.4.1-Pakete. Gehen Sie für jedes SPFx-Paket folgendermaßen vor:
1. Deinstallieren Sie das vorhandene v1.4.1-Paket:
```
npm uninstall @microsoft/{spfx-package-name}@1.4.1
```
2. Installieren Sie das aktualisierte v1.5-Paket:
```
npm install @microsoft/{spfx-package-name}@1.5.0 --save --save-exact
```

Installieren Sie die folgenden TypeScript-Typdeklarationspakete:

npm install **\@types/webpack-env@1.13.1
npm install **\@types/es6-promise@0.0.33

Fügen Sie die folgenden Einträge im types-Array in der tsconfig.json-Datei hinzu:

{
  // omitted for brevity
  "types": [
    // omitted for brevity
    "webpack-env",
    "es6-promise"
  ]
  // omitted for brevity
}

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

Endgültige und Beta-APIs sind nun separate Pakete

Ab Version 1.5.0 enthalten die Pakete nur die endgültigen öffentlichen APIs in den *.d.ts-Dateien . Alle Beta-APIs werden entfernt, und Sie müssen die Pakete mit den Beta-APIs explizit auswählen. Um diese Beta-APIs nutzen zu können, müssen Sie die 1.5.0-plusbeta-Versionen der Pakete verwenden. Es gibt nur eine Version von @microsoft/generator-sharepoint und kann sowohl Beta- als auch keine Betalösungen erstellen.

Sie können Lösungen erstellen, die die Beta-APIs auf eine von zwei Arten verwenden. Sie können entweder den Yeoman-Generator ausführen und in der Befehlszeile ein --plusbeta-Kennzeichen hinzufügen, woraufhin bereits eine package.json-Datei mit der -plusbeta-Version erstellt wird, oder Sie können die Bezüge in package.json so aktualisieren, dass die -plusbeta-Version verwendet wird.

Dies unterscheidet sich vom herkömmlichen Ansatz aufgrund der Tatsache, dass es zwar gelegentlich vollständige Pakete gibt, die sich in der Beta-Version befinden, es aber auch üblich ist, dass in bestehenden lieferfertigen Paketen einige Beta-APIs vorhanden sind. Dabei handelt es sich auch nicht unbedingt um die Beta-Version der nächsten Version, da ein Feature über mehrere Versionen hinweg in der Vorschau bleiben kann.

Testen Sie die Vorschaufunktionen in SharePoint-Frameworks

Dynamische Daten (Vorschau für Entwickler)

Den Hauptteil dieser Version bildet die Entwicklervorschau des Features "Dynamische Daten". Sie können sich dies als eine moderne Version des Webpart Connections-Features auf den klassischen Seiten vorstellen.

Das Hauptziel des Features besteht darin, es Entwicklern und Benutzern zu ermöglichen, dynamischere Eigenschaften zu erhalten und deren Bindung an Eigenschaften in anderen Webparts (z. B. eine Benutzerkarte, die vom aktuell ausgewählten Dokument in einem Dokumentbibliothek-Webpart gesteuert wird), den Seitenstatus (auf der Benutzerkarte wird der Autor angezeigt) oder sogar den Seitenkontext (auf der Benutzerkarte wird der aktuelle Benutzer angezeigt).

Bei dieser Entwicklervorschau steht hauptsächlich das zugrundeliegende Datenmodell im Mittelpunkt. Keine Erstanbieter-Webparts bieten derzeit Eigenschaften. Wir stellen ein Beispiel für ein Seitenkontext-Objekt und die Rohfassung einer (auf Entwickler ausgerichteten) Steuerungsfunktion für den Eigenschaftenbereich bereit, in die Sie den Pfad zu der dynamischen Eigenschaft eingeben können, die Sie an eine Webpart-Eigenschaft binden möchten.

Wir arbeiten noch an der Endbenutzerumgebung, möchten aber, dass Entwickler dies in der Zwischenzeit ausprobieren. Lernprogramme und Beispiele finden Sie auf den folgenden Orten:

Unterstützung für zusätzliche Paket-Manager (Yarn & PNPM)

Der Yeoman-Generator und Build-Tools unterstützen nun PNPM- und Yarn-Paketmanager sowie NPM.

Um dies zu verwenden, package-manager-Befehlszeilenoption im Generator, und Sie können npm, **pnpm oder yarn angeben.

Beispiel:

yo @microsoft/sharepoint --package-manager pnpm

Yeoman-Generator für SharePoint-Framework

Unterstützung von angepassten Yeoman-Generatoren

Wir haben den Generator so überarbeitet, dass er bewährten Methoden folgt. Auf diese Weise können Sie unseren Generator für Ihre eigenen benutzerdefinierten Generatoren nutzen. Wir werden diesbezüglich eine neue Open Source-Initiative in der SharePoint Dev Community (PnP) starten, um neue unterstützte Plattformen wie Angular Elements und Vue.js anzubieten.

Änderungen in dieser Version

Bei vielen der Updates des Frameworks ist keine Aktualisierung der npm-Pakete erforderlich. So haben wir z. B. das Authentifizierungs-Popup in der ersten Version des Web API-Developer Preview-Codes entfernt, die Änderung wird jedoch auf das im Dienst gehostete Framework angewendet, daher müssen Entwickler keine Änderungen vornehmen.

Es wurden einige Updates vorgenommen, die explizit Paketaktualisierungen erfordern:

AAD-Informationen wurden zu PageContext (aadInfo) hinzugefügt
Es wurden Probleme im Zusammenhang mit dem sp-Dialog und anderen Paketen behoben, die in der Workbench nicht ordnungsgemäß funktionierten.
10 zusätzliche tslint-Regeln von tslint-microsoft-config zur Ermittlung allgemeiner Sicherheitsrisiken hinzugefügt
Es wurde ein Problem in package-solution behoben, bei dem Warnungen zu falschen Fehlern des Builds führten.

Freigeben über