Popüler olarak npm olarak bilinen Düğüm Paket Yöneticisi, NodeJS paketlerini ve kitaplıklarını yayınlamak için çevrimiçi bir havuzdur.
Aynı zamanda, kayıtlı paketlerle etkileşime girmenizi sağlayan bir komut satırı aracıdır. Paket kurulumu, sürüm yönetimi ve bağımlılık yönetimi konusunda yardımcı olabilir.
Geliştiriciler, JavaScript kitaplıklarını her gün npm’de yayınlar. İşlem oldukça basittir, yani siz de npm’de bir paket yayınlayabilirsiniz.
Adım 1: NodeJS Kurulumu
npm ile etkileşime geçmek için, sisteminizde global olarak kurulu olması gerekir.
NodeJS ve npm’yi Ubuntu’ya , Windows’a yükleyerek veya NodeJS web sitesindeki talimatları izleyerek başlayın .
2. Adım: Bir npm Hesabı Oluşturma
Paketlerinizi npm’de yayınlamak için resmi npm web sitesinde bir npm hesabı oluşturmalısınız.
Bir npm hesabı oluşturmak için aşağıdaki adımları izleyin:
npm kayıt sayfasına gidin .
Bilgilerinizi girin, lisans ve gizlilik politikasını kabul edin ve “hesap oluştur”a tıklayın.
Posta kutunuzdaki npm’den alacağınız bağlantı ile e-postanızı doğrulayın.
E-posta adresinizi doğrulamazsanız, paketlerinizi yayınlamaya çalıştığınızda npm bir hata atar.
3. Adım: Bir Git Deposunu Başlatma
Ardından, projenizde yapacağınız tüm değişiklikleri izlemek için bir Git deposu başlatmanız gerekir.
Terminalinizde, projenizin kök dizinine gidin ve boş bir Git deposunu başlatmak için aşağıdaki komutu çalıştırın.
git init
Bir .gitignore dosyası oluşturun ve Git’in izlemesini istemediğiniz dosyaları ekleyin. Ardından, kalan dosyaları izlemek için aşağıdaki komutu çalıştırın:
git add -A
Ardından, kodu Git’e işleyerek ilk anlık görüntünüzü almak için aşağıdaki komutu çalıştırın.
git commit -m initial-commit
Sorunsuz işbirliği için Git deponuzu GitHub’da veya Gitlab gibi benzer bir hizmette barındırmayı seçebilirsiniz .
Adım 4: Projenizde npm’yi Başlatma
Ardından, projenizle ilgili ayrıntıları bir package.json dosyasına eklemek için projenizde npm’yi başlatın. Bu ayrıntılar npm’de herkese açık olacak.
Terminalinizde, projenizin kök dizinine gidin ve projenizde npm’yi başlatmak için aşağıdaki komutu çalıştırın.
npm init
Yukarıdaki komut, komut satırınızda bir dizi bilgi istemini tetikleyecektir:
paket adı : Bu, npm paketinizin adıdır; paketi npm’de yayınlamak istiyorsanız benzersiz olmalıdır; Aksi takdirde, npm bir hata atar.
version : Bu özellik, paketinizin geçerli sürümünü belirtir. Paketinizi her güncellediğinizde artırmanız gerekir, aksi takdirde npm bir hata atar. Varsayılan değer 1.0.0’dır.
açıklama : Bu özellik, paketinizin açıklamasıdır. Paketinizi yayınladığınızda herkese açık olacaktır.
giriş noktası : Bu özellik, kod yürütmenizin başladığı dosya adını belirtir.
test komutu : Bu özellik, npm run test komutunu yürüttüğünüzde çalışacak komutu belirtir .
git deposu : Bu özellik, uzak Git deponuzun URL’sidir.
anahtar kelimeler : Bu özellik, arama motorunun onu bulmasına yardımcı olacak, projenizle ilgili anahtar kelimeleri belirtir.
yazar : Bu özellik, adınız veya takma adınız olmalıdır.
lisans : Bu, paketi altında yayınlamak istediğiniz lisanstır. Varsayılan lisans, İnternet Sistemleri Konsorsiyumu (ISC) lisansıdır.
Bunu ayarladıktan sonra paketinizi oluşturabilirsiniz.
5. Adım: Paketinizi Test Etme
Paketinizi oluşturmayı bitirdikten sonra, onu npm’de konuşlandırdıktan sonra nasıl davranacağını görmek için yerel olarak test etmelisiniz.
Paketinizi yerel olarak test etmek için önce projenizin dizininde aşağıdaki komutu çalıştırın:
npm link
Yukarıdaki komut, paketinize npm tarafından barındırılan bir pakette yaptığınız gibi yerel olarak başvurmanıza olanak tanır.
Ardından, projenizin kök dizininde başka bir klasör oluşturun ve içine cd yazın.
mkdir test
cd test
Test klasöründe, paketinizi klasöre bağlamak için aşağıdaki komutu çalıştırın:
npm link name-of-your-package
Son olarak, paketinizin işlevselliğini test etmek için sahte bir dosya oluşturun.
Testlerinizi tamamladıktan sonra test klasörünüzü güvenle silebilirsiniz.
Adım 6: Sisteminizde npm’de Oturum Açma
Ardından, sisteminizde npm hesabınıza giriş yapmalısınız.
npm hesabınıza giriş yapmak için aşağıdaki komutu çalıştırın:
npm login
Bu, kullanıcı adınızı, şifrenizi ve iki faktörlü bir kimlik doğrulama kodunu (hesabınızda etkinleştirdiyseniz) doldurmanızı isteyecektir.
Adım 7: Paketinizi Yayınlama
Yukarıdaki tüm adımları tamamladıktan sonra, paketinizi npm’de yayınlamak için aşağıdaki komutu çalıştırın.
npm publish
Bu komut, e-postanıza gönderilecek tek seferlik bir parola gerektirir. Ardından, paketinizi npm’de yayınlayacaktır.
Yayınlamış olduğunuz paketleri npm üzerinden görüntüleyebilirsiniz. npmjs.com’da npm hesabınıza giriş yapın ve profil panonuzdaki paketler bölümüne gidin.
Paketinizi kurmak ve projelerinizden herhangi birinde bir bağımlılık olarak kullanmak için şunu çalıştırın:
npm install name-of-your-package
Paketinizi npm’den Silme
npm’de paketleriniz üzerinde hâlâ tam kontrole sahipsiniz, yani paketinizi npm’den kalıcı olarak değiştirebilir ve hatta silebilirsiniz. Paketinizin ayarlar bölümüne gidip paketi sil seçeneğini işaretleyerek paketlerinizi silebilirsiniz.