Node Package Manager, ľudovo známy ako npm, je online úložisko na publikovanie balíčkov a knižníc NodeJS.

Je to tiež nástroj príkazového riadka, ktorý vám umožňuje pracovať s registrovanými balíkmi. Môže pomôcť pri inštalácii balíkov, správe verzií a správe závislostí.

Vývojári zverejňujú svoje knižnice JavaScript na npm každý deň. Proces je pomerne jednoduchý, takže aj vy môžete publikovať balík na npm.

Krok 1: Inštalácia NodeJS

Ak chcete interagovať s npm, musíte ho mať globálne nainštalovaný vo vašom systéme.

Začnite tým inštalácia NodeJS a npm na Ubuntu, v systéme Windowsalebo podľa pokynov na stránke NodeJS webovej stránky.

Krok 2: Vytvorenie účtu npm

Ak chcete publikovať svoje balíčky na npm, musíte si vytvoriť účet npm na oficiálnej webovej stránke npm.

Ak chcete vytvoriť účet npm, postupujte podľa nasledujúcich krokov:

  1. Choďte na registrácia npm stránku.
  2. Vyplňte svoje údaje, vyjadrite súhlas s licenčnými podmienkami a zásadami ochrany osobných údajov a kliknite na „vytvoriť účet“.
  3. Overte svoj e-mail pomocou odkazu, ktorý dostanete od npm do vašej poštovej schránky.
instagram viewer

Ak neoveríte svoju e-mailovú adresu, npm pri pokuse o zverejnenie balíkov vyhodí chybu.

Krok 3: Inicializácia úložiska Git

Ďalej musíte inicializovať úložisko Git, aby ste mohli sledovať všetky zmeny, ktoré vo svojom projekte vykonáte.

Na svojom termináli prejdite do koreňového adresára projektu a spustite nasledujúci príkaz na inicializáciu prázdneho úložiska Git.

git init

Vytvor .gitignore súbor a pridajte všetky súbory, ktoré nechcete, aby Git sledoval. Potom spustite nasledujúci príkaz na sledovanie zostávajúcich súborov:

git pridať -A

Potom spustite nasledujúci príkaz, aby ste urobili svoju prvú snímku odovzdaním kódu do Gitu.

git zaviazať sa -m počiatočné-zaviazať sa

Môžete si vybrať hostujte svoje úložisko Git na GitHub alebo podobná služba ako Gitlab pre bezproblémovú spoluprácu.

Krok 4: Inicializácia npm vo vašom projekte

Ďalej inicializujte npm vo svojom projekte a pridajte podrobnosti o svojom projekte do súboru package.json. Tieto podrobnosti budú zverejnené na npm.

Na svojom termináli prejdite do koreňového adresára projektu a spustite nasledujúci príkaz na inicializáciu npm vo vašom projekte.

npm init

Vyššie uvedený príkaz spustí na príkazovom riadku sadu výziev:

  • názov balíka: Toto je názov vášho balíka npm; ak chcete balík zverejniť na npm, musí byť jedinečný; inak npm vyhodí chybu.
  • verzia: Táto vlastnosť označuje aktuálnu verziu vášho balíka. Musíte ho zvýšiť pri každej aktualizácii balíka, inak npm vyvolá chybu. Predvolená hodnota je 1.0.0.
  • popis: Táto vlastnosť je popisom vášho balíka. Keď zverejníte svoj balík, bude to verejné.
  • vstupný bod: Táto vlastnosť označuje názov súboru, kde sa spúšťa váš kód.
  • testovací príkaz: Táto vlastnosť označuje príkaz, ktorý sa spustí pri spustení test chodu npm.
  • git úložisko: Táto vlastnosť je adresa URL vášho vzdialeného úložiska Git.
  • Kľúčové slová: Táto vlastnosť označuje relevantné kľúčové slová pre váš projekt, ktoré pomôžu vyhľadávaču nájsť ho.
  • autora: Táto vlastnosť by mala byť vaše meno alebo alias.
  • licenciu: Toto je licencia, pod ktorou chcete publikovať balík. Predvolená licencia je licencia Internet Systems Consortium (ISC).

Po nastavení si môžete vytvoriť svoj balík.

Krok 5: Otestujte svoj balík

Po dokončení vytvárania balíka by ste ho mali otestovať lokálne, aby ste zistili, ako sa bude správať po jeho nasadení na npm.

Ak chcete svoj balík otestovať lokálne, najskôr spustite nasledujúci príkaz v adresári vášho projektu:

odkaz npm

Vyššie uvedený príkaz vám umožňuje odkazovať na váš balík lokálne ako na balík hostený v npm.

Potom vytvorte ďalší priečinok v koreňovom adresári projektu a vložte do neho cd.

mkdir test
cdtest

V testovacom priečinku spustite nasledujúci príkaz na prepojenie balíka s priečinkom:

npm odkaz meno-váš-balík

Nakoniec vytvorte fiktívny súbor na testovanie funkčnosti balíka.

Po dokončení testov môžete svoj testovací priečinok bezpečne odstrániť.

Krok 6: Prihláste sa do npm vo vašom systéme

Ďalej sa musíte prihlásiť do svojho účtu npm vo vašom systéme.

Spustite nasledujúci príkaz a prihláste sa do svojho účtu npm:

prihlásenie npm

Zobrazí sa výzva na vyplnenie používateľského mena, hesla a dvojfaktorového overovacieho kódu (ak ste to na svojom účte povolili).

Krok 7: Zverejnenie balíka

Po dokončení všetkých vyššie uvedených krokov spustite nasledujúci príkaz na zverejnenie balíka na npm.

npm publikovať

Tento príkaz vyžaduje jednorazové heslo, ktoré bude na váš e-mail. Potom zverejní váš balík na npm.

Vami zverejnené balíčky si môžete pozrieť na npm. Prihláste sa do svojho účtu npm npmjs.com a prejdite do sekcie balíkov na hlavnom paneli vášho profilu.

Ak chcete nainštalovať balík a použiť ho ako závislosť na ktoromkoľvek z vašich projektov, spustite:

npm Inštalácianázov-z-tvoj-balík

Odstránenie vášho balíka z npm

Stále máte úplnú kontrolu nad svojimi balíčkami v npm, čo znamená, že môžete svoj balíček natrvalo upraviť a dokonca z npm odstrániť. Svoje balíky môžete odstrániť tak, že prejdete do sekcie nastavení balíka a vyberiete možnosť odstrániť balík.