Az npm csomagkezelő Node.js projekt létrehozására is használható, ami a valójában egy package.json fájl létrehozása. A package.json egy „manifest” fájl, amely tartalmazza a projekt nevét, verzióját, egy JavaScrit belépési pontot, feladatokat (scriptek), a projekt kulcsszavait, tulajdonos nevét, a projekt licencét és a projekt függőségeit.
Gyakorlásként, hozzunk létre egy app01 nevű projektet:
mkdir app01 cd app01 npm init -y
Az npm init egy interaktív program, amely bekéri a projektünk adatait. Ha futtatáskor megadunk egy -y kapcsolót is, akkor kérdés nélkül létrejön egy alapértelmezett package.json fájl:
npm init -y
A létrejött a package.json fájl a következő tartalommal:
{ "name": "app01", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "keywords": [], "author": "", "license": "ISC" }
A fájlban javíthatjuk az adatokat. Létrejött egy NodejJS projekt, amelyet folytathatunk, például csomagok telepítésével.
Ha az „npm init -y” parancsot „-y” nélkül hajtjuk végre, a parancs interaktívan bekéri a projekt adatait.
Egy projekthez kétféle függőséget, illetve csomagot telepíthetünk:
A fejlesztési időben telepített csomagok részt vesznek a fejlesztésben, de a projekt terjesztett változatában nem fognak szerepelni.
A terjesztéshez telepített függőségek fejlesztési és produktum közreadása során is a projekt részei maradnak.
A projekttől külön, globálisan telepíthetünk csomagokat, ezek nem jelennek meg a package.json fájlban. Viszont ezek a csomagok általában valamilyen parancsot tartalmaznak, amit később más projekteknél is használhatunk. Ilyen lehet például a gulp-cli csomag, aminek hatására kapunk egy gulp parancsot, és azt későbbi projekteknél is használhatjuk.
Utasítások:
Hozzunk létre egy projektet:
mkdir app01 cd app01 npm init -y
Telepítsük a gulp-cli csomagot:
npm install --global gulp-cli
A telepítés után kapunk egy gulp parancsot, ellenőrizzük:
gulp --version
Telepítsük a bootstrap csomagot terjesztéshez:
npm install --save bootstrap
A projekt könyvtárában létrejön egy node_modules nevű könyvtár, ahol megjelenik a bootstrap függőségeivel együtt.
Telepítsük a lite-server csomagot, fejlesztéshez:
npm install --save-dev lite-server
A package-lock.json fájl automatikusan generálódik, amikor az npm módosítja node_modules fát, vagy a package.json fájlt. Leírja a telepített fát, amely alapján később bármikor azonos fa létrehozható, függetlenül a függőségi frissítésektől.
Csak fejlesztői függőségek telepítése:
npm install --only=dev
Ha nem akarunk fejleszteni, csak használni:
npm install --only=production npm install --production
Ha szeretnénk fejleszteni és a termékként is látni:
npm install