Node Package Manager, lidově známý jako npm, je online úložiště pro publikování balíčků a knihoven NodeJS.

Je to také nástroj příkazového řádku, který vám umožňuje pracovat s registrovanými balíčky. Může pomoci s instalací balíčků, správou verzí a správou závislostí.

Vývojáři publikují své JavaScriptové knihovny na npm každý den. Proces je poměrně jednoduchý, takže i vy můžete publikovat balíček na npm.

Krok 1: Instalace NodeJS

Chcete-li pracovat s npm, musíte jej mít globálně nainstalován ve vašem systému.

Začněte tím instalace NodeJS a npm na Ubuntu, na Windowsnebo podle pokynů na NodeJS webová stránka.

Krok 2: Vytvoření účtu npm

Chcete-li publikovat své balíčky na npm, musíte si vytvořit účet npm na oficiálních webových stránkách npm.

Chcete-li vytvořit účet npm, postupujte podle následujících kroků:

  1. Přejít na registrace npm strana.
  2. Vyplňte své údaje, odsouhlaste licenční podmínky a zásady ochrany osobních údajů a klikněte na „vytvořit účet“.
  3. Ověřte svůj e-mail pomocí odkazu, který obdržíte od npm do vaší poštovní schránky.
instagram viewer

Pokud neověříte svou e-mailovou adresu, npm při pokusu o publikování vašich balíčků vyvolá chybu.

Krok 3: Inicializace úložiště Git

Dále musíte inicializovat úložiště Git, abyste mohli sledovat všechny změny, které ve svém projektu provedete.

Na svém terminálu přejděte do kořenového adresáře projektu a spusťte následující příkaz k inicializaci prázdného úložiště Git.

git init

Vytvořit .gitignore soubor a přidejte všechny soubory, které nechcete, aby Git sledoval. Poté spusťte následující příkaz pro sledování zbývajících souborů:

git přidat -A

Poté spusťte následující příkaz a pořiďte svůj první snímek odesláním kódu do systému Git.

git spáchat -m počáteční-spáchat

Můžete si vybrat hostujte své úložiště Git na GitHubu nebo podobná služba jako Gitlab pro bezproblémovou spolupráci.

Krok 4: Inicializace npm ve vašem projektu

Dále inicializujte npm ve svém projektu a přidejte podrobnosti o projektu do souboru package.json. Tyto podrobnosti budou zveřejněny na npm.

Na svém terminálu přejděte do kořenového adresáře projektu a spusťte následující příkaz pro inicializaci npm ve vašem projektu.

npm init

Výše uvedený příkaz spustí na vašem příkazovém řádku sadu výzev:

  • název balíčku: Toto je název vašeho balíčku npm; pokud chcete balíček publikovat na npm, musí být jedinečný; jinak npm vyhodí chybu.
  • verze: Tato vlastnost označuje aktuální verzi vašeho balíčku. Musíte jej zvýšit pokaždé, když aktualizujete balíček, jinak npm vyvolá chybu. Výchozí hodnota je 1.0.0.
  • popis: Tato vlastnost je popis vašeho balíčku. Jakmile balíček zveřejníte, bude veřejný.
  • Vstupní bod: Tato vlastnost označuje název souboru, kde začíná provádění kódu.
  • testovací příkaz: Tato vlastnost označuje příkaz, který se spustí při spuštění test běhu npm.
  • git úložiště: Tato vlastnost je adresa URL vašeho vzdáleného úložiště Git.
  • klíčová slova: Tato vlastnost označuje relevantní klíčová slova vašeho projektu, která pomohou vyhledávači jej najít.
  • autor: Tato vlastnost by měla být vaše jméno nebo alias.
  • licence: Toto je licence, pod kterou chcete balíček publikovat. Výchozí licencí je licence Internet Systems Consortium (ISC).

Po nastavení můžete vytvořit svůj balíček.

Krok 5: Otestujte svůj balíček

Po dokončení vytváření balíčku byste jej měli otestovat lokálně, abyste viděli, jak by se choval po nasazení na npm.

Chcete-li balíček otestovat lokálně, nejprve spusťte v adresáři projektu následující příkaz:

odkaz npm

Výše uvedený příkaz vám umožňuje odkazovat na váš balíček lokálně jako na balíček hostovaný npm.

Poté vytvořte další složku v kořenovém adresáři projektu a vložte do ní cd.

mkdir test
CDtest

Ve složce test spusťte následující příkaz pro propojení balíčku se složkou:

npm odkaz jméno-vaše-balík

Nakonec vytvořte fiktivní soubor, abyste otestovali funkčnost balíčku.

Po dokončení testů můžete složku testů bezpečně odstranit.

Krok 6: Přihlášení k npm ve vašem systému

Dále se musíte přihlásit ke svému účtu npm ve vašem systému.

Spusťte následující příkaz a přihlaste se ke svému účtu npm:

přihlášení npm

To vás vyzve k vyplnění uživatelského jména, hesla a dvoufaktorového ověřovacího kódu (pokud jste jej na svém účtu povolili).

Krok 7: Publikování balíčku

Po dokončení všech výše uvedených kroků spusťte následující příkaz a publikujte svůj balíček na npm.

npm zveřejnit

Tento příkaz vyžaduje jednorázové heslo, které bude na váš e-mail. Poté váš balíček publikuje na npm.

Balíčky, které jste zveřejnili, si můžete prohlédnout na npm. Přihlaste se ke svému účtu npm npmjs.com a přejděte do sekce balíčky na hlavním panelu vašeho profilu.

Chcete-li nainstalovat balíček a použít jej jako závislost na kterémkoli z vašich projektů, spusťte:

npm Nainstalujtenázev-z-tvůj-balík

Smazání vašeho balíčku z npm

Stále máte úplnou kontrolu nad svými balíčky na npm, což znamená, že můžete svůj balíček z npm trvale upravit a dokonce smazat. Své balíčky můžete odstranit tak, že přejdete do sekce nastavení vašeho balíčku a vyberete možnost odstranit balíček.