Встановлення

Стабільний: v1.3.2 Реліз-кандидат v1.4.0
Node: ^4.8.0 || ^5.7.0 || ^6.2.2 || ^8.0.0
Перед тим, як почати працювати з Yarn, вам треба його встановити. Існує багато варіантів, як це зробити:

Оберіть платформу

macOS

Homebrew

Ви можете встановити Yarn через менеджер пакетів Homebrew. Це також встановить Node.js, якщо він ще не встановлений.

brew install yarn

Якщо ви користуєтесь nvm або щось схожим, то вам краще не встановлювати Node.js, для того, щоб використалась версія nvm з Node.js.

brew install yarn --without-node

MacPorts

Ви можете встановити Yarn через MacPorts. Це також встановить Node.js, якщо він ще не встановленний.

sudo port install yarn

Налаштування змінних середовища

Якщо ви вибрали встановлення власноруч, то наступні кроки додадуть Yarn до змінної Path і Yarn буде доступним звідусіль в системі.

Примітка: ваш профіль може бути в файлі .profile, .bash_profile, .bashrc, .zshrc, тощо.

  1. Додайте цей рядок до вашого файлу з профілем: export PATH="$PATH:/opt/yarn-[version]/bin" (шлях може бути різним, в залежності від того, куди ви встановили Yarn)
  2. В терміналі, зайдіть і вийдіть із системи, щоб зміни набрали чинності

Щоб глобально мати доступ до виконуваних файлів Yarn, вам необхідно встановити PATH змінну оточення в вашому терміналі. Щоб це зробити, додайте export PATH="$PATH:`yarn global bin`" до файлу з вашим профілем.

Оновлення Yarn

Yarn попередить вас, якщо доступна новіша версія. Щоб оновити Yarn, ви можете скористатися Homebrew.

brew upgrade yarn

Windows

Існує 3 варіанта встановлення Yarn на Windows.

Завантажити встановлювач

Завантажиться .msi файл, який після запуску допоможе встановити Yarn на Windows.

Спершу вам треба встановити Node.js, якщо ви користуєтесь встановлювачем.

Завантажити встановлювач

Встановити за допомогою Chocolatey

Chocolatey - це менеджер пакетів для Windows, який ви можете встановити за допомогою інструкції.

Коли ви встановили Chocolatey, ви можете встановити Yarn, запустивши наступний код в терміналі:

choco install yarn

Це також гарантує встановлення Node.js.

Встановити за допомогою Scoop

Scoop це консольний встановлювач для Windows, ви можете встановити Scoop за допомогою цих інструкцій.

Коли ви встановите Scoop, ви зможете встановити yarn, виконавши цю команду в консолі:

scoop install yarn

Якщо Node.js не встановлено, scoop запропонує вам його встановити. Наприклад:

scoop install nodejs

Примітка

Додайте до списку виключень антивіруса теку кеша Yarn (%LocalAppData%\Yarn). В іншому випадку встановлення пакетів буде значно довшим, так як кожен файл буде перевірятися антивірусом під час запису на диск.

Debian/Ubuntu Linux

На системах Debian або Ubuntu Linux ви можете інсталювати Yarn за допомогою наших Debian пакетів. Для цього вам спочатку потрібно сконфігурувати репозиторій:

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

На Ubuntu 16.04 або нижче і на Debian Stable, вам також необхідно налаштувати NodeSource репозиторій, щоб отримувати новіші версії Node.js.

Після цього ви можете просто виконати наступну команду:

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

Примітка: Ubuntu 17.04 поставляється з cmdtest, встановленим за замовчуванням. Якщо ви отримуєте помилки з установкою yarn, ви можете спочатку запустити sudo apt remove cmdtest. Зверніться сюди для більшої інформації.

Якщо ви користуєтесь nvm, то ви можете пропустити установку node наступним чином:

sudo apt-get install --no-install-recommends yarn

Примітка: оскільки в деяких дистрибутивах node має назву nodejs, то yarn може не сподобаться, що немає node, щоб цього уникнути, ви можете додати синонім до вашого файлу .bashrc, наприклад: alias nodejs=node. Це укаже yarn використовувати будь-яку версію node.

CentOS / Fedora / RHEL

На CentOS, Fedora та RHEL ви можете інсталювати Yarn за допомогою нашого RPM репозиторію пакетів.

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

Якщо Node.js не встановлений у вашій системі, вам також необхідно сконфігурувати NodeSource репозиторій:

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

Після цього ви можете просто виконати наступну команду:

sudo yum install yarn
## OR ##
sudo dnf install yarn

Arch Linux

На Arch Linux, Yarn може бути встановлений за допомогою офіційного менеджера пакетів.

pacman -S yarn

openSUSE

На openSUSE, ви можете встановити Yarn за допомогою репозиторію пакетів RPM.

sudo zypper ar -f https://dl.yarnpkg.com/rpm/ Yarn
sudo zypper in yarn

Solus

На Solus, ви можете встановити Yarn за допомого репозиторію Solus.

sudo eopkg install yarn

Alpine

На Alpine Linux (3.6+), ви можете встановити Yarn за допомогою apk.

apk add yarn

Налаштування змінних середовища

Якщо ви вибрали встановлення власноруч, то наступні кроки додадуть Yarn до змінної Path і Yarn буде доступним звідусіль в системі.

Примітка: ваш профіль може бути в файлі .profile, .bash_profile, .bashrc, .zshrc, тощо.

  1. Додайте цей рядок до вашого файлу з профілем: export PATH="$PATH:/opt/yarn-[version]/bin" (шлях може бути різним, в залежності від того, куди ви встановили Yarn)
  2. В терміналі, зайдіть і вийдіть із системи, щоб зміни набрали чинності

Щоб глобально мати доступ до виконуваних файлів Yarn, вам необхідно встановити PATH змінну оточення в вашому терміналі. Щоб це зробити, додайте export PATH="$PATH:`yarn global bin`" до файлу з вашим профілем.

Альтернативи

Є декілька альтернативних способів інсталяції на випадок, якщо ви користуєтесь іншою ОС або жоден із зазначених способів не працює. Вам необхідно встановити Node.js, якщо ви цього ще не зробили.

Якщо ви користуєтесь популярними Linux дистриб′ютивами — Debian, Ubuntu та CentOS, ми радимо інсталювати Yarn за допомогою наших пакетів для цих систем.

#### Інсталяційний скрипт

Один з найпростіших способів встановити Yarn на macOS і універсальні Unix середовища — за допомогою нашого shell-скрипта. Ви можете встановити Yarn, запустивши наступний код у вашому терміналі:

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

Процес інсталяції включає в себе верифікацію GPG підпису. Переглянути програмний код на GitHub

Ви також можете зазначити необхідну версію, запустивши наступний код у вашому терміналі:

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

Ознайомтесь зі списком релізів, щоб дізнатись про доступні версії.

Встановлення вручну за допомогою tarball

Ви можете встановити Yarn, скачавши tarball і розархівувавши його в будь-яку директорію.

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

Перед витяганням Yarn, рекомендується перевірити tarball за допомогою 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

Інсталяція за допомогою npm

Зверніть увагу: Не рекомендується інсталяція за допомогою npm. Пакет не є підписаним, коли ви встановлюєте Yarn через Node-подібні менеджери пакетів, і єдиною перевіркою цілістності пакету є простий SHA1 хеш, він ризико-небезпечний, коли встановлюється на всю систему.

Саме через це, наполегливо рекомендується інсталювати Yarn за допомогою методів, що найкраще підходять для вашої операційної системи.

Ви також можете інсталювати Yarn за допомогою пакетного менеджера npm, якщо він вже встановлений у вашій системі. Якщо на вашій системі встановлений Node.js, то дуже вірогідно що у вас вже є і npm.

За наявності проінстальованого npm, ви можете виконати команду:

npm install --global yarn

Налаштування змінних середовища

Unix/Linux/macOS

Якщо ви вибрали встановлення власноруч, то наступні кроки додадуть Yarn до змінної Path і Yarn буде доступним звідусіль в системі.

Примітка: ваш профіль може бути в файлі .profile, .bash_profile, .bashrc, .zshrc, тощо.

  1. Додайте цей рядок до вашого файлу з профілем: export PATH="$PATH:/opt/yarn-[version]/bin" (шлях може бути різним, в залежності від того, куди ви встановили Yarn)
  2. В терміналі, зайдіть і вийдіть із системи, щоб зміни набрали чинності

Щоб глобально мати доступ до виконуваних файлів Yarn, вам необхідно встановити PATH змінну оточення в вашому терміналі. Щоб це зробити, додайте export PATH="$PATH:`yarn global bin`" до файлу з вашим профілем.

Windows

Щоб отримати глобальний доступ до виконуваних файлів Yarn, необхідно налаштувати змінні середовища PATH в терміналі.

Додайте set PATH=%PATH%;C:\.yarn\bin до вашого оточення терміналу.

Щоб перевірити чи Yarn встановлений виконайте команду:

yarn --version

Нічна збірка

Нічні збірки - це найновіша і найкраща версія Yarn, побудована використовуючи останній код Yarn. Нічні збірки є корисними щоб спробувати новий функціонал який не є опублікований як частина стабільної версії. Незважаючи на те, що ці зібрки не є гарантовано стабільними і можуть містити помилки.

Подивитися як встановити нічну збірку


Проблеми? Якщо Ви не можете встановити Yarn, використовуючи один з цих встановлювачів, то будь ласка, перегляньте існуючі GitHub проблеми або відкрийте нову.

Пошук існуючої проблеми · Відкрити нову проблему