yarn add

Встановлює пакет та будь-які пакети, від яких він залежить.

Додавання залежностей

Загалом, пакет це просто тека з кодом і файлом package.json, який описує вміст. Щоб використати інших пакет, вам необхідно спочатку додати його до списку ваших залежностей. Це означає, що вам необхідно запустити команду yarn add [package-name], щоб встановити пакет до вашого проекту.

Це також оновить ваш package.json і ваш yarn.lock. Таким чином інші розробники, які працюють над вашим проектом, отримають ті самі залежності що і ви, якщо запустять yarn або yarn install.

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

Ви можете вказати версії наступним чином:

  1. yarn add package-name встановлює найостаннішу версію пакету.
  2. yarn add package-name@1.2.3 встановлює вказану версію пакету з реєстру.
  3. yarn add package-name@tag встановлює вказану мітку “tag” (e.g. 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, то ви, можливо, шукаєте як додати глобальні залежності.

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

Якщо ви намагаєтесь користуваться консольними утилітами з текою bin - ви можете це зробити з вашої ./node_modules/.bin теки. Ви також можете користуватися global командою:

yarn global add <package...>

Команди

yarn add <package...>

Це встановить один або більше пакетів в ваші dependencies.

yarn add <package...> [--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.