Notes de publication sur SharePoint Framework v1.5

Article
03/21/2023

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

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 des projets de la version v1.4.1 à v1.5

Dans le fichier package.json du projet, identifiez tous les packages SPFx v1.4.1. Pour chaque package SPFx :
1. Désinstallez le package v1.4.1 existant :
```
npm uninstall @microsoft/{spfx-package-name}@1.4.1
```
2. 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.

Nouvelles fonctionnalités et fonctionnalités

Les API Ship et Bêta sont désormais des packages séparés

À 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.

Essayer les fonctionnalités en préversion de SharePoint Framework

Données dynamiques (préversion pour les développeurs)

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 :

Prise en charge des gestionnaires de package supplémentaires (Yarn & PNPM)

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

Générateur Yeoman pour SharePoint Framework

Prise en charge des générateurs Yeoman personnalisés

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.

Modifications contenues dans cette publication

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.

Partager via