Mucahid Yazar
mucahid.dev

Follow

mucahid.dev

Follow
NPM Package Oluşturmak / NPM Package Versionları Nedir?

NPM Package Oluşturmak / NPM Package Versionları Nedir?

Mucahid Yazar's photo
Mucahid Yazar
·Feb 19, 2021·

2 min read

Bu yazımda sizler kendi npm packagelerinizi nasıl oluşturacağınızı ve nasıl npm’e yükleyeceğinizi anlatmaya çalışacağım.

NPM nedir?
Npm, Node.js ile birlikte gelen Node Package Manager’dir.

Oluşturduğumuz react, vue gibi Node.js uygulamaları, projeleri için bizde kendi package lerimizi oluşturabiliriz.

Gerekli Environment Kurulumları

  • Node.js

Step 1:

  • Önce npm’in web adresine gidiyoruz ve bir üyelik oluşturuyoruz. npmjs.com

Step 2:

  • Daha sonra terminalden aşağıda ki komutla npm’e login oluyoruz.

npm login

(npm’e giriş için bizden username, password ve email isteyecektir. Npmjs’e kayıt olurken kullandığımız bilgileri gireceğiz.)

Step 3:

  • Daha npm init ile yarattığımız Node.js projesinin içine geliyoruz.
  • Burada ki package.json içinde ki “name” kısmı unique yani eşsiz olmalıdır. Yani burada ki name kısmındaki aynı isimle başka bir npm kütüphanesi olmamalıdır. Bunuda en iyi npm’de search edip kontrol ederek görebilirsiniz.

Step 4:

  • Unique bir npm module name seçtikten sonra package.json içinden, projemiz dizininden terminali açarak, sonrada npm publish yaparak projemizi npm library’e gönderebiliriz.

npm publish

NPM PACKAGE VERSİONs

  • Bildiğiniz gibi bir module yüklediğimizde package.json içerisinde dependencies veya devDependencies olarak, yüklediğimiz moduller kayıt edilir. Bunların yanındada aşağıda ki gibi version numaraları bulunmaktadır.

  • Hatta istersek bunları aşağıdaki kod ile version numarasıyla indirebiliriz. Bu sayede daha önce ki versiyonlarını veya kullanmak istediğimiz versiyonlarını yükleyebiliriz modullerin.

npm install moment@2.25.2

Peki ama ne anlama geliyor bu versioyn numaraları?

  • 3 tip versiyon güncellemesi vardır. Önemliden, önemsize doğru sayarsak, MAJOR-MINOR-PATCH denilir bunlara. Aşağıda anlamanız açısından daha iyi bir örnek bırakıyorum.

npm version major (X)
npm version minor (x.X)
npm version patch (x.x.X)

veya

  • MAJOR, çok büyük güncellemelerde, birden fazla yeni özelliklerde MAJOR yani en önemli versiyon güncellemeleri yapılır.
  • MINOR, yeni özellikler, modüller veya eklentiler gibi güncellemelerde MINOR versiyon olarak değiştirilir.
  • PATCH, hotfixler, küçük değişiklikler için kullanılan versiyon güncellemeleridir.

NPM MODULE GUNCELLEME

  • Diyelim ki bir module oluşturduk ve npm’e publish ettik. Daha sonra modulümüze yeni bir özellik ekledik veya bir hotfix attık, buradan sorna tek yapmamız gereken, yaptığımız güncellemeye göre gerekli versiyon numarasını package.json içerisinden değiştirip, daha sonrada tekrar npm publish yapmaktır.

npm publish

HİNT

  • Burada da konumuzla çok alakası olmasada sizlere package.json içerisinde ki, dependencies’ler kısmında bulunan module’lerin isimlerinin hemen solunda bulunan küçük 2 işaretin (~,^) ne anlamlara geldiğini söyeceğim.

^ => Major, Minor veya Patch versiyonlarında bir değişiklik olduğun d,a bir sonraki npm install ile birlikte bulunduğu packageleri yeni versiyonlarına günceller.

~ => Minor veya Patch versiyonlarında bir değişiklik olduğunda bir sonraki npm install ile birlikte bulunduğu packageleri yeni versiyonlarına günceller.

 
Share this