Notes de publication de SharePoint Framework v1.12.1

Article
03/21/2023

Cette version introduit un nouvel événement de propriété & dans l’API de composant WebPart pour détecter la largeur de rendu (et les modifications), une prise en charge améliorée des solutions Microsoft Teams et des mises à jour des versions prises en charge de Node.js.

Publiée : 28 avril 2021

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 v1.11.0 à la v1.12.1

Dans le fichier package.json du projet, identifiez tous les packages SPFx v1.11.0. Pour chaque package SPFx :
1. Désinstaller le package v1.11.0 existant :
```
npm uninstall @microsoft/{spfx-package-name}@1.11.0
```
2. Installez le paquet v1.12 {version-release} rafraîchi :
```
npm install @microsoft/{spfx-package-name}@1.12.1 --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

Le bouton Synchroniser avec Teams dans le catalogue d'applications du locataire utilisera le manifeste d'applications Teams défini dans la solution, s'il existe, pour créer et publier un paquet d'applications Teams vers Microsoft Teams. Si un fichier manifeste d'application n'est pas présent, SharePoint en génère un de manière dynamique.
- Pour plus de détails, voir les options de déploiement des solutions SharePoint Framework pour Microsoft Teams.
Une nouvelle API a été ajoutée à la classe SPFx web part pour déterminer la largeur rendue d'une web part et éventuellement gérer un événement lorsqu'elle change.
- Voir Déterminer la taille du composant Web rendu pour plus de détails.
Développez notifications de liste fonctionner pour les listes et les bibliothèques de documents.
Prise en charge préliminaire des applications de réunion Microsoft Teams avec SharePoint Framework – la prise en charge complète est en attente d'une correction de la régression côté serveur.

Changements dans cette version

Ajout de la prise en charge de Node.js v12.13.x & v14.15.x
- Voir la section Configurer votre environnement de développement SharePoint Framework pour plus de détails.
- Gulp-CLI est vivement recommandé. Lors de nos précédentes instructions, nous vous recommandions d’installer globalement Gulp v3 ou v4, mais les instructions de l’équipe Gulp sont de n’installer globalement que l’interface de ligne de commande (CLI) Gulp. Quand vous utilisez l’interface de ligne de commande (CLI) Gulp, vous pouvez avoir des projets qui utilisent Gulp v3 et d’autres qui utilisent Gulp v4.
Pour tous les projets :
- Mettre à jour la version par défaut de TypeScript àv3.7 (via @microsoft/rush-stack-compiler-3.7 v0.2.3)
- Mise à jour de la version Gulp utilisée vers la version 4.0.2
  
  Pour plus d’informations, consultez Concernant les versions & de Gulp Node.js v12+
Pour les projets qui utilisent «React :
- Mise à jour des paquets React NPM (react&react-dom) à la v16.9.0.
- Mettez à jour le paquet NPM Office UI Fabric React / Microsoft Fluent UI (office-ui-fabric-react) àv7.156.0.
L’emplacement par défaut des ressources utilisées dans les déploiements ont changé de ./temp/deploy vers ./releases/assets. Pour les projets créés avant SPFx v1.12.1, nous vous recommandons de mettre à jour la propriété de fichier ./config/deploy-azure-storage.jsonworkingDir vers le nouvel emplacement : "workingDir": "./release/assets/". Pour obtenir plus d’informations, voir Déployer votre composant WebPart côté client SharePoint sur un CDN Azure : Configuration des détails du compte de stockage Azure.

Dépréciations et éléments supprimés dans cette version

Gulp v3 n'est pas pris en charge (ni globalement ni localement) lorsque vous utilisez Node.js v12+.
L'atelier local est déprécié – Cette version est la dernière à prendre en charge l'atelier local.
Il s'agit de la dernière version qui comprendra un générateur unique fonctionnant pour SharePoint Online et on-prem. Vous pourrez toujours créer des projets pour on-prem, en utilisant simplement l'ancien générateur.
La tâche gulp serve a été dépréciée et renommée serve-deprecated. Pour résoudre ce problème, le fichier gulpfile.js dans les nouveaux projets SPFx v1.12.1 a été mis à jour de façon à ajouter un alias serve pour la tâche renommée serve-deprecated. Cependant, si vous mettez à jour un projet vers SPFx v1.12.1, vous devez modifier votre fichier gulpfile.js pour que la tâche gulp serve continue à fonctionner.

Lors de la mise à niveau de projets SPFx vers v1.12.1, ajoutez ce qui suit avant la ligne build.initialize(require('gulp'));:
```
var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};
```

Versions & gulp Node.js v12+

Gulp v3 n'est pas supporté par Node.js v12+ (référence gulpjs/gulp/#2324).

Ce n'est pas un changement avec SPFx. Il est mentionné ici pour attirer l'attention sur le fait que cette version de SPFx ajoute la prise en charge de Node.js v12.

Partager via