Versionshinweise zu SharePoint-Framework v1.4.1

Veröffentlichung: 15. Februar 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 auf v1.4.1

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

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

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

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

      npm install @microsoft/{spfx-package-name}@1.4.1.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

Unterstützung für Node v8 (LTS) und NPM v5

Node.js v8 (LTS) und NPM v5 werden jetzt in SPFx unterstützt.

Hier gemeldetes Problem: https://github.com/SharePoint/sp-dev-docs/issues/1002

Außerdem haben wir den Artikel Einrichten Ihrer SharePoint-Framework-Entwicklungsumgebung aktualisiert.

Neue APIs (Entwicklervorschau)

Im Folgenden finden Sie neue APIs, die für die Vorschaunutzung in SharePoint Online verfügbar sind. Diese sind noch nicht für die Verwendung in der Produktion vorgesehen.

@microsoft/sp-http

• Erste Betaversion der AadHttpClient-Klasse
• Erste Betaversion der AadTokenProvider-Klasse

@microsoft/sp-client-preview

• Erste Betaversion der MSGraphClient-Klasse

Ein Tutorial für diese neuen APIs finden Sie in der Office-Dokumentation für die SharePoint-Entwicklung.

• Lernprogramm: Nutzen von Microsoft Graph im SharePoint-Framework

AadHttpClient (Entwicklervorschau)

AadHttpClient- wird verwendet, um REST-Aufrufe für eine Azure AD-Anwendung auszuführen, z. B. in Azure gehostete WebAPI eines Drittanbieters.

• Verwenden Sie für die Kommunikation mit SharePoint stattdessen die SPHttpClient-Klasse.
• Verwenden Sie für die Kommunikation mit Microsoft Graph die MSGraphClient-Klasse.

Informationen zu dieser neuen API finden Sie in der Office-Dokumentation für die SharePoint-Entwicklung:

• Herstellen einer Verbindung mit durch Azure AD gesicherten APIs in SharePoint-Framework-Lösungen.

MSGraphClient (Entwicklervorschau)

MSGraphClient wird verwendet, um REST-Aufrufe für Microsoft Graph auszuführen. Die Microsoft Graph JavaScript-Clientbibliothek ist ein einfacher Wrapper um die Microsoft Graph-API. Diese Klasse ermöglicht es Entwicklern, REST-Aufrufe an MSGraph auszuführen, ohne die MSGraph-Clientbibliothek initialisieren zu müssen.

Wenn eine benutzerdefinierte Konfiguration gewünscht wird, muss die MSGraphClient-API-Funktion für jede Anforderung mit dieser benutzerdefinierten Konfiguration versehen werden.

• Verwenden von MSGraphClient zum Herstellen einer Verbindung mit Microsoft Graph

Wichtig

Beachten Sie, dass diese API die zuvor veröffentlichte GraphHttpClient ersetzt, die jetzt als veraltet betrachtet wird.

AadTokenProvider

Diese Klasse ist eine interne Klasse, die von AadHttpClient und MSGraphClient verwendet wird, um OAuth2-Token aus Azure AD abzurufen. Die Klasse ist derzeit zwar als öffentlich gekennzeichnet, es ist jedoch deren Änderung zu intern geplant. Aus diesem Grund sollten Lösungen nur auf AadHttpClient- und MSGraphClient-Klassen basieren.

Änderungen in dieser Version

• Es wurde ein Problem im Generator behoben, das die Aktivierung neuer Versionen von SPFx-Paketen verhinderte.
• Symptome : Sie stellen eine neue Version von SharePoint-Framework-Paketen bereit, und Ihre Webparts werden nicht mehr in der Webpartauswahl angezeigt.

  • #775

  • Behebung: Um dieses Problem vollständig zu beheben, müssen Sie die nachstehend beschriebenen Schritte in Ihren SharePoint Online-Mandanten ausführen.

    1. Entfernen Sie alle Instanzen bestehender SharePoint-Framework-Lösungen auf Siteebene.
    2. Entfernen Sie die SharePoint-Framework-Lösung aus dem App-Katalog.
    3. Laden Sie eine neue SharePoint-Framework-Lösung in Ihren App-Katalog hoch, die mit Version 1.4.1 erstellt wurde.
    4. Installieren Sie die SharePoint-Framework-Lösungen wieder auf den Sites.

    Hinweis

    Dieses Problem betrifft nicht mandantenbezogene SharePoint-Framework-Lösungen und SharePoint-Add-Ins.

    Tipp

    Sie können möglicherweise die Application Lifecycle Management-APIs (ALM) nutzen, um diesen erforderlichen Prozess zu automatisieren.

Veraltete und aus dieser Version entfernte Elemente

• Die GraphHttpClient-API wurde zugunsten der in dieser Version eingeführten neuen MSGraphClient als veraltet verworfen. Die GraphHttpClient wird in einer zukünftigen Version entfernt.