Passer au contenu principal

Préparer votre environnement local

Avant de commencer à explorer l'univers Jutro, assurez-vous d'avoir installé les outils nécessaires.

Note: Utilisateurs Windows uniquement

Pour installer des outils à partir de commandes shell, exécutez PowerShell en tant qu’administrateur pour éviter les problèmes d’autorisation.

Installer Visual Studio Code​

  1. Ouvrez la page https://code.visualstudio.com/ et téléchargez le programme d'installation correspondant à votre système.
  2. Suivez les instructions d'installation.

Installer Git​

Une fois que vous avez installé Git, vous pouvez l'utiliser directement dans VS Code pour valider et appliquer des modifications, créer des branches, etc.

  1. Ouvrez la page https://git-scm.com/downloads et téléchargez le programme d'installation correspondant à votre système.

Installer Node.js​

Installez une version Node.js compatible avec l’application de démarrage :

  • Version Node : >=22.6.0 < 23
  • npm: >=10.8.2
  1. Ouvrez https://nodejs.org/download/release/ et recherchez la version de Node à installer. Par exemple, si vous souhaitez télécharger la version 22.6.0, vous devez rechercher « v22.6.0 ». Vous obtiendrez également la version NPM associée.
Important: Utilisez le programme d’installation Node.js correspondant à l’architecture de votre ordinateur. Pour les systèmes 64 bits (les plus courants), téléchargez le programme d’installation 64 bits (x64). Pour les systèmes 32 bits, téléchargez le programme d’installation 32 bits (x86).

Avertissement : lors de l'utilisation d'une version 32 bits de Node, il peut être nécessaire de configurer des bibliothèques/DLL/compilateur C (C++) supplémentaires sur votre ordinateur pour certaines dépendances indirectes de Jutro (par exemple canvas). En effet, leurs versions prédéfinies pourraient ne pas être disponibles pour l'architecture 32 bits. Dans ce cas, ils devront probablement être construits localement à partir de leurs sources par node-gyp (ce qui nécessitera des outils supplémentaires sur votre machine).

Note: Vous pouvez également installer Node Version Manager (nvm) (ou sa variante dédiée pour le système d'exploitation Windows), puis l'utiliser pour installer la version de Node compatible. Avec nvm, vous pouvez également facilement passer à la version appropriée de Node requise pour exécuter l'application de démarrage. Ceci est utile si vous avez déjà installé d'autres versions.
  1. Pour vérifier si vous possédez la bonne version de Node, ouvrez une nouvelle fenêtre de ligne de commande et exécutez :
node -v

Installer les dépendances de node-gyp​

node-gyp est requis par de nombreuses dépendances de Jutro, mais en lui-même, il nécessite également l'installation de plusieurs bibliothèques/outils globaux sur votre système pour fonctionner correctement.

  1. Installez les outils et les bibliothèques nécessaires pour votre système d’exploitation :

    a. Unix

    b. macOS

    c. Windows

  2. Configurez node-gyp pour référencer une version de Python appropriée sur votre machine, en suivant les node-gyp recommandations.

NOTE : Si la version de Python requise par node-gyp n'est pas installée, nous vous recommandons de l'installer au moyen de l'outil de gestion des versions appelé pyenv (ou de sa variante dédiée pour le système d'exploitation Windows).