Installer n'importe quel module NPM Node.js sous Windows

Si vous avez déjà tenté d'installer des modules NPM pour Node.js via la commande npm install <package> [options] sous Windows, vous avez probablement déjà eu des soucis d'installation et abandonné l'idée. Peut-être même que vous ne vous êtes pas lancé dans l'aventure Node.js pour ces raisons ? Effectivement, certains modules ont besoin de Python pour s'installer et d'autres de Visual Studio. Il y en à même, plus rare, qui on besoin de GIT.

Par exemple, NodeAtlas est un module qui nécessite que Python soit installé pour que les fonctions permettant l'optimisation d'images s'installent correctement sous Windows. Socket.io a, lui, besoin de Visual Studio pour être installé sans quoi il ne fonctionnera pas.

Voici la procédure d'installation des pré-requis nécessaires pour faire fonctionner Node.js et tous ses modules NPM sous Windows ainsi qu'une aide à la résolution de problèmes divers après installation.

Étape 1 : Installer Python

Python 2.7 (et non les versions 3.X ou 2.6.X et précédente) est requis par l'installeur npm pour installer les addons à compiler.

  1. Rendez-vous sur python.org pour télécharger la dernière version stable de Python 2.7 du Windows MSI Installer afin d'installer la version x86 ou x86-64 en fonction de votre système d'exploitation.

  2. Lancez l'installeur et assurez vous d'ajouter Python à votre variable d'environnement PATH.

  3. Acceptez l'« installation pour tous les utilisateurs ».

  4. Acceptez le chemin d'installation par défaut « C:\Python27 ».

Étape 2 : Installer GIT

GIT est nécessaire pour l’installation de package en provenance de GitHub ou autre plateforme GIT. Bien que ces modules soient rares, il ne sont pas inexistant. Vous pourrez donc également les installer.

  1. Rendez-vous sur git-scm.com et téléchargez la dernière version pour Windows.

2 Lancez l'installeur.

  1. Acceptez la localisation par défaut.

  2. Accepter l'icône de démarrage menu.

  3. Accepter les composants associés.

6 Modifiez « Adjusting your PATH environment » to « Use Git from Windows Command Prompt ».

  1. Acceptez la valeur « Configuring the line ending conversions » par défaut.

Étape 3 : Installer Visual Studio

Visual Studio 2012 ou plus est requis par npm pour installer les addons à compiler. Notez bien que gcc, mingw, cygwin, et les autres compilateurs Windows non-Microsoft ne sont pas supporté par Node.js.

Si vous utilisez actuellement Windows 7, 8 ou même 10, vous pouvez à la place utiliser Visual Studio C++ 2013 pour Windows Desktop (Express). Visual Studio Express est gratuit et est plus adéquat pour un support de Node.js.

  1. Téléchargez Visual Studio.

  2. Cliquez sur « Download » et sélectionnez « wdexpress_full.exe ».

  3. Lancez l'installeur et acceptez la localisation par défaut. C'est une grosse installation qui peut prendre longtemps !

Étape 4 : Installer Node.js

Si vous aviez déjà installé Node.js avant de réaliser les étapes de cet article, vous pouvez toujours en profiter pour le mettre à jour avec la dernière version. Sinon téléchargez le pour la première fois.

  1. Allez sur nodejs.org et installez la version appropriée pour votre système d'exploitation.

  2. Installez Node.js en suivant les instructions de l'installeur. Plus de détails par ici si vous le souhaitez.

Vérifier que tout fonctionne correctement

Si vous rencontrez des difficultés à installer des modules NPM, essayez les étapes suivantes pour identifier un problème de votre côté.

  1. Redémarrez Windows pour être sur que toutes les configurations est pris effet.

  2. Vérifiez que tous les pré-requis soient correctement installés et accessibles :

    • La commande python --version doit retourner 2.7.x
    • La commande node --version doit retourner v0.10.x ou plus.
    • La commande npm --version doit retourner 1.x ou plus.
  3. Assurez vous que npm -g prefix pointe au même endroit que echo %NODE_PATH%(avec \node_modules en plus à la fin).

  4. Vérifiez qu'un simple module NPM peut-être installé :

    • Avec npm install -g semver
    • et semver --help qui doit afficher l'aide.
  5. Assurez vous que si vous avez plusieurs version de Python ou Visual Studio sur votre machine, les astuces dans la partie « Astuces » ci-après ne résolvent pas le problème.

  6. Assurez vous que les addons à compiler peuvent être installées :

    • Avec npm install -g socket.io qui doit compiler sans erreur.

Si vous avez toujours des erreurs et que toutes les étapes précédentes sont valides, vous pouvez reporter le fichier npm-debug.log laissé par npm dans le tracker d'issue du/des développeur(s) du module npm que vous tentez d'installer pour obtenir de l'aide.

N'hésitez pas à laisser plus d'étapes de vérifications dans les commentaires de cet article, je les mettrais à jour ici même.

Astuces

  • Si vous avez plusieurs versions de Python d'installées, vous pouvez sélectionner celle utilisée par npm pour compiler les addons :

    • npm config set python C:/Python2.7/python
  • Si vous avez plusieurs versions de Microsoft Visual Studio d'installées, vous pouvez sélectionner celle utilisée par npm pour compiler les addons :

    • Par défaut (et récursivement) npm config set msvs_version 2013 (si votre version est 2013) ou
    • Ponctuellement npm install [options] <module-name> --msvs_version=2013 lors de l'installation d'un module.