Yarnin asen­ta­mi­nen

Yarnin asen­ta­mi­sek­si sinun on ensin asen­net­ta­va täys­ver­sio ja sitten yk­sit­täi­nen pro­jek­ti­ver­sio. Sen jälkeen voit määrittää pa­ket­tien­hal­lin­nan omien toi­vei­de­si ja tar­pei­de­si mukaan.

Yarnin asennus vaihe vaiheelta

Ja­vaSc­ript-pa­ke­tin­hal­lin­taoh­jel­ma Yarn on kehitetty Node.js: lle, ja siitä on tullut nopeasti yksi suo­si­tuim­mis­ta rat­kai­suis­ta alallaan sen julkaisun jälkeen vuonna 2016. Koska sen asennus ei aina ole helppoa, annamme sinulle vai­heit­tai­sen ohjeen. Sinulla tulisi olla Node.js jo asen­net­tu­na ja mää­ri­tet­ty­nä.

Mitkä ovat Yarnin asen­nuk­sen vaa­ti­muk­set?

Yarnin asen­ta­mi­seen on vain muutama vaatimus. Node.js:n lisäksi tarvitset käyt­tö­jär­jes­tel­mäk­si Linux-jakelun, kuten Ubuntun. Tarvitset myös npm-pa­ke­tin­hal­lin­nan ja tilin, jolla on sudo-oikeudet. Jos et ole varma, onko jär­jes­tel­mäs­sä­si Node.js, voit tarkistaa sen seu­raa­val­la ko­men­nol­la:

$ node -v

Näin näet, mikä versio jär­jes­tel­mäs­sä­si on. Jos saat vah­vis­tuk­sen, voit jatkaa ja asentaa Yarnin.

Yarnin la­taa­mi­nen ja asen­ta­mi­nen

Yarnin asen­ta­mi­sek­si sinun on asen­net­ta­va kaksi versiota pa­ket­tien­hal­lin­taoh­jel­mas­ta. Lataa ensin ohjelman täys­ver­sio. Näin voit varmistaa, että kaikki tiimisi jäsenet käyttävät samaa versiota projektin kaikissa vaiheissa. Tämä puo­les­taan vähentää virheitä. Asenna täys­ver­sio npm-pa­ket­tien­hal­lin­taoh­jel­mal­la. Komento on seuraava:

$ sudo npm install -g yarn

Tarkista sitten ver­sio­nu­me­ro var­mis­taak­se­si, että olet saanut uusimmat paketit. Komento tähän on:

$ yarn --version

Yarnin asen­ta­mi­nen pai­kal­li­ses­ti

Nyt voit määrittää Yarnin tietylle Ja­vaSc­ript-pro­jek­til­le. Avaa ensin projektin hakemisto. Korvaa paik­ka­merk­ki “your-project” pro­jek­ti­si nimellä. Komento on seuraava:

cd ~/your-project

Jos sinulla ei ole kansiota pro­jek­til­le­si, luo sellainen käyt­tä­mäl­lä mkdir:

mkdir your-project
cd your-project

Käytä komentoa yarn set saa­dak­se­si Yarn Berry:n:

$ yarn set version berry

Jos se on saa­ta­vil­la, ladataan uusin versio Yarn Berrystä. Tallenna se pro­jek­ti­kan­sioon nimeltä .yarn/releases ja luo kon­fi­gu­raa­tio­tie­dos­to nimeltä .yarnrc.yml. Tu­los­tuk­sen pitäisi näyttää suun­nil­leen seu­raa­val­ta:

Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/user/your-project/.yarn/releases/yarn-berry.cjs...
Updating /home/user/your-project /.yarnrc.yml...
Done!

Tarkista versio uudelleen seu­raa­val­la ko­men­nol­la:

$ yarn --version

Jos Yarn on asennettu oikein, saat seuraavan tuloksen (versio numero vaihtelee nykyisen version mukaan):

3.0.0

Mitkä ovat tär­keim­mät Yarn-komennot?

Kun olet asentanut Yarnin, voit aloittaa sen käytön. Kannattaa tutustua joihinkin pe­rus­ko­men­noi­hin, jotta saat parhaan hyödyn irti pa­ket­tien­hal­lin­taoh­jel­mas­ta. Alla esit­te­lem­me joitakin tär­keim­piä komentoja.

Uuden projektin aloit­ta­mi­nen

Uuden projektin aloit­ta­mi­sek­si käytä komentoa init. Se luo uuden projektin ja kaikki projektin tar­vit­se­mat tiedostot:

yarn init

Riip­pu­vuuk­sien tal­len­ta­mi­nen ja luominen

Jos sinulla on jo projekti ja haluat tallentaa siihen riip­pu­vuu­det, käytä komentoa yarn install:

yarn install

Luo uusia riip­pu­vuuk­sia ko­men­nol­la add. Korvaa paik­ka­merk­ki “pac­ka­ge­na­me” paketin to­del­li­sel­la nimellä:

yarn add packagename

Paras ko­koon­pa­no *.gitignore-*tie­dos­tol­le

Kaikki tiedostot tal­len­ne­taan pro­jek­ti­si .yarn -kansioon, mutta voit jättää joitakin tie­dos­to­ja pois. Voit tehdä sen käyt­tä­mäl­lä seuraavaa mää­ri­tys­tä .gitignore- tie­dos­tos­sa­si:

.yarn/*
!.yarn/patches
!.yarn/releases
!.carn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

Ohje ja li­sä­tie­to­ja

Jos tarvitset apua tai li­sä­tie­to­ja Yarnin asen­nuk­sen jälkeen, käytä --help:

$ yarn --help

Jos tarvitset apua tietyn komennon kanssa, yhdistä komento numeroon --help. Esi­mer­kik­si yarn install kanssa se näyttäisi seu­raa­val­ta:

$ yarn install --help

Mitkä ovat Yarnin vaih­toeh­to­ja?

Yarn on loistava ratkaisu, jos haluat jakaa ja käyttää koodia tur­val­li­ses­ti. Mutta on myös useita hyviä vaih­toeh­to­ja, joita voit käyttää Yarnin sijaan.

npm

Ei ole yl­lät­tä­vää, että npm (Node Project Manager) on hyvä vaih­toeh­to ajo­ym­pä­ris­tön kanssa työs­ken­te­lyyn. Se on help­po­käyt­töi­nen, nopea, tur­val­li­nen ja sopii täy­del­li­ses­ti Node.js:ään. Se tarjoaa yli 1,3 miljoonan paketin re­kis­te­rin ja CLI-käyt­tö­liit­ty­män. Olemme käyt­tä­neet npm:ää myös tässä Yarn-asen­nusop­paas­sa.

pnpm

pnpm on avoimen läh­de­koo­din pa­ket­tien­hal­lin­taoh­jel­ma, joka sopii erin­omai­ses­ti Ja­vaSc­rip­tin kanssa työs­ken­te­lyyn. Sen rakenne on sa­man­lai­nen kuin npm:n, mutta se käyttää sym­link­ke­jä eikä tee useita pai­kal­li­sia asen­nuk­sia ident­ti­sis­tä pa­ke­teis­ta. Se on kehitetty te­hok­kaam­mak­si vaih­toeh­dok­si npm:lle, mikä tekee siitä mie­len­kiin­toi­sen vaih­toeh­don Yarnille.

Bower

Kolmas vaih­toeh­tom­me on Bower, ilmainen pa­ket­tien­hal­lin­taoh­jel­ma asia­kas­puo­len verk­ko­ke­hi­tyk­seen, joka on optimoitu toimimaan fron­ten­dis­sä. Se tarjoaa laajan va­li­koi­man paketteja. Ja­vaSc­rip­tin lisäksi ohjelma toimii myös muiden kom­po­nent­tien, kuten HTML:n ja CSS:n, kanssa. Se on erittäin help­po­käyt­töi­nen ja toimii Node.js-ko­men­to­ri­vin avulla. 3b31b70a4440a8ebb2389da8eba64c7d