Installation

Avant de commencer à utiliser Yarn, vous devez d’abord l'installer sur votre système. Il y a de plus en plus de façons d’installer Yarn :

Sélectionnez votre plateforme ci-dessus

macOS

Homebrew

Vous pouvez installer Yarn via le Gestionnaire de packages de Homebrew. Ceci va également installer Node.js s’il n’est pas déjà installé.

brew update
brew install yarn

MacPorts

Vous pouvez installer Yarn via MacPorts. Cela va également installer Node.js s’il n’est pas déjà installé.

sudo port install yarn

Configuration du chemin d’accès

Vous devrez changer la variable d’environnement PATH dans votre terminal pour avoir un accès global aux binaires de Yarn.

Ajouter export PATH = "$PATH : « yarn global bin  »" à votre profil (souvent contenu dans votre fichier ~/.profile, ~/.zshrc, ~/.bashrc, etc..)

Windows

Il y a deux options pour l’installation de Yarn sous Windows.

Télécharger l’installateur

Cela vous donnera un fichier .msi qui vous guidera dans l’installation de Yarn sous Windows, lorsque vous l’exécuterez.

Si vous utilisez le programme d’installation, vous devrez d’abord installer Node.js.

Télécharger l’installateur

Installer via Chocolatey

Chocolatey est un gestionnaire de packages pour Windows, vous pouvez installer Chocolatey en suivant ces instructions.

Une fois que vous avez Chocolatey installé, vous pouvez installer yarn en exécutant le code suivant dans votre console :

choco install yarn

Cela garantit également que Node.js soit installé.

Remarque

Veuillez ajouter le répertoire de votre projet et le répertoire du cache de Yarn (%LocalAppData%\Yarn) dans la liste blanche de votre logiciel antivirus, sinon l’installation des packages seront significativement plus lents car chaque fichier sera analysé lorsqu’il est écrit sur le disque.

Debian/Ubuntu Linux

Sur Debian ou Ubuntu Linux, vous pouvez installer Yarn par l’intermédiaire de notre dépôt de packages Debian. Vous devrez tout d’abord configurer le référentiel :

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

Sur Ubuntu 14.04 et Debian version stable, vous devez également configurer le référentiel NodeSource pour obtenir une version assez récente de Node.js (Debian Testing et Ubuntu 16.04 embarquent une version suffisante de Node.js, cette étape n’est donc pas requise dans ces environnements)

Ensuite, vous pouvez tout simplement :

sudo apt-get update && sudo apt-get install yarn

CentOS / Fedora / RHEL

Sur CentOS, Fedora et RHEL, vous pouvez installer Yarn par l’intermédiaire de notre dépôt de packages RPM.

sudo wget https://dl.yarnpkg.com/rpm/yarn.repo -O /etc/yum.repos.d/yarn.repo

Si vous n’avez pas déjà Node.js d’installé, vous devez également configurer le référentiel de NodeSource :

curl --silent --location https://rpm.nodesource.com/setup_6.x | bash -

Ensuite, vous pouvez tout simplement :

sudo yum install yarn

Arch Linux

Sur Arch Linux Yarn peut être installé via AUR.

Si vous utilisez un AUR Helper tels que yaourt, vous pouvez simplement exécuter :

yaourt -S yarn

Solus

Sur Solus, vous pouvez installer yarn via le référentiel Solus.

sudo eopkg install yarn

Configuration du chemin d’accès

Vous devrez changer la variable d’environnement PATH dans votre terminal pour avoir un accès global aux binaires de Yarn.

Ajouter export PATH = "$PATH : « yarn global bin  »" à votre profil (souvent contenu dans votre fichier ~/.profile, ~/.zshrc, ~/.bashrc, etc..)

Alternatives

Si vous utilisez un autre OS ou si une des autres options spécifiques à votre système d’exploitation ne fonctionne pas pour vous, il y a quelques solutions de rechange. Vous devrez installer Node.js si vous ne l’avez pas déjà installé.

Sur les distributions Linux courantes telles que Debian, Ubuntu et CentOS, il est recommandé d’installer Yarn par l’intermédiaire de nos packages à la place.

Script d’installation

Une des façons les plus faciles d’installer Yarn sur macOS et les environnements Unix génériques est via notre script shell. Vous pouvez installer Yarn en exécutant le code suivant dans votre terminal :

curl -o- -L https://yarnpkg.com/install.sh | bash

Le processus d’installation inclut la vérification d’une signature GPG. Voir la source sur GitHub

Vous pouvez également spécifier une version en exécutant le code suivant dans votre terminal :

curl -o- -L https://yarnpkg.com/install.sh | bash -s -- --version [version]

Voir les versions possibles.

Installation manuelle via une archive tar

Vous pouvez installer Yarn en téléchargeant une archive tar et l’extraire n’importe où.

cd /opt
wget https://yarnpkg.com/latest.tar.gz
tar zvxf latest.tar.gz
# Yarn is now in /opt/yarn-[version]/

Installer via npm

Remarque : L’installation via npm n’est généralement pas recommandée. Npm est non déterministe, les packages ne sont pas signés, et npm ne réalise pas de vérification d’intégrité autre qu’un hash SHA1 basique, ce qui comporte des risques de sécurité quand on installe des applications globalement sur le système.

Pour ces raisons, il est fortement recommandé que vous installez Yarn par la méthode d’installation la mieux adaptée à votre système d’exploitation.

Vous pouvez également installer Yarn via le gestionnaire de paquets npm, si vous l’avez déjà installé sur votre système. Si vous avez déjà Node.js installé alors npm sera déjà installé.

Une fois que vous avez installé npm, vous pouvez exécuter :

npm install --global yarn

Configuration du chemin d’accès

Unix/Linux/macOS

Vous devrez changer la variable d’environnement PATH dans votre terminal pour avoir un accès global aux binaires de Yarn.

Ajouter export PATH = "$PATH : « yarn global bin  »" à votre profil (souvent contenu dans votre fichier ~/.profile, ~/.zshrc, ~/.bashrc, etc..)

Windows

Vous devrez changer la variable d’environnement PATH dans votre terminal pour avoir un accès global aux binaires de Yarn.

Ajoutez set PATH=%PATH%;C:\.yarn\bin à votre environnement de shell.

Vérifiez que Yarn est bien installé en exécutant :

yarn --version

Nightly Builds

Les "nightly builds" sont les dernières et meilleures versions de Yarn, compilées en utilisant le dernier code source de Yarn. Les "nightly builds" sont utiles pour essayer de nouvelles fonctionnalités ou tester des corrections de bugs qui n’ont pas encore été publiés dans le cadre d’une version stable. Cependant, ces versions ne sont pas garanties d’être stables et peuvent contenir des bugs.

Consultez comment installer les nightly builds


Un problème ? Si vous ne réussissez pas à installer Yarn avec aucun de ces programmes d’installation, veuillez chercher sur GitHub un problème similaire ou bien créez en un nouveau.

Chercher un problème existant · Ouvrir un nouveau problème