Wprowadzenie NPM
Co to jest NPM?NPM (Node Package Manager) to menedżer pakietów dla JavaScript, jest domyślny dla node.js. Podczas instalacji węzeł NPM jest również instalowany. A co to znaczy? Cóż, poprzez NPM możemy instalować i zarządzać pakietami dla naszych aplikacji.
Kiedy używamy Node.js, musimy szybko instalować nowe moduły (biblioteki), ponieważ Node, będąc silnie modułowym systemem, jest praktycznie pusty. Tak więc dla większości operacji będziemy musieli zainstalować dodatkowe moduły. Ta operacja jest wykonywana bardzo łatwo za pomocą narzędzia NPM.
Jak zainstalować Node.js?Aby zainstalować Node.js, pierwszą rzeczą, którą musimy zrobić, to wejść na oficjalną stronę internetową:
https://nodejs.org/
I pobierz instalator zgodnie z naszym systemem operacyjnym.
POWIĘKSZAĆ
Pobierając plik instalacyjny, wystarczy go dwukrotnie kliknąć i postępować zgodnie z instrukcjami kreatora instalacji Node.js.
Po zainstalowaniu dla użytkowników systemu Windows konsola node.js będzie dostępna z paska uruchamiania, jak pokazano na poniższym obrazku:
POWIĘKSZAĆ
Użytkownicy komputerów Mac będą musieli otworzyć terminal swojego systemu operacyjnego, jak pokazano na poniższym obrazku:
POWIĘKSZAĆ
Aby sprawdzić, czy jest poprawnie zainstalowany, wykonujemy w naszym terminalu następujące polecenie:
nie dawaj(Windows / Linux / Konsola Terminal OS X)
Pchamy Wchodzić i wpisujemy następującą linię:
Console.log („Node.js został pomyślnie zainstalowany”);(Windows/Linux/Konsola Terminal OS X)
Naciskając Wchodzić, pokaże nam wiadomość „Node.js został pomyślnie zainstalowany”. Aby zobaczyć listę poleceń dozwolonych przez node.js, wpisujemy polecenie .Wsparcie jak pokazano na poniższym obrazku:
Aby wyświetlić Zainstalowana wersja NPM, wykonujemy następujące polecenie:
npm -vCo spowoduje, że:
Menedżer pakietów
ten Menedżer pakietów NPM, różni się nieco od innych znanych nam menedżerów pakietów, ponieważ instaluje je lokalnie w projektach. Oznacza to, że po pobraniu modułu jest on dodawany do lokalnego projektu, czyli do tego, który będzie mógł go dołączyć. Chociaż istnieje również możliwość zainstalowania pakietów globalnie w naszym systemie.
Rozpoczęcie nowego projektu
Kiedy zaczynamy nowy projekt przy użyciu node.js, konieczne jest stworzenie pliku o nazwie package.json. Jest to rodzaj manifestu, który z kolei zawiera listę wszystkich zależności, z których będzie korzystał Twój projekt.
Zastosowanie pakiet.json
Najlepszym sposobem zarządzania lokalnie zainstalowanymi pakietami jest utworzenie pliku package.json, który pozwala nam:
- Dokumentuj, jakich pakietów używa nasz projekt.
- Określ, jakiej konkretnej wersji pakietu będzie używać nasz projekt.
- Pozwala nam w łatwy sposób dzielić się naszymi zależnościami z innymi programistami.
Wymagania:
Plik package.json musi zawierać co najmniej:
1. Imię i nazwisko:
- Wszystko małymi literami.
- Jedno słowo bez spacji.
- Myślnik i podkreślenie są dozwolone.
2. Wersja:
Przykład pliku package.json:
{"Nazwa": "project_package", "Wersja": "1.0.0"}Jeśli chcesz wygenerować nowy pakiet.json, można to zrobić na 2 sposoby:
1. Załaduj domyślny plik package.json: Z konsoli wykonujemy następującą linię poleceń.
npm init --takCo spowoduje, że:
Aby zmodyfikować tę konfigurację, po prostu otwieramy plik utworzony za pomocą edytora tekstu i modyfikujemy żądane atrybuty.
2. Utwórz plik package.json za pomocą kreatora: W konsoli wykonujemy następujące polecenie.
początek npmKreator zapyta, co chcesz dodać do każdego atrybutu, w wyniku czego:
Instalowanie zależności
Na stronie https://www.npmjs.com/ można znaleźć setki projektów; które są pozycjonowane według różnych kryteriów (liczba pobrań, popularność…). Ze strony internetowej jest to najszybszy sposób, jednak NPM posiada również parametr wyszukiwania do wyszukiwania pakietów. Aby to zrobić, musisz uruchomić następujący wiersz poleceń:
Instalacja lokalna
Po zdefiniowaniu pliku pakiet.json, możesz dodać w nim zależności i dodać listę wszystkiego, czego potrzebujesz:
"dependencies": {"express": "*", "grunt": "*", "bower": "*"}Które powinny wyglądać następująco:
Zainstaluj pakiety wymienione w package.jsonAby zainstalować pakiety wymienione w package.json i ich zależności, musisz znajdować się w katalogu, w którym znajduje się ten plik, i wykonać następujący wiersz poleceń:
instalacja npm
Zainstaluj pakietyMożesz także zainstaluj nowe pakiety i zapisz je z terminala, wykonując następujące czynności:
npm install --save new_package_name
Odinstaluj pakietyOdinstaluj pakiet i usuń go z pakiet.json:
npm odinstaluj --zapisz nazwa_pakietu
Zainstaluj pakiet bezpośrednio z repozytorium Git
npm install git: //github.com/blured/mipaquete.git
Zainstaluj określoną wersję pakietu
npm zainstaluj jakiś[email protected]
Należy pamiętać, że ta lokalna metoda instalacji oznacza, że pliki będą przechowywane i dostępne tylko w katalogu projektu.
Globalna instalacja
Innym sposobem instalowania pakietów jest robienie tego globalnie. Jest to powszechnie używane w przypadku pakietów, które zapewniają funkcjonalność z wiersza poleceń, takich jak między innymi grunt, bower, yeoman.
Weźmy na przykład Pakiet JSHint, który jest analizatorem kodu JavaScript, który pozwala nam pokazać punkty, w których Twój kod nie jest zgodny z pewnymi ustalonymi regułami „czystego kodu”. Aby zainstalować go globalnie, uruchamiamy polecenie instalacji dodanie -g atrybut i z przywilej roota (dla użytkowników Mac i Linux).
sudo npm install -g jshint
npm install -g jshint
Aby potwierdzić jego instalację, po prostu uruchom jego polecenie, aby ocenić jakiś plik JavaScript pod kątem błędów. Ponieważ nasza instalacja była globalna, z dowolnej lokalizacji możemy uruchomić Jshint, wskazując ścieżkę, w której znajduje się nasz plik JavaScript. Przykład:
projekt jshint \ MiApp \ www \ js \ index.jsW wyniku błędu w naszym pliku JavaScript.
Aby poznać folder, w którym przechowywane są wszystkie te biblioteki o zasięgu globalnym, możemy użyć polecenie prefiksu i ze znacznika globalne -g, w następujący sposób:
przedrostek npm -gW terminalu OS X da następujący wynik:
W CWiersz poleceń systemu Windows wyświetlana jest ścieżka, mająca jako jedyną zmienną nazwę folderu użytkownika, który dokonał instalacji. W tym przypadku byłoby to „Żock”:
W systemie Windows NodeJS nie ma zdefiniowanego poprzedniego folderu jako globalnego w celu włączenia jego bibliotek przez wymaganie. Jeśli więc spróbujemy dołączyć bibliotekę globalną, otrzymamy błąd „Błąd: Nie można znaleźć modułu”.
Aby go rozwiązać, będziemy musieli zdefiniować zmienną systemową NODE_PATH, nadając jej wartość globalnej ścieżki NPM i dodając na końcu folder \ node_modules \.
Jak widać, w Windows 7 globalna ścieżka instalacji NPM to:
C:\Użytkownicy\UŻYTKOWNIK\AppData\Roaming\npm\Zatem wartość NODE_PATH będzie wynosić:
C:\Użytkownicy\UŻYTKOWNIK\AppData\Roaming\npm\moduły_węzłów\Lub co to samo:
% APPDATA% \ npm \ node_modules \
POWIĘKSZAĆ
Zarządzanie zależnościami
NPM pozwala zarządzać zależnościami Twoich projektów i potrzebnych wersji. Jak wiadomo, projekty open source aktywnie się przemieszczają i często zmieniają wersję. ten pakiet.json można go skonfigurować do kontrolowania tego typu zmian.
ten numery wersji zwykle zawierają 3 elementy:
- Wersja główna, gdy zrywa z poprzednimi funkcjonalnościami, na przykład: 2.0.0
- Mniejsza wersja z nowymi funkcjami, które nie psują istniejących, na przykład: 1.1.0
- Patch wydany z poprawkami błędów i innymi drobnymi zmianami, na przykład 1.0.1
Zdefiniuj wersje pakietów
Załóżmy, że zaczynasz programować z pewnymi wersjami pakietów. Możesz je aktualizować i nadal zachować zgodność, określając zakres akceptowanych zmian.
"dependencies": {"Package1": "1.0.0", // akceptuje tylko wersję 1.0.0 "container2": "1.0.x", // dowolna wersja poprawki w wersji 1.0 "Package3": "* ", / / najnowsza wersja," Package4 "nie jest zalecana:"> = 1.0.0 ", // zmiany po 1.0.0" package5 ":" = 1.8.0 = 1.1.0 <2.0.0 "package8": "latest" , // nazwa tagu najnowszej wersji "package9": "", // taka sama jak * tj. najnowsza wersja "packageX": "= 2.3.1 = 2.5.2 <3.0.0" }NotatkaJeśli nie masz pewności, której wersji użyć, dodaj symbol wieloznaczny * i uruchom polecenie npm update -save, o czym zobaczymy w dalszej części tego samouczka.
Komenda:
aktualizacja npm --zapisz
Zaktualizuj pakiety
Aby zobaczyć wszystkie lokalnie zainstalowane pakiety, użyj polecenia ls i dodaj atrybut -l, aby uzyskać krótki opis. Aby wyświetlić pakiety zainstalowane globalnie, dodaj atrybut -g.
npm ls -lAby sprawdzić, który pakiet można zaktualizować lokalnie i globalnie, uruchom następujące polecenie:
npm nieaktualny npm nieaktualny -g --depth = 0Aby lokalnie przenieść pakiet do wersji wyższej niż bieżąca, uruchom następujące polecenie:
aktualizacja npmAby zrobić to globalnie, dodaj -g atrybut
Zarządzanie pamięcią podręczną
Gdy program NPM instaluje pakiet, zachowuje kopię na czas następnej instalacji pakietu bez konieczności połączenia z Internetem. Kopie te są domyślnie przechowywane w następującym katalogu:
Posix (Linux, Os X…): ~ / .npm Windows:% AppData% / npm-cacheJeśli chcesz zobaczyć, w którym katalogu przechowywana jest pamięć podręczna NPM, po prostu uruchom następujący wiersz poleceń:
konfiguracja npm pobierz pamięć podręcznąTen katalog jest zwykle wypełniony starymi pakietami, których już nie używamy, dlatego zaleca się okresowe czyszczenie za pomocą następującego wiersza poleceń:
czyszczenie pamięci podręcznej npm
