npm Samouczek
Rozpoczęcie pracy z npm
Szukaj…
Uwagi
npm jest domyślnym menedżerem pakietów dla Node.js. Jest napisany w całości w JavaScript i pozwala na instalację i dystrybucję głównie modułów JavaScript w rejestrze. Pakiety są przetwarzane w formacie CommonJS i są rozpoznawalne po obecności pliku package.json .
Wersje
| Wersja | Data wydania |
|---|---|
| wersja 4.0.0 | 21.10.2016 |
| v3.10.0 | 17.06.2016 |
| v3.9.0 | 2016-05-06 |
| v2.15.0 | 2016-03-11 |
| v3.8.0 | 26.02.2016 |
| v3.7.0 | 29.01.2016 |
| wersja 3.0.0 | 21.01.2016 |
| wersja 3.0.0 | 2015-11-20 |
| v3.4.0 | 2015-11-06 |
| v3.3.0 | 14.08.2015 |
| v2.14.0 | 14.08.2015 |
| wersja 3.2.0 | 2015-07-25 |
| wersja 3.1.0 | 2015-07-03 |
| v2.13.0 | 2015-07-03 |
| wersja 3.0.0 | 26.06.2015 |
| v2.12.0 | 2015-06-19 |
| v2.11.0 | 2015-05-22 |
| v2.10.0 | 2015-05-08 |
| v2.9.0 | 24.04.2015 |
| v2.8.0 | 2015-04-10 |
| wersja 2.7.0 | 27.02.2015 |
| wersja 2.6.0 | 13.02.2015 |
| wersja 2.5.0 | 30.01.2015 |
| v2.4.0 | 23.01.2015 |
| v2.3.0 | 16.01.2015 |
| wersja 2.2.0 | 01.01.2015 |
| wersja 2.1.0 | 26.09.2014 |
| wersja 2.0.0 | 2014-09-13 |
| wersja 1.4.0 | 13.02.2014 |
Instalacja lub konfiguracja
zainstalować
npm jest w pakiecie z Node.js , więc jeśli zainstalujesz Node.js, automatycznie również zainstalujesz npm . Możesz wybrać wersję bieżącą i wersję LTS
Windows
W przypadku systemu Microsoft Windows można pobrać instalator MSI ze strony https://nodejs.org/en/download/ .
OS X
W przypadku systemu Apple OS X można pobrać instalator PKG z tej samej lokalizacji https://nodejs.org/en/download/ .
Linux
W systemie Linux możesz użyć menedżera pakietów, aby zainstalować Node.js i npm.
Możesz również skompilować plik Node.js ze źródła, a nadal otrzymasz npm . Istnieje również skrypt, który możesz uruchomić, który zainstaluje npm :
curl -L https://www.npmjs.com/install.sh | sh
Zaktualizuj npm do najnowszej wersji
Zalecaną metodą aktualizacji instalacji npm jest po prostu samodzielna instalacja npm :
npm install -g npm@latest
Alternatywnie możesz uaktualnić do bieżącej wersji LTS zamiast najnowszej wersji:
npm install -g npm@lts
Możesz także zainstalować dowolną wersję Węzła (i npm) za pomocą nvm . Podczas globalnej instalacji z npm z instalacją nvm nie musisz używać sudo (lub Uruchom jako administrator w systemie Windows).
Zainstaluj pakiety
Zauważ, że pakiety mogą być instalowane Ta komenda instaluje najnowszą dostępną wersję nazwanych pakietów:
zarówno lokalnie, jak i globalnie.
Instalacja lokalna oznacza, że npm instaluje twój pakiet w bieżącym katalogu roboczym. Moduły węzłów wchodzą w ./node_modules , pliki wykonywalne wchodzą w ./node_modules/.bin/ . Zwykle będziesz chciał zainstalować moduły lokalne do użytku w programie, jako zależność, i będą działać tylko tam, gdzie są zainstalowane.
npm install <package names>
Stenografia:
npm i <package names>
npm może wchodzić w interakcje z plikiem package.json w bieżącym katalogu na różne użyteczne sposoby, poprzez dependencies obiektami i devDependencies przechowywane w package.json (instalowanie wielu modułów):
Komenda npm install bez parametrów
npm install
instaluje wszystkie pakiety o nazwach jak klucze obiekt w dependencies i devDependencies obiektów w package.json , stosując ograniczeń wersjonowania semantyczne wskazane przez wartości obiektów.
Podczas opracowywania nowego oprogramowania:
Użyj opcji -S aby dodać <package names> i wersje instalowanych modułów npm, które zawsze powinny być dołączone do modułu. Po instalacji dołącza się do listy dependencies śledzonej w pliku package.json .
npm i <package names> -S
Użyj opcji -D aby dodać <package names> i wersje instalowanych modułów npm, które są potrzebne innym programistom do dalszego rozwoju lub testowania twojego modułu. Po instalacji dołącza się do listy devDependencies śledzonej w pliku package.json .
npm i <package names> -D
Gdzie lodash i mocha to nazwy paczek.
Instalowanie pakietów globalnych
Zainstaluj pakiet globalny
Globalnie zainstalowane pakiety upuszczają moduły w {prefix}/lib/node_modules i umieszczają pliki wykonywalne w {prefix}/bin , gdzie {prefix} jest zwykle czymś w rodzaju /usr/local . Zainstalowanie modułu globalnego oznacza, że jego pliki binarne kończą się w zmiennej środowiskowej PATH . Zwykle będziesz chciał zainstalować moduł globalny, jeśli jest to narzędzie wiersza poleceń lub coś, czego chcesz użyć w swojej powłoce.
npm install --global package-name
Usuń pakiet globalny
npm uninstall --global package-name
Uwaga: argument --global można uprościć do -g . Tak więc, na przykład, pierwszą komendą mogło być npm install -g package-name , z dokładnie takim samym rezultatem.
Uwaga: w systemach * nix instalacja globalnych pakietów może wymagać uprawnień superużytkownika. Niezastosowanie się do tego spowoduje błąd z: EACCES . W takim przypadku uruchom:
sudo npm install --global package-name
Aktualizacja pakietów
Cykl życia każdego zastosowania przypada na dzień, w którym jego komponenty wymagają aktualizacji. Wszyscy znają ból związany z aktualizowaniem każdej zależności jeden po drugim. Tutaj wystarczy wydać polecenie:
npm update (-g)
Jeśli jest tam „-g”, to npm zaktualizuje pakiety globalne.
Używanie npm do zarządzania zależnościami
Chcesz wdrożyć aplikację w wielu witrynach? a twój projekt ma zbyt wiele zależności, aby zainstalować je jeden po drugim? Npm ma rozwiązanie wystarczy wydać następujące polecenie:
npm init
W folderze głównym projektu postępuj zgodnie z instrukcjami wyświetlanymi na ekranie (wpisz żądaną wartość, a następnie naciśnij klawisz Enter), a następnie, jeśli chcesz zapisać zależność, dodaj:
--save
po twoim
npm install
polecenia na przykład:
npm install mypackagename --save
I wtedy ta zależność zostanie zapisana, wtedy nie będziesz musiał przenosić folderu „node_modules”. Aby zainstalować cały zapisany problem zależności:
npm install
i wszystkie zapisane zależności zostaną zainstalowane.