Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die SharePoint-Tools für die clientseitige Entwicklung verwenden den npm-Paket-Manager, um Abhängigkeiten und andere erforderliche JavaScript-Hilfsprogramme zu verwalten. npm ist in der Regel als Teil des Node.js-Setups enthalten.
Beim Erstellen einer neuen clientseitigen Lösung ruft der Yeoman-Generator für SharePoint die neuesten SharePoint-Framework-Pakete ab, die für Ihr clientseitiges Projekt erforderlich sind. Ihre vorhandenen Pakete sind ggf. veraltet und möglicherweise stehen zum Erstellen Ihres Projekts neue Versionen der Pakete zur Verfügung.
Entsprechend den Versionshinweisen für eine bestimmte Version oder das neueste Paket können Sie die in Ihrem Projekt verwendeten SharePoint-Framework-Pakete aktualisieren. SharePoint-Framework-Pakete enthalten die npm-Pakete, die Sie in Ihrem Projekt installiert haben (Beispiel: @microsoft/sp-core-library), sowie die global installierten npm-Pakete (Beispiel: @microsoft/generator-sharepoint).
Tipp
Obwohl nicht erforderlich, empfehlen wir, die SharePoint-Framework-Pakete häufig zu aktualisieren, um alle neuesten Änderungen und Updates zu erhalten.
Suchen nach veralteten Paketen
Führen Sie in einer Konsole im selben Verzeichnis wie das Projekt den folgenden Befehl aus, um nach veralteten Paketen in Ihrem clientseitigen Projekt zu suchen, einschließlich SharePoint Framework-Paketen und anderen, von denen Ihr Projekt abhängt.
npm outdated
Der Befehl listet die folgenden Informationen zu den Paketen auf, von denen Ihr Projekt abhängt. Diese Informationen werden der Datei package.json im Stammverzeichnis des Projekts und der npm-Registry entnommen.
- Aktuelle, in Ihrem Projekt installierte Version
- Von Ihrem Projekt angeforderte Version (verfügbar in package.json)
- Neueste verfügbare Version
Um die SharePoint Framework Pakete zu identifizieren, suchen Sie nach den Paketnamen, die mit dem folgenden npm-Bereich und -Präfix beginnen:
@microsoft/sp-
Zusammen mit den SharePoint-Framework-Paketen müssen Sie möglicherweise auch react- und office-ui-fabric-react-Pakete aktualisieren. Stellen Sie sicher, dass Sie die Versionshinweise-Roadmap & für die jeweilige Version lesen, um abzuleiten, welche Pakete Updates erfordern.
Verwenden von „npm outdated“ bei einem Projekt
SharePoint Server 2016 mit Feature Pack 2 unterstützt SharePoint-Framework-Lösungen. SharePoint Server 2016 verwendet eine ältere Version von SharePoint-Framework als die Version, die in SharePoint Online verfügbar ist.
Beim Erstellen des Gerüsts für neue Projekte müssen Sie im SharePoint-Framework-Yeoman-Generator angeben, ob Ihre Lösung die aktuelle Version von SharePoint-Framework verwenden und nur mit SharePoint Online verwendet werden soll oder eine ältere Version von SharePoint-Framework verwenden und sowohl mit SharePoint Server 2016 als auch mit SharePoint Online verwendet werden soll.
Beim Ausführen des Befehls npm outdated in einem Projekt, das sowohl für SharePoint Online als auch für SharePoint Server 2016 entwickelt wurde, werden die aktuellen Versionen der SharePoint-Framework-Pakete angezeigt. Diese Versionen funktionieren jedoch nur mit SharePoint Online. Wenn Sie Ihre Lösung aktualisieren, um die neuesten Pakete zu verwenden, funktioniert sie nicht mehr mit SharePoint Server 2016.
Beim Arbeiten mit SharePoint-Framework-Lösungen, die mit lokalen SharePoint-Bereitstellungen kompatibel sind, sollten Sie immer prüfen, welche Patchebene die SharePoint-Zielfarm aufweist und welche Version von SharePoint-Framework unterstützt wird.
Aktualisieren der Pakete
Beim Aktualisieren von Paketen auf neuere Versionen sollten Sie immer Ihren Paket-Manager (npm oder Yarn) verwenden. Sie sollten die Datei package.json nicht manuell bearbeiten. Wenn Sie, wie empfohlen, eine Sperrdatei verwenden, werden die Änderungen ignoriert, die Sie an der Datei package.json vornehmen.
Beginnen Sie damit, zu ermitteln, welche Pakete aktualisiert werden sollen und welche neuere Version verwendet werden soll. Es ist ggf. nicht möglich, die neueste Version des angegebenen Pakets zu verwenden, da sie möglicherweise nicht mit anderen SharePoint-Framework-Abhängigkeiten wie TypeScript kompatibel ist.
Führen Sie für jedes Paket, das Sie aktualisieren möchten, den folgenden Befehl aus:
npm install mypackage@newversion --save
Wenn Sie zum Beispiel bisher date-fns Version v2.9.0 verwendet haben und auf Version 2.16.1 aktualisieren möchten, müssen Sie den folgenden Befehl ausführen:
npm install date-fns@2.16.1 --save
Beim Aktualisieren des Pakets mit npm werden die angegebene Version des Pakets in Ihrem Projekt installiert sowie die Versionsnummer in den Abhängigkeiten der Datei package.json und der im Projekt verwendeten Sperrdatei aktualisiert.
Führen Sie danach den folgenden Befehl aus, um alte Buildartefakte zu entfernen:
gulp clean
Es wird empfohlen, dass Sie alle alten Pakete löschen, indem Sie den Ordner node_modules löschen und alle Abhängigkeiten mit dem aktualisierten package.json herunterladen (d. h. neu installieren). Wenn Sie diesen Schritt nicht durchführen, stehen ältere Versionen möglicherweise mit neueren Versionen in Konflikt, wenn Sie das nächste Mals das Projekt erstellen.
npm install
Aktualisieren des Codes
Bei wichtigen API-Änderungen müssen Sie ggf. den vorhandenen Projektcode und die Konfigurationsdateien aktualisieren. In jeder Version werden wichtige Änderungen sowie die an Ihrem Code erforderlichen Änderungen in den Versionshinweisen hervorgehoben. Sie müssen sicherstellen, dass Sie Ihren Code mit diesen Fixes aktualisieren.
Sie können das Projekt jederzeit erstellen, um zu erfahren, ob Fehler und Warnungen vorliegen. Führen Sie dazu den Befehl in einer Konsole im Projektverzeichnis aus:
gulp build
Aktualisieren des Yeoman-Generators
Wenn Sie den SharePoint-Framework-Yeoman-Generator global installiert haben, können Sie mit dem folgenden Befehl ermitteln, ob eine Aktualisierung erforderlich ist:
npm outdated -g
Der Befehl listet die folgenden Informationen zu den global auf dem Computer installierten Paketen auf. Diese Informationen stammen aus den auf Ihrem Computer und in der npm-Registry installierten Versionen.
- Aktuelle, global auf Ihrem Computer installierte Version
- Von Ihnen bei der Installation angeforderte Version
- Neueste verfügbare Version
Um das Generator-Paket zu ermitteln, suchen Sie nach folgendem Paketnamen:
@microsoft/generator-sharepoint
Aktualisieren des Generator-Pakets
Öffnen Sie Ihre bevorzugte Konsole und führen Sie den folgenden Befehl aus, um den Generator auf die neueste veröffentlichte Version zu aktualisieren:
npm install @microsoft/generator-sharepoint@latest -g
Mit dem Befehl wird der Yeoman-Generator für SharePoint zusammen mit allen Abhängigkeiten auf die neueste veröffentlichte Version aktualisiert. Sie können dies überprüfen, indem Sie den folgenden Befehl in der Verwaltungskonsole ausführen:
npm ls @microsoft/generator-sharepoint -g --depth=0