Partager via

Notes de publication de SharePoint Framework v1.6

  • Article

Cette version contient deux fonctionnalités principales :

  • La version finale de la fonctionnalité WebAPI d’abord préversion dans v1.4.1
  • Prise en charge des extensions à configurer à l’échelle du client sans qu’il soit nécessaire d’activer ou de configurer chaque site.

publiée : 5 septembre 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 v1.5.1 vers v1.6

  1. Dans le fichier package.json du projet, identifiez tous les packages SPFx v1.5.1. Pour chaque package SPFx :

    1. Désinstallez le package v1.5.1 existant :

      npm uninstall @microsoft/{spfx-package-name}@1.5.1

    2. Installez le package v1.6 actualisé :

      npm install @microsoft/{spfx-package-name}@1.6.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

API web (disponibilité générale)

Pour la fonctionnalité webAPI , quelques modifications ont été introduites dans le travail de disponibilité générale. Tout l’accès aux ressources protégées par AAD est géré par une application et un principal de service AAD tiers. L’application est créée la première fois qu’un administrateur de locataire approuve une étendue d’autorisation, et elle est créée avec zéro autorisation. Ainsi, toute connexion que vous effectuez à des données (via le Microsoft Graph ou un appel à un point de terminaison qui utilise AAD pour ses autorisations) doit être explicitement autorisée.

Importante

Toutes les autorisations accordées précédemment à la version v1.6.0 devront être accordées à nouveau, car nous avons modifié l’application AAD utilisée.

  • Utilisez le MSGraphClient. Il existe dans le contexte de votre composant (composant WebPart ou extension). Pour des raisons de performances, le code complet est chargé à la demande. Il est donc accessible via une promesse.
  • Arrêter à l’aide de GraphHttpClient (si vous ne vous êtes pas déjà arrêté). Dans le mois suivant, nous le supprimerons complètement de notre code. Toutes les solutions que vous avez utilisées cesseront de fonctionner.
  • Comme pour MSGraphClient, il existe un AadHttpClient général du contexte pour effectuer des appels à des points de terminaison sécurisés AAD et un AadTokenProvider que vous pouvez utiliser pour obtenir manuellement des jetons d’authentification.

Déploiement à l’échelle du client des extensions

Vous pouvez désormais créer des configurations à l’échelle du locataire pour les extensions. Le moyen le plus simple (en tant que développeur) de déployer dans l’architecture consiste à modifier le fichier f\SharePoint\ClientInstance.xml (créé avec une nouvelle solution v1.6.0). Cela crée une entrée dans une nouvelle liste dans le catalogue d’applications (extensions à l’échelle du locataire). Vous pouvez également modifier cette liste directement en tant que propriétaire du catalogue d’applications.

Changements dans cette version

Modifications apportées aux builds et aux outils

Nous essayons de nous éloigner de certains wrappers autour des outils de génération courants. Les deux premiers sont les étapes du compilateur tslint et ts. En raison de ces modifications, votre code précédent ne se compile pas sans quelques modifications.

  • Tout d’abord, vous devez disposer d’un fichier *.ts à la racine du répertoire source (par défaut, nous en créons un sous \src appelé index.ts vide).
  • Ensuite, le fichier tslint.json a changé d’emplacement (de \config à la racine du projet) et de format. il s’agit maintenant simplement d’un fichier tslint.json standard. Le plus simple est de créer un projet et de copier le fichiertslint.json à partir de celui-ci.
  • Troisièmement, saisissez le fichier tsconfig.json à la racine du nouveau projet à l’étape 2, puis copiez-le à la racine du projet d’origine. Si vous avez apporté des modifications au fichier tsconfig.json, vous souhaiterez les fusionner.

Promotion des classes CSS à la disponibilité générale

Nous avons trouvé des classes dans le package @microsoft/sp-dialog qui ont été marquées comme bêta. Nous les avons déplacés vers le public.

Remarque

Il s’agit de la dernière version où les outils de génération prendront en charge Node.js v6.