[[oktatas:web:nodejs|< Node.js]]

====== Yarn ======

  * **Szerző:** Sallai András
  * Copyright (c) 2001, Sallai András
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC BY-SA 4.0]]
  * Web: https://szit.hu

===== A Yarn-ról =====

A yarn egy alternatív csomag- és projektkezelő parancs az npm mellett.
Az npm parancs megbízhatatlan működése okán jött létre.



Az NPM hátrányai:
  * Az npm install futtatása során néha hibát kapunk, majd újabb futtatáskor minden működik. Okozhatják proxy-k vagy egyéb hálózati problémák.
  * Az egyik mappában működő projekt, másik mappában nem működik.
  * A termék létrehozása meghiúsul. 
  * A saját gépünkön jól működik a projekt, másik gépén nem.

Yarn előnyök:
  * A Yarn gyorsabb mint az npm, sok függőség esetén.
  * Nem kell többször futtatni, mint az npm parancs esetén, vagy törölni a node_modules könyvtárat, majd újra létrehozni.

Webhely:
  * https://yarnpkg.com/ (2021)
  * https://classic.yarnpkg.com/en/docs/package-json/ (2021; package.json)

===== Telepítés =====

Az yarn parancs a yarn Node.js csomagból érhető el:

  npm install -g yarn

Ellenőrzés:
  yarn --version


Frissítés a legújabb verzióra:
  yarn set versein latest
  yarn set version from sources


A 2.x és 3.x kódneve: berry. Frissítés erre a verzióra:
  yarn set version berry

Csal az aktuális projekt számára frissíti a yarn-t.




===== Projekt készítése =====

<code>
mkdir app01
cd app01
yarn init -y
</code>


A -y kihagyása esetén bekér néhány projekttel kapcsolatos információt.

Elkészül egy package.json fájl:

<code javascript>
{
  "name": "projekt01",
  "version": "1.0.0",
  "description": "Teszt",
  "main": "index.js",
  "author": "Nagy János",
  "license": "MIT"
}
</code>


===== Csomagkezelés =====

  yarn help


Függőségek telepítése:
  yarn
  yarn install


Függőség hozzáadása:
  yarn add [csomagnév]
  yarn add [csomagnév]@[verzió]
  yarn add [csomagnév]@[tag]

Függőség hozzáadása a projekthez:
  yarn add [csomagnév] --dev
  yarn add [csomagnév] --peer

Függőség frissítése:
  yarn up [csomagnév]
  yarn up [csomagnév]@[verzió]
  yarn up [csomagnév]@[tag]

Függőség megszüntetése:
  yarn remove [csomagnév]

===== Angular telepítés =====

  yarn global add @angular/cli

Ellenőrzés:
  ng --version

Ha globális függőségi problémákba ütközünk telepítsünk npm-el. 

Az Angual CLI konfigurálása, hogy a Yarn-t használja:
  ng set --global packageManager=yarn


Alkalmazás összeállítása:
  ng new hello-app

  cd hello-app

Szerver indítása:
  ng serve

Itt elérhetjük az alkalmazást: 
  http://localhost:4200



===== Feladatok =====

Tegyük fel, hogy a [[https://yarnpkg.com/package/create-html|create-html]] csomagot szeretnék használni. 
Telepítés:
  yarn add create-html --dev

Szeretnénk használni, ezért írunk egy taskot:

<code javascript>
  "scripts": {
    "create": "./node_modules/.bin/create-html"
  },
</code>

A create feladat végrehajtása:
  yarn run create

  yarn run create -o index.html

  yarn run create --lang hu -o index.html