Yarn Install : comment configurer le gestionnaire de paquets pour JavaScript ?

Pour installer Yarn, vous devez d’abord configurer la version complète, puis une version de projet unique. Vous pouvez ensuite personnaliser le gestionnaire de paquets comme vous le souhaitez.

Yarn Install : guide étape par étape

Le gestionnaire de packages JavaScript Yarn a été développé pour Node.js et est devenu l’une des options les plus populaires dans son segment depuis sa publication en 2016. Comme la configuration et les premiers pas ne sont pas toujours faciles, nous vous fournissons ici un guide détaillé pour installer Yarn. Vous devez au préalable déjà avoir configuré Node.js.

Les conditions préalables à l’installation de Yarn

Il n’y a que peu de conditions préalables à remplir pour installer Yarn. En plus de Node.js, vous devez avoir mis en place une distribution Linux comme Ubuntu comme système d’exploitation pour l’installation. Vous devez également disposer du gestionnaire de paquets npm et d’un compte avec privilèges sudo. Si vous n’êtes pas sûr de la présence de Node.js sur votre système, vous pouvez le vérifier avec la commande suivante :

$ node -v

Cela vous indiquera quelle version est présente sur votre système. Si vous recevez une confirmation, l’installation de Yarn peut commencer.

Télécharger et installer Yarn

Pour installer Yarn, vous devez en principe configurer deux versions du gestionnaire de paquets. Dans la première étape, vous téléchargez la version complète du programme. Cela garantit que tous les membres de votre équipe utilisent la même version pour éviter les conflits, et minimiser ainsi les risques d’erreur. Pour installer la version complète, il est préférable d’utiliser le gestionnaire de paquets npm. La commande correspondante ressemble à ceci :

$ sudo npm install -g yarn

Demandez ensuite le numéro de version pour vous assurer que vous avez reçu les derniers paquets. Voici la commande :

$ yarn --version

Installer Yarn localement

Ensuite, configurez Yarn pour un projet JavaScript spécifique. Pour cela, accédez d’abord au répertoire de votre projet. Pour cela, remplacez le caractère générique « votre-projet » par le nom réel du projet. Il s’agit de la commande :

cd ~/votre-projet

Si vous n’avez pas encore de dossier de projet, créez-le à l’aide de mkdir :

mkdir votre-projet
cd votre-projet

Utilisez maintenant la commande yarn set pour récupérer la version Yarn Berry :

$ yarn set version berry

Si elle est disponible, la dernière version de Yarn Berry sera téléchargée. Enregistrez-la dans un dossier de projet nommé .yarn/releases et créez un fichier de configuration nommé .yarnrc.yml. Voici la sortie appropriée :

Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/user/votre-projet/.yarn/releases/yarn-berry.cjs...
Updating /home/user/votre-projet/.yarnrc.yml...
Done!

Effectuez à nouveau une vérification de la version :

$ yarn --version

Si Yarn Berry a été correctement installé, vous obtiendrez le résultat suivant (le numéro de version varie en fonction de la version actuelle) :

3.0.0

Les commandes à connaître

Après l’installation de Yarn, vous pouvez commencer à utiliser le gestionnaire de paquets. Il vaut la peine de jeter un coup d’œil aux commandes de base afin de pouvoir l’utiliser de manière ciblée. Nous vous présentons brièvement les commandes les plus importantes dans les sections suivantes.

Démarrer un nouveau projet

Pour démarrer un nouveau projet, utilisez la commande init. Celle-ci crée un nouveau projet et tous les fichiers dont vous avez besoin pour le réaliser :

yarn init

Enregistrer et créer des dépendances

Si vous avez déjà un projet et que vous souhaitez y stocker toutes les dépendances, utilisez la commande yarn install :

yarn install

Pour créer de nouvelles dépendances, utilisez add. Dans le code suivant, remplacez le caractère de remplacement « nom_du_paquet » par le nom réel du paquet souhaité :

yarn add nom_du_paquet

La meilleure configuration pour .gitignore

Tous les fichiers sont stockés dans le dossier .yarn de votre projet. Vous pouvez laisser certains de ces fichiers de côté. Pour cela, utilisez la configuration suivante pour votre fichier .gitignore :

.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

Aide et informations complémentaires

Si vous avez besoin d’aide ou d’informations supplémentaires après l’installation de Yarn, --help peut vous être utile :

$ yarn --help

Si vous avez besoin d’aide pour une commande spécifique, il suffit de la combiner avec --help. Voici un exemple avec la commande yarn install :

$ yarn install --help

Quelles sont les alternatives à Yarn ?

Yarn est une solution fortement recommandée si vous souhaitez partager ou utiliser du code en toute sécurité. Néanmoins, il existe aussi des alternatives solides que vous pouvez installer et utiliser à la place de Yarn.

npm

Sans surprise, npm (Node Package Manager) mérite d’être considéré pour travailler avec Node.js : son utilisation est simple, rapide, sûre et parfaitement adaptée à Node.js. La solution offre un registre de plus de 1,3 million de packages ainsi qu’une interface ILC. Dans le cadre de ce guide d’installation de Yarn, nous avons également eu recours aux services de npm.

pnpm

pnpm est également un gestionnaire de paquets open source, parfaitement adapté au travail avec JavaScript. Sa structure est similaire à celle de npm, mais il utilise des symlinks et évite d’installer plusieurs fois des paquets identiques en local. Cette solution a été développée pour offrir une alternative encore plus efficace à npm, d’où son intérêt en tant que substitut de Yarn.

Bower

La troisième alternative est Bower, un gestionnaire de paquets libre pour le développement Web côté client, qui a été optimisé pour le travail en frontend. Pour cela, un grand choix de paquets est également disponible. Outre JavaScript, le gestionnaire peut également travailler avec d’autres composants comme HTML et CSS. L’utilisation est très simple et fonctionne via une ligne de commande Node.js.