Notes de publication sur SharePoint Framework v1.5
Les principales modifications concernent l’introduction du nouveau modèle plusbeta mais aussi de nombreuses autres améliorations et fonctionnalités supplémentaires.
Publication : 5 juin 2018
Important
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.
Dans le fichier package.json du projet, identifiez tous les packages SPFx v1.4.1. Pour chaque package SPFx :
Désinstallez le package v1.4.1 existant :
npm uninstall @microsoft/{spfx-package-name}@1.4.1
Installez le package v1.5 actualisé :
npm install @microsoft/{spfx-package-name}@1.5.0 --save --save-exact
Installez les packages de déclaration de type TypeScript suivants :
npm install **\@types/webpack-env@1.13.1 npm install **\@types/es6-promise@0.0.33
Ajoutez les entrées suivantes au tableau
types
dans le fichier tsconfig.json :{ // omitted for brevity "types": [ // omitted for brevity "webpack-env", "es6-promise" ] // omitted for brevity }
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.
À compter de la version v1.5.0, les packages contiennent uniquement les API publiques finales dans les fichiers *.d.ts . Toutes les API bêta sont supprimées et vous devrez choisir explicitement les packages qui contiennent les API bêta. Pour utiliser ces API bêta, vous devez utiliser les versions 1.5.0-plusbeta des packages. Il n’existe qu’une seule version de @microsoft/generator-sharepoint, et elle peut créer des solutions bêta et non bêta.
Vous pouvez créer des solutions qui utilisent les API bêta de deux manières différentes. Vous pouvez exécuter le générateur yeoman et ajouter un indicateur --plusbeta dans la ligne de commande, et cela créera un fichier package.json avec les versions -plusbeta, ou vous pouvez mettre à jour les références dans package.json pour utiliser la version -plusbeta.
Il s’agit d’une approche différente de l’approche habituelle, car même s’il existe des packages entiers dans la version bêta, il arrive également que certaines API bêta se trouvent dans des packages ship existants. Il ne s’agit pas forcément d’une version bêta de la prochaine version, car une fonctionnalité peut être conservée dans la préversion de plusieurs versions.
La majeure partie de cette version concerne la préversion des données dynamiques pour les développeurs. Vous pouvez considérer cela comme une version moderne de la fonctionnalité Connexions de composants WebPart des pages classiques.
L’objectif final de la fonctionnalité sera de permettre aux développeurs et aux utilisateurs d’avoir des propriétés plus dynamiques et pouvant être liées à des propriétés dans d’autres composants WebPart (par exemple, une carte utilisateur qui est gérée par le document actuellement sélectionné dans un composant WebPart bibliothèque de documents) , l’état de la page (la carte utilisateur affiche l’auteur) ou même le contexte de la page (la carte utilisateur affiche l’utilisateur actuel).
Cette préversion pour les développeurs est principalement axée sur le modèle de données sous-jacent. Aucun composant WebPart ne révèle actuellement des propriétés. Nous avons un exemple d’objet de contexte de page et un contrôle de volet de propriétés approximatif (axé sur le développeur) dans lequel vous pouvez taper le chemin d’accès de la propriété dynamique que vous souhaitez lier à une propriété de composant WebPart.
Nous travaillons toujours sur l’expérience de l’utilisateur final, mais nous voulions que les développeurs puissent l’essayer pendant ce temps. Vous trouverez des didacticiels et des exemples dans les emplacements suivants :
- Connecter les composants SharePoint Framework à l’aide de données dynamiques
- Exemple de données dynamiques dans React
Le générateur Yeoman et les outils de création prennent désormais en charge les gestionnaires de packages PNPM et Yarn, ainsi que npm.
Pour l’utiliser, tapez l’option de ligne de commande --package-manager dans le générateur. Vous pouvez ensuite spécifier npm, **pnpm, ou yarn.
Par exemple :
yo @microsoft/sharepoint --package-manager pnpm
Nous avons retravaillé le générateur afin de suivre les meilleures pratiques. Cela devrait vous permettre d’utiliser notre générateur pour vos propres générateurs personnalisés. Nous allons lancer une nouvelle initiative open source à ce sujet dans le cadre de la communauté de développement SharePoint (PnP) pour offrir la prise en charge de nouvelles plateformes telles que Angular Elements et Vue.js.
La plupart des mises à jour du framework ne nécessitent pas réellement d’une mise à jour des packages npm. Par exemple, nous avons supprimé la fenêtre contextuelle d’authentification dans la publication initiale de la préversion du code de développement de l’API Web, mais la modification est déployée dans le framework hébergé sur le service, ainsi, aucune modification n’est requise pour les développeurs.
Certaines mises à jour nécessitent explicitement des mises à jour pour les packages :
- Ajout d’informations AAD au PageContext (aadInfo)
- Problèmes résolus concernant le service de boîtes de dialogue et d’autres packages qui ne fonctionnent pas correctement dans le workbench
- Ajout de 10 règles tslint supplémentaires à partir de tslint-Microsoft-config pour détecter les vulnérabilités de sécurité courantes
- Problèmes résolus dans package-solution dans lequel des avertissements entraînaient un échec de la version.