Installation

Stable: v1.2.0
Node: ^4.8.0 and >= 5.7.0
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 install yarn

Si vous utilisez nvm ou similaire, vous devez exclure l’installation de Node.js afin que la version nvm de Node.js soit utilisée.

brew install yarn --without-node

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

Si vous choisissez une installation manuelle, les étapes suivantes ajouteront Yarn à la variable path et permettront de l’exécutez de n’importe où.

Remarque : votre profil peut être dans votre .profile, .bash_profile, .bashrc, .zshrc, etc.

  1. Ajouter ceci à votre profil : export PATH="$PATH:/opt/yarn-[version]/bin" (le chemin d’accès peut varier en fonction de l’endroit où vous avez extrait Yarn)
  2. Dans le terminal, connectez-vous puis déconnectez-vous pour que les modifications prennent effet

Pour avoir accès globalement aux exécutables de Yarn, vous aurez besoin de configurer la variable d’environnement PATH dans votre terminal. Pour faire ceci, ajoutez export PATH="$PATH:`yarn global bin`" à votre profil.

Mettre à jour Yarn

Yarn vous avertira si une nouvelle version est disponible. Pour mettre à jour Yarn, vous pouvez le faire avec Homebrew.

brew upgrade yarn

Windows

Il y a trois 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é.

Installer via Scoop

Scoop est un programme d’installation en ligne de commande pour Windows, vous pouvez installer Scoop en suivant ces instructions.

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

scoop install yarn

Si Node.js n’est pas installé, scoop vous proposera de l’installer. Exemple :

scoop install nodejs

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 16.04 ou version antérieure et sur Debian Stable, vous devrez également configurer le dépôt NodeSource pour obtenir une version assez récente de Node.js.

Ensuite, vous pouvez tout simplement :

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

Remarque : Ubuntu 17.04 est livré avec cmdtest installé par défaut. Si vous obtenez des erreurs lors de l’installation de yarn, vous pouvez exécuter sudo apt remove cmdtest en premier. Se référer à ceci pour plus d’informations.

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 | sudo bash -

Ensuite, vous pouvez tout simplement :

sudo yum install yarn
## OU ##
sudo dnf install yarn

Arch Linux

Sur Arch Linux, Yarn peut être installé via le gestionnaire de package officiel.

pacman -S yarn

Solus

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

sudo eopkg install yarn

Alpine

Sur Alpine Linux (3.6+), vous pouvez installer yarn avec apk.

apk add yarn

Configuration du chemin d’accès

Si vous choisissez une installation manuelle, les étapes suivantes ajouteront Yarn à la variable path et permettront de l’exécutez de n’importe où.

Remarque : votre profil peut être dans votre .profile, .bash_profile, .bashrc, .zshrc, etc.

  1. Ajouter ceci à votre profil : export PATH="$PATH:/opt/yarn-[version]/bin" (le chemin d’accès peut varier en fonction de l’endroit où vous avez extrait Yarn)
  2. Dans le terminal, connectez-vous puis déconnectez-vous pour que les modifications prennent effet

Pour avoir accès globalement aux exécutables de Yarn, vous aurez besoin de configurer la variable d’environnement PATH dans votre terminal. Pour faire ceci, ajoutez export PATH="$PATH:`yarn global bin`" à votre profil.

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]/

Avant l’extraction de Yarn, il est recommandé de vérifier l’archive en utilisant GPG :

wget -qO- https://dl.yarnpkg.com/debian/pubkey.gpg | gpg --import
wget https://yarnpkg.com/latest.tar.gz.asc
gpg --verify latest.tar.gz.asc
# Look for "Good signature from 'Yarn Packaging'" in the output

Installer via npm

Remarque : L’installation de Yarn via npm n’est généralement pas recommandée. Lorsque vous installez Yarn avec les gestionnaires de package de base de Node, le package n’est pas signé et la vérification d’intégrité est uniquement effectuée par un simple hachage SHA-1, ce qui est un risque pour la sécurité lors de l’installation des apps sur l’ensemble du 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

Si vous choisissez une installation manuelle, les étapes suivantes ajouteront Yarn à la variable path et permettront de l’exécutez de n’importe où.

Remarque : votre profil peut être dans votre .profile, .bash_profile, .bashrc, .zshrc, etc.

  1. Ajouter ceci à votre profil : export PATH="$PATH:/opt/yarn-[version]/bin" (le chemin d’accès peut varier en fonction de l’endroit où vous avez extrait Yarn)
  2. Dans le terminal, connectez-vous puis déconnectez-vous pour que les modifications prennent effet

Pour avoir accès globalement aux exécutables de Yarn, vous aurez besoin de configurer la variable d’environnement PATH dans votre terminal. Pour faire ceci, ajoutez export PATH="$PATH:`yarn global bin`" à votre profil.

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