yarn add

Устанавливает пакет и все его зависимости.

Добавление зависимостей

В общем, пакет это просто папка с кодом и файлом package.json, который описывает содержание. Чтобы использовать другой пакет, сначала вам необходимо добавить его в список ваших зависимостей. Это означает, что вам необходимо выполнить команду yarn add [package-name], чтобы установить пакет в ваш проект.

Эта команда так же обновит файлы package.json и yarn.lock, чтобы при запуске yarn или yarn install другие разработчики получили те же зависимости, что и Вы.

Большая часть пакетов будет установлена из npm репозитория при использовании их имен. Например, yarn add react установит пакет react из npm репозитория.

Вы можете указать желаемую версию:

  1. yarn add package-name — последняя версию пакета;
  2. yarn add package-name@1.2.3 — конкретная версия пакета (1.2.3);
  3. yarn add package-name@tag устанавливает конкретный “tag” (например, beta, next или latest).

Можно также указать пакет из разных источников:

  1. yarn add package-name установит пакет из npm registry, если вы не указали другой источник в package.json проекта.
  2. yarn add file:/path/to/local/folder установит пакет из заданной папки. Это удобно использовать при тестировании Ваших собственных неопубликованных пакетов.
  3. yarn add file:/path/to/local/tarball.tgz установит пакет из архива. Этот способ облегчает распространение ещё не опубликованного пакета.
  4. yarn add <git remote url> установит пакет из удалённого репозитория git.
  5. yarn add <git remote url>#<branch/commit/tag> устанавливает пакет из удаленного git репозитория с указанной веткой, комиттом или меткой.
  6. yarn add https://my-project.org/package.tgz установит пакет из архива, расположенного по ссылке.

Предостережения

Если Вы использовали пакетные менеджеры наподобие npm, Вы возможно ищете возможность добавить глобальные зависимости.

Для подавляющего большинства пакетов, подобный подход (глобальная установка пакетов) признан плохой практикой, т. к. они не являются очевидными. Намного лучшем решением будет добавить Ваши зависимости локально, чтобы люди, использующие Ваш проект, смогли установить идентичный набор зависимостей.

Если Вы хотите использовать CLI инструмент, содержащий bin директорию, то файлы из этой директории будут доступны в ./node_modules/.bin. Так же, Вы можете использовать global команду:

yarn global add <имя пакета...>

Команды

yarn add <имя пакета...>

Это установит один или более пакетов в ваш список зависимостей.

yarn add <имя пакета...> [--dev/-D]

Добавление аргумента --dev или -D установит один или более пакетов в ваш devDependencies.

yarn add <package...> [--peer/-P]

Добавление аргумента --peer или -P установит один или несколько пакетов в ваш peerDependencies.

yarn add <package...> [--optional/-O]

Добавление аргумента --optional или -O установит один или несколько пакетов в ваш optionalDependencies.

yarn add <package...> [--exact/-E]

Добавление аргумента--exact или -E установит пакет с конкретной версией. По умолчанию будет использована самая последняя версия с такой же мажорной версией. Например, yarn add foo@1.2.3 позволит установить 1.9.1, но yarn add foo@1.2.3 --exact установит только конкретную версию 1.2.3.

yarn add <package...> [--tilde/-T]

Добавление аргумента --tilde или -T установит самый последний релиз пакета с такой же минорной версией. По умолчанию будет использован самый последний релиз с такой же мажорной версией. Например, yarn add foo@1.2.3 --tilde позволит установить 1.2.9, но не 1.3.0.