aslan6474 1
aslan6474
Reklam vermek için turkmmo@gmail.com

Altın Konu npm Nedir? install, init ve Paket Yönetimi

  • Konuyu başlatan Konuyu başlatan Agora Metin2
  • Başlangıç tarihi Başlangıç tarihi
  • Cevaplar Cevaplar 2
  • Görüntüleme Görüntüleme 20
image.jpeg


npm Nedir ve Ne Amaçla Kullanılır?

npm, aslında üç ana bileşenin birleşiminden oluşur. İlk olarak, npmjs.com üzerinde bulunan ve binlerce JavaScript paketini barındıran halka açık devasa bir veritabanıdır (registry). İkinci olarak, Node.js ile gelen ve bu kütüphaneleri yönetmenizi sağlayan komut satırı arayüzüdür (CLI). Üçüncü olarak ise projenizin yapılandırma bilgilerini tutan package.json standardıdır.

npm install express komutunu kullandığınızda, CLI aracılığıyla veritabanına bağlanırsınız; sistem express paketini ve tüm alt bağımlılıklarını indirir, bunları node_modules dizinine taşır ve paketi sürüm bilgisiyle birlikte package.json dosyanıza işler. Süreç temel olarak bu şekilde ilerler.

Node.js yüklü olduğu sürece npm zaten bilgisayarınızda hazırdır. Kontrol etmek için şu komutları kullanabilirsiniz:

JavaScript:
node --version
npm --version

Her iki komut da birer sürüm numarası döndürüyorsa sisteminiz çalışmaya hazırdır.

Proje Kurulumu: npm init

Her npm projesinin bir package.json dosyasına sahip olması şarttır. Bu dosya projenizin kimlik kartı gibidir; isim, versiyon, script tanımlamaları ve bağımlılık listesi gibi kritik bilgileri içerir. Hızlı bir başlangıç için npm init -y komutunu tercih edebilirsiniz; bu komut tüm varsayılan ayarları otomatik olarak onaylayarak dosyayı oluşturur:

JavaScript:
mkdir my-app
cd my-app
npm init -y

Komutu çalıştırdığınızda şu tarz bir çıktı alırsınız:

JavaScript:
{
  "name": "my-app",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

Eğer -y parametresini kullanmazsanız, npm size gerekli alanları tek tek sorarak yönlendirmeli bir kurulum süreci başlatır. Hangi yöntemi seçerseniz seçin, elinizde tüm projenin merkezini oluşturan package.json dosyası olacaktır.

npm install ile Paket Yönetimi

Projenizde bir package.json dosyası varsa, paketleri npm install (veya kısaca npm i) komutuyla sisteme dahil edebilirsiniz:

JavaScript:
npm install lodash

Bu komut üç temel işlemi gerçekleştirir:

1. Belirtilen paket ve bağımlılıkları indirilerek node_modules/ içine yazılır.
2. package.json içindeki dependencies alanına paket bilgisi ve sürümü eklenir.
3. Bağımlılık ağacındaki tüm paketlerin tam sürümlerini sabitleyen package-lock.json dosyası güncellenir.

Artık ilgili paketi projenizde kolayca kullanabilirsiniz:

JavaScript:
// Sonra: npm install lodash
const _ = require("lodash");

const numbers = [1, 2, 3, 4, 5];
console.log(_.sum(numbers));
console.log(_.chunk(numbers, 2));

require veya ESM yapısında import kullandığınızda, Node.js otomatik olarak node_modules içinde arama yapar. Herhangi bir dosya yolu belirtmenize gerek kalmadan sistem modülü bulacaktır.

dependencies ve devDependencies Arasındaki Fark

Uygulamanızın canlı (production) ortamında her pakete ihtiyacı olmayabilir. Test araçları veya derleyiciler gibi sadece geliştirme aşamasında kullanılan paketleri --save-dev (kısa adıyla -D) parametresiyle kurmalısınız:

JavaScript:
npm install --save-dev jest
npm install -D eslint prettier

Bu paketler package.json içerisinde devDependencies başlığı altında gruplanır:

JavaScript:
{
  "dependencies": {
    "lodash": "^4.17.21"
  },
  "devDependencies": {
    "jest": "^29.7.0",
    "eslint": "^8.57.0",
    "prettier": "^3.2.5"
  }
}

Canlı sunucularda npm install --omit=dev komutunu çalıştırarak, sadece uygulama için gerekli paketleri kurabilir, böylece kurulum boyutunu küçültebilirsiniz. Bu ayrımı doğru yapmak, projenizin gereksiz şişmesini engellemek adına oldukça önemlidir.

Tüm Bağımlılıkları Kurmak

package.json dosyası içeren bir projeyi klonladığınızda, paketleri tek tek yüklemenize gerek yoktur. Sadece şu komutu çalıştırmanız yeterlidir:

JavaScript:
npm install

Parametre vermeden bu komutu kullandığınızda npm, dosyayı okur ve package-lock.json dosyasındaki verileri esas alarak tüm bağımlılıkları node_modules içine kurar.

node_modules klasörünü .gitignore dosyasına eklememiz gerekir çünkü bu dizin oldukça büyüktür ve her zaman yeniden üretilebilir. Projenizde sadece package.json ve package-lock.json dosyalarını versiyon kontrol sistemine (git) göndermeniz yeterlidir.

Paket Güncelleme

Güncel olmayan paketleri listelemek için npm outdated komutu kullanılır:

JavaScript:
npm outdated

Karşınıza çıkan tabloda Current, Wanted ve Latest sütunlarını görürsünüz. Wanted, package.json içindeki kısıtlamalara uygun en güncel sürümü; Latest ise paketin dünyadaki en son yayınlanmış sürümünü ifade eder.

Belirlenen sürüm aralığında güncelleme yapmak için şu komutu kullanın:

JavaScript:
npm update

Eğer major (ana) sürüm dahil en son sürüme geçmek isterseniz paketi @latest etiketiyle yeniden kurmanız gerekir:

JavaScript:
npm install lodash@latest

Major güncellemeler kodunuzu etkileyebileceği için, bu yükseltmeyi yapmadan önce paketin değişiklik notlarını incelemeniz önerilir.

Paket Kaldırma

Bir paketi kaldırmak kurulum kadar kolaydır:

JavaScript:
npm uninstall lodash

Bu işlem paketi node_modules klasöründen siler ve package.json kaydını günceller. Eğer paket bir geliştirme bağımlılığıysa -D eklemek kuralı bozmaz.

Local ve Global Kurulum Farkı

Genellikle kurulumlar, projenin kendi klasörüne (local) yapılmalıdır. Yalnızca her yerden erişmek istediğiniz CLI araçları için global kurulum tercih edilir:

JavaScript:
npm install -g typescript
npm install -g http-server

Global kurulum, paketi sistem genelindeki PATH dizinine ekler. Ancak bu durum makineler arası uyumsuzluk yaratabilir. Tek seferlik işlemler için npx kullanmak çok daha modern ve temiz bir yöntemdir:

JavaScript:
npx create-react-app my-app
npx prettier --write .

npx, paketi kalıcı olarak kurmadan, anlık olarak indirip çalıştırmanıza olanak tanır.

Komut Özet Tablosu

Günlük kullanımda sıklıkla başvuracağınız temel komutlar şunlardır:

JavaScript:
npm init -y                     # package.json oluştur
npm install                     # package.json'daki her şeyi yükle
npm install <pkg>               # çalışma zamanı bağımlılığı ekle
npm install -D <pkg>            # geliştirme bağımlılığı ekle
npm install -g <pkg>            # CLI aracını global olarak yükle
npm uninstall <pkg>             # bir bağımlılığı kaldır
npm outdated                    # neyin güncel olmadığını gör
npm update                      # izin verilen aralıklar içinde güncelle
npm install <pkg>@latest        # en yeni sürüme geç
npm run <script>                # package.json'dan bir script çalıştır
npx <pkg>                       # bir paketi yüklemeden çalıştır

npm'in sunduğu temel özellikler bunlardır. Yayınlama veya kapsamlı paket yönetimi gibi detaylar, zamanla ihtiyaç duydukça öğrenilebilir.

node_modules Hakkında Doğru Bilinenler

node_modules, projenin tüm bağımlılık zincirini tutan karmaşık bir yapıdır. Bir paket kurduğunuzda arka planda birçok alt paket inebilir, bu normal bir davranıştır. npm, aynı sürümdeki paketleri ortaklaştırarak verimlilik sağlar.

package-lock.json dosyasının varlığı ise, farklı makinelerde birebir aynı proje yapısının kurulmasını garanti eder. Bu klasörün içeriğini asla elle düzenlemeyin; zira npm install komutu çalıştığı anda elle yaptığınız tüm değişiklikler silinecektir.

Sırada: package.json

package.json, npm'in projenizi yönetmek için kullandığı kalbidir. Buradaki scripts, main veya engines gibi alanları detaylıca öğrenmek, geliştirme sürecinizi profesyonel seviyeye taşıyacaktır. Bir sonraki bölümde bu dosyayı inceleyeceğiz.
 

Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)

Geri
Üst