Notes de publication SharePoint Framework v1.0.0
Bienvenue dans la disponibilité générale de SPFx 1.0. Ce fut une route passionnante et intéressante jusqu’à présent, et cela continue. Il s’agit uniquement de la première version : attendez-vous à un flux constant d’améliorations et de fonctionnalités.
Publiée : 22 février 2017
Importante
Cette page traite des détails liés à une version SPFx spécifique. Cette page n’inclut pas la configuration SPFx requise supplémentaire qui doit être installée pour développer des solutions SPFx, notamment Node.js, Yeoman et d’autres outils.
Pour en savoir plus sur ces conditions préalables, voir Configuration de votre environnement de développement SharePoint Framework.
Mise à niveau de projets de versions préliminaires vers v1.0.0
- Dans le fichier package.json du projet, identifiez tous les packages SPFx pré-v1. Pour chaque package SPFx :
Désinstaller le package pré-v1 existant :
npm uninstall @microsoft/{spfx-package-name}
Installer le package v1.0.0 actualisé :
npm install @microsoft/{spfx-package-name}@1.0.0.0 --save --save-exact
Conseil
La CLI pour Microsoft 365 fournit une procédure détaillée simple pour la mise à niveau de vos solutions vers la dernière version de SharePoint Framework.
Nouvelles fonctionnalités et fonctionnalités
Vous pouvez obtenir les packages npm mis à jour et les utiliser dans le workbench local, et tout devrait se passer correctement. Toutefois, le déploiement du code sur les serveurs s’effectuera par étapes sur plusieurs jours. D’ici la semaine prochaine, 100 % des batteries de serveurs devraient l’avoir. Nous procédons ainsi pour surveiller le déploiement et nous assurer que nous n’avons aucun problème.
Vais-je utiliser SPFX et les composants WebPart côté client maintenant ?
Il y a vraiment deux choses différentes en jeu. La première est le code disponible sur toutes les batteries de serveurs, la seconde est la fonctionnalité activée pour un locataire donné.
À l’instar du déploiement du code dans les batteries de serveurs, la fonctionnalité sera déployée pour les locataires. Nous allons commencer par les mêmes locataires de première version (pas les utilisateurs, les locataires) qui disposent de SPFX aujourd’hui. Au cours de quelques semaines, elle devrait être déployée sur tous les locataires.
Vous saurez si elle a atteint un client donné, car le chargement du package dans le catalogue d’applications indiquera «valide». Même les locataires qui ne peuvent pas charger de packages peuvent toujours essayer SPFx, ils seront simplement limités au workbench local et hébergé (disponible à _layouts/15/workbench.aspx).
Changements dans cette version
- Il n’y a que quelques modifications dans le code SharePoint Framework réel. L’essentiel de notre travail entre RC0 et GA était lié à la stabilité et à la vérification future. C’est notre objectif explicite que les composants que vous créez aujourd’hui continuent de fonctionner pendant des années. Toutefois, les correctifs apportés au service sous-jacent continuent d’être fournis sans problème. Nous n’avons pas 7 versions mineures et des versions correctives différentes du code d’infrastructure chargées, et ainsi de suite. Il y a encore du travail à faire dans ce domaine pour certains composants. Nous y arriverons.
- La principale modification apportée au code lui-même est que nous avons incorporé l’indicateur de vérification null strict dans SPFX, ce qui signifie que vous pouvez également activer cet indicateur dans vos projets. Cela a légèrement modifié l’API, mais ne doit être remarqué que si vous activez vous-même des vérifications null strictes.
- Les autres modifications notables se trouvent dans le code par défaut généré par l’exécution du générateur Yeoman. v1.0.0 est la version des packages. Nous faisons maintenant référence à @types/* avec une version stricte (plus d’erreurs lodash).
- Nous prenons en charge les fonctionnalités XML (ainsi que la mise à niveau). Vous pouvez l’utiliser pour approvisionner les champs, les types de contenu et les listes nécessaires pour le composant WebPart en mode «élevé». Nous allons écrire des publications à ce sujet plus en détail.
- Nous avons finalisé le format de sérialisation sur les pages classiques. Vous devez supprimer et rajouter vos composants WebPart. Nous allons prendre en charge l’ancien format de sérialisation pendant un court moment, puis il cessera de fonctionner.
require('./config/docs.config.html');
retourne maintenant l’objet en disponibilité générale plutôt que la chaîne comme RC0
Problèmes détectés
Nous avons temporairement supprimé office-ui-fabric-react du modèle react jusqu’à ce que nous puissions déplacer le package vers un formulaire ultérieur. Nous nous attendons à ce que cela prenne quelques semaines.