Comment installer des packages de bibliothèque Azure pour JavaScript

Le Kit de développement logiciel (SDK) Azure pour JavaScript est composé de nombreuses bibliothèques avec version indépendantes qui peuvent être installées dans des environnements JavaScript standard. Cette approche modulaire vous permet d’installer uniquement les packages dont vous avez besoin et de les gérer individuellement pour mieux contrôler les dépendances et les mises à jour.

Les bibliothèques pour les environnements JavaScript standard sont répertoriées dans l’index des packages, et tous les packages Azure sont publiés sous les @azure et @azure-rest étendues. Ces packages sont gérés par Microsoft et sont disponibles sur npm sous l'éditeur microsoft1es. Cette structure vous permet de provisionner et de gérer facilement des ressources Azure à l’aide de bibliothèques de gestion (avec des noms commençant @azure/arm-par) et d’interagir avec ces ressources à partir de votre code d’application.

Conditions préalables

• Node.js LTS.
  En savoir plus sur la compatibilitéNode.js pour Azure.
• npm ou yarn.
  Vérifiez que votre gestionnaire de package est up-to-date pour éviter les problèmes d’installation.

Si vous rencontrez des problèmes lors de l’installation des packages, consultez notre guide de résolution des problèmes.

Installer la dernière version d’une bibliothèque

Lorsque vous installez une bibliothèque sans spécifier de version, le gestionnaire de package récupère la dernière version disponible à partir de l’index du package.

npm

npm install <library>

yarn add <library>

Installer des versions de bibliothèque spécifiques

Parfois, vous devrez peut-être installer une version particulière ou une préversion d’une bibliothèque pour les tests de compatibilité ou obtenir un accès anticipé aux nouvelles fonctionnalités. Lorsque vous installez une version spécifique, vous épinglerez votre dépendance, ce qui signifie que votre projet continuera à utiliser cette version et ne recevra pas automatiquement les mises à jour ou les correctifs. Bien que l’épinglage puisse être utile dans certains scénarios, nous vous recommandons d’utiliser plutôt la dernière version dans la mesure du possible afin de tirer parti des améliorations continues et des mises à jour de sécurité.

npm

npm install <library>@<version-number>

yarn add <library>@<version-number>

Packages de la version préliminaire

Lors de l’installation des packages en préversion, recherchez des balises de préversion. Ces packages fournissent un accès anticipé aux nouvelles fonctionnalités, mais peuvent ne pas être aussi stables que les versions générales. Par exemple:

• next: cette balise est utilisée pour la version bêta actuelle de la prochaine version.
• dev: cette balise est utilisée pour la version alpha actuelle de la prochaine version.

Vérifier une installation de bibliothèque

Après l’installation, vous pouvez vérifier que la version correcte de la bibliothèque est installée.

npm

npm list <library>

yarn list <library>

Désinstaller une bibliothèque

npm

npm uninstall <library>

yarn remove <library>

Résolution des problèmes

• Erreurs d’installation : vérifiez que Node.js et votre gestionnaire de packages (npm ou yarn) sont à jour.
• Conflits de version : vérifiez que la version spécifiée est disponible dans l’index du package.
• Problèmes réseau : vérifiez vos paramètres de connexion Internet et de proxy si les téléchargements de package sont lents ou défaillants.

Ressources supplémentaires

• Index de la bibliothèque du Kit de développement logiciel (SDK) Azure Parcourir les packages disponibles.
• Node.js compatibilité pour Azure : découvrez les versions de Node.js prises en charge.
• Résolution des problèmes npm et yarn : instructions courantes de résolution des problèmes d’erreur.
• Dépôt GitHub du Kit de développement logiciel (SDK) Azure : pour signaler des problèmes et contribuer.