Dans ce didacticiel, nous discuterons de ce qu'est le fil , comment installer le gestionnaire de paquets Yarn sous Linux et enfin nous verrons l'utilisation de base de Yarn.
Introduction au fil
Fil, signifie Y et A autre R ressource N avigator, est un gestionnaire de packages moderne pour installer et gérer des programmes JavaScript dans les systèmes d'exploitation Linux, macOS et Windows.
Yarn est un gestionnaire de paquets rapide, sécurisé et fiable. Yarn est entièrement compatible avec le npm registry et peut travailler avec npm gestionnaire de paquets.
Il fait tout en même temps pour maximiser l'utilisation des ressources et met en cache tous les packages téléchargés. Il n'est donc pas nécessaire de télécharger le même package encore et encore. Yarn est également sécurisé par conception, car il utilise des sommes de contrôle avant l'installation pour garantir l'intégrité de chaque paquet.
Par défaut, Yarn prend en charge Node . Vous pouvez également étendre la prise en charge à d'autres langages de programmation à l'aide de plugins. Même si l'utilisation de la commande Yarn est similaire à Npm, elle comporte quelques commandes supplémentaires. Par exemple, il a "yarn why" commande qui vous indique pourquoi un certain paquet est installé.
Yarn a été initialement développé par Facebook pour traiter et résoudre les problèmes de performances et de sécurité avec npm. Now Yarn est un projet open source indépendant lié ni à Facebook ni à aucune autre entreprise.
Installer le gestionnaire de packages Yarn sous Linux
Yarn est disponible dans les dépôts par défaut de mes nombreuses distributions Linux. Cependant, la méthode officiellement recommandée pour installer Yarn utilise Npm , le gestionnaire de packages Nodejs.
Npm sera installé par défaut avec l'installation de Nodejs. Pour Nodejs sous Linux, reportez-vous au guide suivant :
- Comment installer NodeJS sur Linux
Après avoir installé Nodejs, utilisez npm pour installer Yarn sur votre machine Linux :
$ npm install -g yarn
Vérifiez la version de Yarn installée :
$ yarn --version
1.22.10
Comme vous pouvez le voir dans la sortie ci-dessus, la version installée de Yarn est 1.22.10 .
Mettre à niveau le fil 1.x vers le fil 2
Les développeurs de Yarn recommandent de migrer de la version 1.x de Yarn vers la version 2.x pour obtenir une expérience Yarn rapide et stable.
Pour migrer Yarn 1.x vers Yarn 2, accédez au dossier de votre projet et exécutez la commande suivante pour passer à la version Yarn 2 :
$ yarn set version berry
Ici, berry est le nom de code de la version de Yarn 2. Vous pouvez vérifier la version à l'aide de la commande :
$ yarn --version 2.4.1
Vous pouvez également utiliser la commande suivante pour mettre à niveau de manière permanente la version Yarn 1.x vers la version Yarn 2.x :
$ yarn set version latest
Vérifiez si Yarn est correctement mis à jour ou non à l'aide de la commande :
$ yarn --version
2.4.1
Génial! Yarn a été migré vers la version 2.x. Au moment de la rédaction de ce guide, la dernière version de Yarn était 2.4.1 .
Démarrer avec Yarn
Nous avons installé Yarn et l'avons mis à niveau vers la dernière version. Maintenant, apprenons quelques commandes Yarn de base.
1. Afficher la section d'aide
Pour afficher la liste des commandes Yarn disponibles, reportez-vous à la section d'aide Yarn en exécutant la commande suivante :
$ yarn help
Cette commande listera toutes les commandes Yarn, y compris leurs options/indicateurs, ainsi qu'une petite description de chaque commande. Vous pouvez également afficher la section d'aide de n'importe quelle sous-commande comme ci-dessous :
$ yarn add -h
Ou,
$ yarn add --help
Je suis vraiment impressionné par la section d'aide Yarn. La section d'aide de chaque sous-commande Yarn est soigneusement écrite avec des exemples de commandes. La section d'aide de toutes les commandes est très détaillée et toutes les options sont expliquées en détail. Je suppose que vous n'avez pas besoin de documentation en ligne. Tout peut être obtenu hors connexion.
2. Démarrer un nouveau projet
Exécutez la commande suivante pour démarrer un nouveau projet :
$ yarn init
Cette commande créera un nouveau projet avec le nom de l'utilisateur actuel.
Exemple de résultat :
{
name: 'ostechnix'
} 3. Installer les dépendances
Pour installer toutes les dépendances nécessaires à notre nouveau projet, exécutez :
$ yarn
Ou,
$ yarn install
4. Installer les packages
Nous pouvons installer des packages ou des dépendances supplémentaires en utilisant yarn add commande. Il existe plusieurs façons d'ajouter un nouveau package à l'aide de la commande yarn.
Pour ajouter un package standard, par exemple lodash , dans l'espace de travail actuel, exécutez :
$ yarn add lodash
Vous pouvez ajouter une version spécifique d'un package à l'espace de travail actuel avec la commande :
$ yarn add [email protected]
Vous pouvez également ajouter un package depuis la branche master d'un dépôt GitHub à l'espace de travail actuel à l'aide d'une URL :
$ yarn add [email protected]://github.com/lodash/lodash
Ou en utilisant le protocole GitHub comme ci-dessous :
$ yarn add [email protected]/lodash
Si vous souhaitez ajouter une autre catégorie de dépendances, utilisez --dev drapeau pour ajouter des dépendances de développement et --peer pour ajouter des dépendances entre pairs.
$ yarn add lodash --dev
$ yarn add lodash --peer
Comme je l'ai déjà dit, nous pouvons afficher la section d'aide d'une sous-commande Yarn en utilisant -h/--help drapeau :
$ yarn add -h
5. Forfaits de mise à niveau
Pour mettre à niveau un package à l'aide de Yarn, exécutez :
$ yarn up lodash
6. Afficher les informations sur le paquet
Pour afficher les informations relatives à un package, exécutez :
$ yarn info lodash
└─ [email protected]:4.17.21
└─ Version: 4.17.21
Si vous souhaitez afficher toutes les informations disponibles sur un paquet utilisant du fil, la commande serait :
$ yarn npm info lodash
7. Exécuter une commande shell
Nous pouvons exécuter une commande shell avec yarn exec commande.
Par exemple, affichons un texte Hello World avec Yarn comme ci-dessous :
$ yarn exec echo Hello World
Hello World
Afficher la version du noyau Linux avec la commande Yarn :
$ yarn exec uname -mrs
Linux 5.4.0-72-generic x86_64
8. Afficher pourquoi un paquet est installé
C'est l'une des caractéristiques uniques de Yarn. Yarn peut afficher la raison pour laquelle un package est installé.
$ yarn why lodash
9. Afficher les espaces de travail
L'autre caractéristique notable de Yarn est les espaces de travail. Workspace permet aux utilisateurs d'installer des dépendances à partir de plusieurs package.json fichiers dans les sous-dossiers d'une seule racine package.json fichier, le tout en une seule fois.
Pour imprimer tous les espaces de travail disponibles, exécutez :
$ yarn workspaces list
10. Afficher les paramètres de configuration actuels
Pour imprimer les paramètres de configuration actifs actuels, exécutez :
$ yarn config
11. Afficher les plug-ins
Pour imprimer les plugins disponibles directement depuis le référentiel Yarn, exécutez :
$ yarn plugin list
La commande ci-dessus affiche tous les plugins officiels disponibles. Si vous souhaitez afficher uniquement les plugins actuellement actifs, exécutez :
$ yarn plugin runtime
12. Télécharger les plugins
Nous pouvons télécharger et activer des plugins à partir du référentiel Yarn officiel ou de référentiels locaux ou tiers. Si vous ajoutez un plug-in à partir d'un référentiel tiers, saisissez l'URL du plug-in. Si vous ajoutez le plugin depuis votre système local, entrez simplement son chemin.
Pour télécharger et activer le plugin, par exemple plugin-version , à partir du référentiel Yarn, exécutez :
$ yarn plugin import @yarnpkg/plugin-version
13. Supprimer les plugins
Pour supprimer un plug-in importé du référentiel Yarn, exécutez :
$ yarn plugin remove @yarnpkg/plugin-stage
Si vous l'avez importé depuis le système local, mentionnez simplement son nom.
14. Supprimer les paquets
Pour désinstaller un package à l'aide de Yarn, exécutez :
$ yarn remove lodash
15. Supprimer le cache
Pour supprimer toutes les archives locales, exécutez :
$ yarn cache clean
Vous pouvez également supprimer toutes les archives stockées dans le ~/.yarn répertoire à l'aide de la commande :
$ yarn cache clean --mirror
Celles-ci sont juste suffisantes pour démarrer avec le gestionnaire de packages Yarn. Cependant, de nombreuses commandes sont disponibles. Je vous les laisse apprendre et expérimenter. Vous pouvez afficher la liste complète des commandes Yarn en utilisant yarn --help commande. Si vous ne connaissez pas l'utilisation d'une sous-commande spécifique, exécutez simplement "yarn sub-command -h" pour afficher la section d'aide de cette commande particulière.