Yarn Install : comment con­fi­gu­rer le ges­tion­naire de paquets pour Ja­vaS­cript ?

Pour installer Yarn, vous devez d’abord con­fi­gu­rer la version complète, puis une version de projet unique. Vous pouvez ensuite per­son­na­li­ser le ges­tion­naire de paquets comme vous le souhaitez.

Yarn Install : guide étape par étape

Le ges­tion­naire de packages Ja­vaS­cript Yarn a été développé pour Node.js et est devenu l’une des options les plus po­pu­laires dans son segment depuis sa pu­bli­ca­tion en 2016. Comme la con­fi­gu­ra­tion et les premiers pas ne sont pas toujours faciles, nous vous four­nis­sons ici un guide détaillé pour installer Yarn. Vous devez au préalable déjà avoir configuré Node.js.

Les con­di­tions préa­lables à l’ins­tal­la­tion de Yarn

Il n’y a que peu de con­di­tions préa­lables à remplir pour installer Yarn. En plus de Node.js, vous devez avoir mis en place une dis­tri­bu­tion Linux comme Ubuntu comme système d’ex­ploi­ta­tion pour l’ins­tal­la­tion. Vous devez également disposer du ges­tion­naire de paquets npm et d’un compte avec pri­vi­lè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 con­fir­ma­tion, l’ins­tal­la­tion de Yarn peut commencer.

Té­lé­char­ger et installer Yarn

Pour installer Yarn, vous devez en principe con­fi­gu­rer deux versions du ges­tion­naire de paquets. Dans la première étape, vous té­lé­char­gez 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 ges­tion­naire de paquets npm. La commande cor­res­pon­dante 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 lo­ca­le­ment

Ensuite, con­fi­gu­rez Yarn pour un projet Ja­vaS­cript spé­ci­fique. Pour cela, accédez d’abord au ré­per­toire 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 main­te­nant la commande yarn set pour récupérer la version Yarn Berry :

$ yarn set version berry

Si elle est dis­po­nible, la dernière version de Yarn Berry sera té­lé­char­gée. En­re­gis­trez-la dans un dossier de projet nommé .yarn/releases et créez un fichier de con­fi­gu­ra­tion nommé .yarnrc.yml. Voici la sortie ap­pro­prié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é­ri­fi­ca­tion de la version :

$ yarn --version

Si Yarn Berry a été cor­rec­te­ment installé, vous ob­tien­drez 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’ins­tal­la­tion de Yarn, vous pouvez commencer à utiliser le ges­tion­naire 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é­sen­tons briè­ve­ment les commandes les plus im­por­tantes 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

En­re­gis­trer et créer des dé­pen­dances

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

yarn install

Pour créer de nouvelles dé­pen­dances, utilisez add. Dans le code suivant, remplacez le caractère de rem­pla­ce­ment « nom_du_paquet » par le nom réel du paquet souhaité :

yarn add nom_du_paquet

La meilleure con­fi­gu­ra­tion 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 con­fi­gu­ra­tion suivante pour votre fichier .gitignore :

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

Aide et in­for­ma­tions com­plé­men­taires

Si vous avez besoin d’aide ou d’in­for­ma­tions sup­plé­men­taires après l’ins­tal­la­tion de Yarn, --help peut vous être utile :

$ yarn --help

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

$ yarn install --help

Quelles sont les al­ter­na­tives à Yarn ?

Yarn est une solution fortement re­com­man­dée si vous souhaitez partager ou utiliser du code en toute sécurité. Néanmoins, il existe aussi des al­ter­na­tives 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 tra­vail­ler avec Node.js : son uti­li­sa­tion est simple, rapide, sûre et par­fai­te­ment 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’ins­tal­la­tion de Yarn, nous avons également eu recours aux services de npm.

pnpm

pnpm est également un ges­tion­naire de paquets open source, par­fai­te­ment adapté au travail avec Ja­vaS­cript. Sa structure est similaire à celle de npm, mais il utilise des symlinks et évite d’installer plusieurs fois des paquets iden­tiques en local. Cette solution a été dé­ve­lop­pée pour offrir une al­ter­na­tive encore plus efficace à npm, d’où son intérêt en tant que substitut de Yarn.

Bower

La troisième al­ter­na­tive est Bower, un ges­tion­naire de paquets libre pour le dé­ve­lop­pe­ment Web côté client, qui a été optimisé pour le travail en frontend. Pour cela, un grand choix de paquets est également dis­po­nible. Outre Ja­vaS­cript, le ges­tion­naire peut également tra­vail­ler avec d’autres com­po­sants comme HTML et CSS. L’uti­li­sa­tion est très simple et fonc­tionne via une ligne de commande Node.js.