Kihagyás

Node Version Manager telepítése

Mind a backend, mind a frontend projektek buildeléséhez szükséges, hogy a Node.js telepítve legyen a gépünkre.

A különböző projekteken azonban különböző Node.js/npm verziók lehetnek szükségesek. Azért, hogy megkönnyítsük az egyes Node.js/npm verziók közötti váltást, az nvm-et (Node Version Manager) használjuk.

Az nvm és általa a Node.js/npm az alábbi lépésekkel telepíthető.

1. Az nvm telepítése

Amennyiben korábban volt telepítve Node.js a gépünkre, azt távolítsuk el az nvm telepítés előtt.

Az nvm a következő linkről tölthető le: nvm

Az oldal alján keressük meg az Assets szekciót, töltsük le a futtatható állományt és telepítsük a gépünkre:

NvmAssets

Node.js telepítése

Parancssorból adjuk ki az alábbi parancsokat:

nvm install ${node-version}
nvm use ${node-version}
  • A ${node-version} placeholder helyére a frontend repositoryban található .nvmrc fájl tartalmát kell behelyettesíteni.

C:/Users/Username' is not recognized as an internal or external command,... hiba esetén

Ha a fentihez hasonló hibába ütközünk, az azért van mert a Windows-os felhasználónevünkkel létrehozott mappa space karaktert tartalmaz.

Ezt az alábbi módon tudjuk orvosolni:

  1. Elősször is írassuk ki a parancssorba a felhasználónevünkkel létrehozott mappa rövidített nevét az alábbi módon:

    1. Lépjünk be a Users mappába: 
      cd \Users
    2. Írassuk ki az itt található mappák rövidített nevét: 
      dir/x

    3. Az alábbihoz hasonló eredményt kell kapnunk: FolderShortnames

    4. Ha a mi felhasználónevünkkel létrehozott mappa a Pelda Bela akkor a PELDAB~1 rövidített mappanévre lesz szükségünk. (A példa kedvéért a további lépésekben ezt a nevet használjuk, de értelemszerűen a saját mappánkhoz tartozó rövidítést kell behelyettesíteni a lenti parancsokba.)

  2. Nyissuk meg az nvm settings.txt fájlt ami az alábbi útvonalon található: C:\Users\Pelda Bela\AppData\Roaming\nvm\.

  3. Keressük meg benne az alábbi sort: 
    root: C:\Users\Pelda Bela\AppData\Roaming\nvm
  4. Majd módosítsuk az alábbira: 
    root: C:\Users\PELDAB~1\AppData\Roaming\nvm

Értelemszerűen a saját gépünkön a Lastname helyén a vezetéknevünk, a Firstname helyén a keresztnevünk fog szerepelni.

Az nvm a telepítése a következő link leírását követve végezhető el: nvm

Ha az nvm parancs nem működik parancssorból a telepítés után

Győződjünk meg róla, hogy a linken elérhető export paranccsal kezdődő script hozzá lett adva az általunk használt paranccsor profile fájljához.

Például, ha Z Shell-t használunk, akkor a /Users/${username}/.zshrc fájlba kell másolni az export scriptet. (Ha nem létezik még a .zshrc fájl a ${username} mappánk alatt, hozzuk létre kézzel.)

Node.js telepítése

Klónozzuk a gépünkre a frontend repositoryt és a repository mappájából adjuk ki az alábbi parancsokat:

nvm install
nvm use

2. Az nvm használata

NVM verzió

A Virtuális Asszisztens projekten a v20.10.0-ás verziót használjuk. 

nvm install v20.10.0
nvm use v20.10.0

Az aktuálisan használt Node.js verzió kiíratása: 

nvm current

Adott Node.js verzió telepítése: 

nvm install ${node-version}

Adott Node.js verzió használata: 

nvm use ${node-version}

.nvmrc fájl használata

Az .nvmrc fájlba definiálhatjuk a projekten használandó Node.js verziót.

Unix alapú rendszereken, amennyiben a projekten van definiálva .nvmrc fájl, úgy elég az nvm install, illetve nvm use parancsokat kiadni, és automatikusan az .nvmrc fájlban definiált verzió lesz telepítve és használva.

Windows rendszeren, jelenleg az .nvmrc nem támogatott, így ott a ${node-version} placeholder helyére kézzel kell megadnunk a telepíteni kívánt verziót. Fontos azonban, hogy ha a projekten van .nvmrc fájl definiálva, akkor az abban található verziószámot kell behelyettesíteni.

Ubuntu használata esetén

Ubuntu használata esetén lehetséges, hogy nem fog lefutni a compile npm hibaüzetettel. Ebben az esetben ahhoz, hogy az IntelliJ IDEA megtalálja az npm-et, hozzá kell adnod az npm útvonalát az IDE környezeti változóihoz:

  1. Menj a File | Settings (vagy macOS-en a Preferences).
  2. Navigálj a Build, Execution, Deployment | Build Tools | Maven | Runner menüponthoz.
  3. A Környezeti változók szakaszban add hozzá a PATH változót, és tartalmazza az npm elérési útvonalát. Például:
PATH=/usr/local/bin:/usr/bin:/bin:<a jelenlegi elérési útvonalaid>