NPM: JavaScript Paketlerini Yönetin

Giriş NPM

NPM nedir?NPM (Düğüm Paket Yöneticisi), JavaScript için bir paket yöneticisidir, node.js için varsayılandır. Düğüm kurduğunuzda NPM de yüklenir. Ve bu ne anlama geliyor? NPM aracılığıyla uygulamalarımız için paketleri kurabilir ve yönetebiliriz.

Node.js'yi kullandığımızda, hızlı bir şekilde yeni modüller (kütüphaneler) kurmamız gerekiyor, çünkü güçlü modüler bir sistem olan Node, neredeyse boş geliyor. Bu nedenle, işlemlerin çoğu için ek modüller kurmamız gerekecek. Bu işlem NPM aracıyla çok kolay bir şekilde yapılır.

Node.js nasıl kurulur?Node.js'yi kurmak için yapmamız gereken ilk şey resmi web sitesine girmek:

https://nodejs.org/

Ve yükleyiciyi işletim sistemimize göre indirin.

BÜYÜT

Kurulum dosyasını indirirken üzerine çift tıklıyoruz ve Node.js kurulum sihirbazının talimatlarını takip ediyoruz.

Windows kullanıcıları için yüklendikten sonra, node.js konsoluna aşağıdaki resimde gösterildiği gibi başlatma çubuğundan erişilebilir:

BÜYÜT

Mac kullanıcılarının aşağıdaki resimde gösterildiği gibi işletim sistemlerinin terminalini açmaları gerekecektir:

BÜYÜT

Doğru kurulduğunu kontrol etmek için terminalimizde aşağıdaki komutu uyguluyoruz:

 verme

(Windows / Linux / Terminal OS X Konsolu)

Biz iteriz Girmek ve aşağıdaki satırı giriyoruz:

 Console.log ('Node.js başarıyla yüklendi');

(Windows / Linux / Terminal OS X Konsolu)

Basarak Girmek, bize mesajı gösterecek "Node.js başarıyla yüklendi". node.js tarafından izin verilen komutların listesini görmek için komutu giriyoruz. .Yardım aşağıdaki resimde gösterildiği gibi:

görüntülemek için NPM sürümü yüklü, aşağıdaki komutu uyguluyoruz:

 npm -v

Hangisi aşağıdakilerle sonuçlanacaktır:

Paketleme yöneticisi
NS NPM paket yöneticisi, bildiğimiz diğer paket yöneticilerinden biraz farklıdır, çünkü onları projelerde yerel olarak kurar. Yani, bir modül indirildiğinde, dahil etmeye hazır olacak olan yerel bir projeye eklenir. Paketleri global olarak sistemimize kurma imkanı da olmasına rağmen.

Yeni bir projeye başlamak

node.js kullanarak yeni bir projeye başladığımızda package.json adında bir dosya oluşturmamız gerekiyor. Bu, projenizin kullanacağı tüm bağımlılıkların listesini içeren bir tür bildirimdir.

Kullanımı paket.json

Yerel olarak kurulmuş paketleri yönetmenin en iyi yolu bir package.json dosyası oluşturmaktır, bu bize şunları yapmamızı sağlar:

• Projemizin hangi paketleri kullandığını belgeleyin.
• Projemizin hangi özel paket sürümünü kullanacağını belirtin.
• Bağımlılıklarımızı diğer geliştiricilerle kolayca paylaşmamızı sağlar.

Gereksinimler:

Bir package.json dosyasında en az şunlar olmalıdır:

1. İsim:

• Hepsi küçük harfle.
• Boşluksuz tek kelime.
• Kısa çizgi ve alt çizgiye izin verilir.

2. Sürüm:

package.json örneği:

 {"Ad": "proje_paket", "Sürüm": "1.0.0"}

Yeni bir tane oluşturmak istiyorsanız paket.json, bunu yapmanın 2 yolu vardır:

1. Varsayılan bir package.json yükleyin: Konsoldan aşağıdaki komut satırını çalıştırıyoruz.

 npm başlangıç ​​-- evet

Hangisi aşağıdakilerle sonuçlanacaktır:

Bu konfigürasyonu değiştirmek için, bir metin düzenleyici ile oluşturulan dosyayı açmamız ve istediğimiz öznitelikleri değiştirmemiz yeterlidir.

2. Sihirbazla bir package.json oluşturun: Konsolda aşağıdaki komutu uyguluyoruz.

 npm başlangıç

Sihirbaz size her bir özniteliğe ne eklemek istediğinizi soracak ve aşağıdakilerle sonuçlanacaktır:

Bağımlılıkları yükleme

https://www.npmjs.com/ web sitesinden yüzlerce proje bulabilirsiniz; farklı kriterlere göre konumlandırılmış (indirme sayısı, popülerlik …). Web sayfasından bu en hızlı yoldur, ancak NPM ayrıca paketleri aramak için bir arama parametresine sahiptir. Bunu yapmak için aşağıdaki komut satırını çalıştırmalısınız:

Yerel Kurulum
Dosya tanımlandıktan sonra paket.json, içindeki bağımlılıkları ekleyebilir ve ihtiyacınız olan her şeyin bir listesini ekleyebilirsiniz:

 "bağımlılıklar": {"express": "*", "grunt": "*", "bower": "*"}

Hangisi aşağıdaki gibi olmalıdır:

package.json içinde listelenen paketleri kurunpackage.json'da listelenen paketleri ve bunların bağımlılıklarını kurmak için, söz konusu dosyanın bulunduğu dizinde bulunmalı ve aşağıdaki komut satırını yürütmelisiniz:

 npm kurulumu

Paketleri yükleAyrıca yeni paketler kurun ve bunları terminalden kaydedin, aşağıdakileri yürüterek:

 npm kurulumu -- yeni_paket_adı kaydet

Paketleri kaldırPaketi kaldır ve onu sil paket.json:

 npm kaldırma --paket_adı kaydet

Paketi doğrudan Git deposundan yükleyin

 npm git'i kurun: //github.com/blured/mipaquete.git

Bir paketin belirli bir sürümünü yükleyin

 npm bir paket [email protected]

Bu yerel yükleme yönteminin, dosyalarınızın yalnızca proje dizininizde saklanacağı ve kullanılabilir olacağı anlamına geldiğini unutmamak önemlidir.

Küresel Kurulum
Paketleri kurmanın başka bir yolu da global olarak yapmaktır. Bu genellikle, diğerleri arasında grunt, bower, yeoman gibi komut satırından işlevsellik sağlayan paketler için kullanılır.

Örneğin JSHint paketi, kodunuzun belirli yerleşik "temiz kod" kurallarına uymadığı noktaları göstermemize izin veren bir JavaScript kod analizörüdür. Global olarak kurmak için, komut yükle ekleyerek -g özelliği Ve birlikte kök ayrıcalığı (Mac ve Linux kullanıcıları için).

 sudo npm kurulum -g jshint

 npm kurulum -g jshint

Kurulumunu onaylamak için, bazı JavaScript dosyalarını hatalara karşı değerlendirmek için komutunu çalıştırmanız yeterlidir. Kurulumumuz global olduğundan, herhangi bir konumdan JavaScript dosyamızın bulunduğu yolu belirten Jshint'i çalıştırabiliriz. Örnek:

 jshint projesi \ MiApp \ www \ js \ index.js

JavaScript dosyamızda bir hatayla sonuçlanıyor.

Global kapsamdaki tüm bu kitaplıkların saklandığı klasörü bilmek için kullanabiliriz. önek komutu ve işaretçiden küresel -g, aşağıdaki gibi:

 npm öneki -g

Bir OS X terminalinde aşağıdaki sonucu verecektir:

CDEWindows komut istemi tek değişken olarak yüklemeyi yapan kullanıcının klasörünün adı olan yol görüntülenir. Bu durumda olurdu "Zok":

Windows'ta NodeJS, kitaplıklarının gerekli aracılığıyla dahil edilmesi için global olarak tanımlanan önceki klasöre sahip değildir. Yani global bir kütüphane eklemeye çalışırsak, "Hata: Modül bulunamıyor" hatası alırız.

Bunu çözmek için NODE_PATH sistem değişkenini tanımlamamız, ona NPM'nin global yolunun değerini vermemiz ve sonuna \ node_modules \ klasörünü eklememiz gerekecek.

Gördüğümüz gibi, Windows 7'de NPM'nin global kurulum yolu:

 C: \ Kullanıcılar \ KULLANICI \ AppData \ Dolaşım \ npm \

Yani NODE_PATH değeri şöyle olacaktır:

 C: \ Kullanıcılar \ KULLANICI \ AppData \ Dolaşım \ npm \ node_modules \

Ya da aynısı nedir:

 % APPDATA% \ npm \ düğüm_modülleri \

BÜYÜT

Bağımlılık yönetimi
NPM, projelerinizin bağımlılıklarını ve ihtiyacınız olan sürümleri yönetmenize olanak tanır.. Bilindiği gibi açık kaynak projeler aktif olarak hareket etmekte ve sıklıkla versiyon değiştirmektedir. NS paket.json bu tür değişiklikleri kontrol etmek için yapılandırılabilir.

NS sürüm numaraları normalde 3 element içerirler:

• Önceki işlevlerle bozulduğunda ana sürüm, örneğin: 2.0.0
• Mevcut olanları bozmayan yeni özelliklere sahip küçük sürüm, örneğin: 1.1.0
• Hata düzeltmeleri ve diğer küçük değişikliklerle birlikte yayınlanan yama, örneğin 1.0.1

Paket sürümlerini tanımlayın

Belirli paket sürümleriyle geliştirmeye başladığınızı varsayalım. Kabul edilen değişikliklerin aralığını belirterek bunları güncelleyebilir ve yine de uyumluluğu koruyabilirsiniz.

 "bağımlılıklar": {"Paket1": "1.0.0", // yalnızca 1.0.0 sürümünü kabul eder "container2": "1.0.x", // 1.0 sürümündeki herhangi bir düzeltme sürümü "Package3": "* ", / / en son sürüm," Paket4 "önerilmez:"> = 1.0.0 ", // 1.0.0'dan sonraki değişiklikler" paket5 ":" = 1.8.0 = 1.1.0 <2.0.0 "package8": "en son" , // en son sürüm etiket adı "package9": "", // * ile aynı, yani en son sürüm "packageX": "= 2.3.1 = 2.5.2 <3.0.0" }

NotHangi sürümü kullanacağınızdan emin değilseniz, * joker karakterini ekleyin ve bu eğitimde daha sonra göreceğimiz npm update -save komutunu çalıştırın.

Emretmek:

 npm güncellemesi -- kaydet

Paketleri güncelle

Yerel olarak kurulmuş tüm paketleri görmek için ls komutunu kullanın ve kısa bir açıklama için -l özniteliğini ekleyin. Global olarak kurulmuş paketleri görüntülemek için -g niteliğini ekleyin.

 npm ls -l

Hangi paketin yerel ve genel olarak güncellenebileceğini kontrol etmek için aşağıdakileri çalıştırın:

 npm güncel değil npm güncel değil -g --depth = 0

Bir paketi yerel olarak mevcut sürümden daha yüksek bir sürüme getirmek için aşağıdakileri çalıştırın:

 npm güncellemesi

Global olarak yapmak için şunu ekleyin: -g özelliği

Önbelleği Yönetme

NPM bir paket kurduğunda, paketi bir sonraki internet bağlantısına ihtiyaç duymadan kurmak istediğinizde kullanmak üzere bir kopyasını saklar. Bu kopyalar varsayılan olarak aşağıdaki dizinde saklanır:

 Posix (Linux, Os X…): ~ / .npm Windows:% AppData% / npm-cache

NPM önbelleğinin hangi dizinde saklandığını görmek istiyorsanız, aşağıdaki komut satırını çalıştırmanız yeterlidir:

 npm yapılandırma önbelleği al

Bu dizin genellikle artık kullanmadığımız eski paketlerle doludur, bu nedenle aşağıdaki komut satırıyla düzenli aralıklarla temizlemeniz önerilir:

 npm önbelleği temizleme