Partager via

Notes de publication de SharePoint Framework v1.4.1

  • Article

Publiée : 15 février 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 à v1.4.1

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

    1. Désinstaller le package v1.4 existant :

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

    2. Installez le package v1.4.1 actualisé :

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

Support de nœud v8 (LTS) et NPM v5

Le support de nœud.js v8 (LTS) et NPM v5 est désormais disponible dans SPFx.

Erreurs signalées ici : https://github.com/SharePoint/sp-dev-docs/issues/1002

Nous avons également mis à jour l’article Configurer votre environnement de développement SharePoint Framework.

Nouvelles API (aperçu pour les développeurs)

Ci-après sont présentées les nouvelles API disponibles pour une utilisation en aperçu dans SharePoint Online. Elles ne doivent pas être utilisées en production pour le moment.

@microsoft/sp-http

  • Version bêta initiale de la classe AadHttpClient
  • Version bêta initiale de la classe AadTokenProvider

@microsoft/sp-client-preview

  • Version bêta initiale de la classe MSGraphClient

Vous trouverez un didacticiel pour ces nouvelles API dans la documentation Office SharePoint Développement.

AadHttpClient (aperçu pour les développeurs)

AadHttpClient est utilisée pour effectuer les appels REST vers une application Azure AD, par exemple WebAPI tierce hébergée dans Azure.

  • Pour communiquer avec SharePoint, utilisez la classe SPHttpClient à la place.
  • Pour communiquer avec Microsoft Graph, utilisez la classe MSGraphClient.

Vous trouverez plus d’informations sur cette nouvelle API dans la documentation Office SharePoint Développement :

MSGraphClient (aperçu pour les développeurs)

MSGraphClient est utilisée pour effectuer les appels REST vers Microsoft Graph. La bibliothèque client JavaScript de Microsoft Graph est une enveloppe légère autour de l'API Microsoft Graph. Cette classe permet aux développeurs de commencer à effectuer des appels REST vers MSGraph sans avoir le besoin d’initialiser la bibliothèque de client MSGraph.

Si une configuration personnalisée est désirée, la fonction API MSGraphClient doit être fournie avec cette configuration personnalisée pour chaque demande.

Importante

Notez que cette API remplace la GraphHttpClient précédemment publiée, qui est désormais considérée comme déconseillée.

AadTokenProvider

Cette classe est une classe interne utilisée par AadHttpClient et MSGraphClient pour obtenir des jetons OAuth2 d’Azure AD. Bien que cette classe soit actuellement marquée comme publique, nous envisageons de la changer en interne. Pour ces raisons, les solutions doivent uniquement se fier aux classes AadHttpClient et MSGraphClient.

Changements dans cette version

  • Nous avons résolu un problème de générateur qui empêchait l’activation des nouvelles versions des packages SPFx.
  • Symptômes : Vous déployez une nouvelle version des packages de SharePoint Framework et vous ne voyez plus vos composants WebPart dans le sélecteur de composant WebPart.

    • #775

    • Correctif :Pour corriger correctement et complètement cette erreur, vous devez effectuer les étapes suivantes dans vos clients SharePoint Online.

      1. Supprimer toutes les instances des solutions SharePoint Framework existantes à partir du niveau du site
      2. Supprimer la solution SharePoint Framework du catalogue d’applications
      3. Charger la nouvelle solution SharePoint Framework créée avec la version 1.4.1 vers votre catalogue d’applications
      4. Installer les solutions SharePoint Framework à nouveau vers les sites.

      Remarque

      Ce problème ne produit pas pour les solutions SharePoint Framework délimitées au client et il ne se produit pas pour les compléments SharePoint.

      Conseil

      Vous pourrez potentiellement tirer parti des API ALM (Application Lifecycle Management) pour automatiser ce processus nécessaire.

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

  • L’API GraphHttpClient est déconseillée en valeur de la nouvelle MSGraphClient introduite dans cette version. La GraphHttpClient sera supprimée dans une version future.