npm: temeller, React Native ve Node.js için paket yöneticisi

npm nedir — Node.js paket yöneticisi?

npm, 2010 yılında Isaac Schlueter tarafından Node.js bağımlılık yönetimi için bir çözüm olarak oluşturuldu. 2014'ten beri npm, npm, Inc. tarafından yönetilmektedir ve 2020'de Microsoft/GitHub tarafından satın alınmıştır. Araç iki bölümden oluşur: paketleri yüklemek ve yönetmek için CLI (komut satırı) ve registry.npmjs.org adresindeki tüm yayınlanmış modüllerin merkezi deposu olan Registry.

npm Registry en büyük paket kaydıdır: 2 milyondan fazla paket ve aylık 10 milyardan fazla indirme. Her paketin bir SemVer sürümü, açıklaması, bağımlılıkları, lisansı ve yazarlığı vardır. Kendi paketinizi yayınlamak npm publish ile yapılır. npm, kuruluşlar için kapsamlı paketleri (@scope/package), özel kayıtları ve yerleşik güvenlik denetimini destekler.

Node.js sürüm 18+, gelişmiş performansa sahip npm 9+, monorepo'lar için çalışma alanları ve yeniden tasarlanmış eş bağımlılık mekanizması içerir. npm ekosistemi, sunucu taraflı JavaScript, ön yüz (React, Vue, Angular), mobil geliştirme (React Native), derleme araçları (Webpack, Vite) ve CLI yardımcı programlarını kapsar. npm, JavaScript kitaplıklarının birincil dağıtım kanalıdır.

npm'in Temel Özellikleri

npm install — tüm bağımlılıkları node_modules'a yüklemek için package.json ve package-lock.json'ı okuyan ana komuttur. İlk çalıştırmada npm, bağımlılık grafiğini hesaplar, sürüm çakışmalarını çözer ve package-lock.json'ı oluşturur. npm install <package> komutu belirli bir paketi yükler; --save-dev bayrağı onu devDependencies'e ekler, --global ise genel olarak yükler.

npx — npm sürüm 5.2'den itibaren dahil edilen bir paket çalıştırıcısıdır. npx, genel kurulum olmadan CLI yardımcı programlarını çalıştırmaya olanak tanır: npx react-native init veya npx create-react-app my-app. npx, paketi geçici bir önbelleğe indirir, çalıştırır ve tamamlandıktan sonra temizler. npx ayrıca belirli araç sürümlerini çalıştırmak için de kullanışlıdır.

npm audit, npm veritabanındaki bilinen güvenlik açıkları için bağımlılık ağacını tarar. Komut, önem düzeylerine (critical, high, moderate) sahip bir rapor çıkarır ve güvenlik açığı bulunan paketleri otomatik olarak güncellemek için npm audit fix önerir. npm cache, indirilen paketleri yerel olarak depolar. npm cache clean --force, kurulum sorunlarında önbelleği temizler. npm outdated, güncel olmayan paketleri gösterir.

# Temel npm komutları
$ npm install
$ npm install react-native-webview --save
$ npm install typescript --save-dev
# Genel kurulum olmadan çalıştırma
$ npx react-native init MyApp
# Güvenlik denetimi
$ npm audit --fix

package.json Yapısı ve Bağımlılık Yönetimi

package.json, proje kökünde meta verilerini, bağımlılıklarını ve yapılandırmasını açıklayan bir JSON dosyasıdır. Zorunlu alanlar: name (benzersiz paket adı) ve version (SemVer sürümü, örn. 1.0.0). Dosya, hızlı başlatma için npm init -y ile veya manuel olarak oluşturulur.

Semantic Versioning (SemVer), MAJOR.MINOR.PATCH biçiminde bir sürümleme standardıdır. Ana sürüm, uyumsuz API değişikliklerinde değişir, alt sürüm — işlevsellik eklerken (geriye dönük uyumlu), yama — hata düzeltmelerinde. Sürümden önceki ^ sembolü, alt sürüm ve yama güncellemelerine izin verir, ~ ise yalnızca yama güncellemelerine izin verir.

{
  "name": "my-app",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "start": "expo start",
    "android": "expo start --android",
    "ios": "expo start --ios"
  },
  "dependencies": {
    "react": "^18.3.0",
    "react-native": "^0.76.0"
  },
  "devDependencies": {
    "typescript": "^5.5.0",
    "@types/react": "^18.3.0"
  }
}

React Native Geliştirmede npm

React Native projeleri, bağımlılık yönetimi için npm'i aktif olarak kullanır. Standart set, react, react-native, gezinme kitaplıkları (React Navigation), HTTP kitaplıkları (axios), durum yönetimi (Redux, Zustand) ve UI bileşenlerini içerir. npm, kayıttan binlerce uyumlu paket yüklemeye olanak tanır.

npx pod-install — iOS için React Native'de yerel modüller yüklendikten sonra gerekli bir komuttur. npm, package-lock.json'a dayalı olarak otomatik olarak bir Podfile.lock oluşturur. Expo projelerinde npm install yerine expo install kullanılır çünkü mevcut Expo SDK sürümüyle uyumlu sürümleri seçer.

Sürüm çakışmaları React Native'de yaygın bir sorundur: react-native-reanimated, react-native-gesture-handler ve react-native-safe-area-context uyumlu sürümler gerektirir. Çözüm, tüm paketleri en son uyumlu sürümlere güncellemek veya --legacy-peer-deps kullanmaktır. package-lock.json, CocoaPods ve Gradle aracılığıyla derlenen yerel modüller için kritiktir.

npm'in Alternatif Yöneticilerle Karşılaştırılması

npm, Node.js ile birlikte gelen standart paket yöneticisidir. Ana alternatifler: yarn (2016'da Facebook tarafından oluşturuldu) ve pnpm (hızlı, sabit bağlantılarla). npm 5'ten bu yana, npm ve yarn arasındaki hız ve işlevsellik farkı minimumdur. npm 7+, çalışma alanları ekleyerek onu monorepo'lar için rekabetçi hale getirdi.

State of JS 2025'e göre: Geliştiricilerin %62'si npm kullanıyor, %35'i yarn (çoğunlukla eski projeler ve PnP meraklıları) ve %3'ü pnpm kullanıyor. React Native projeleri için her iki araç da eşit derecede uygundur, ancak npm, Expo SDK 50+ ve yeni React Native başlatmalarını kullanan projelerde daha yaygındır.

yarn, daha olgun çalışma alanı uygulaması ve Plug'n'Play sayesinde son derece büyük monorepo'larda (100+ paket) avantajını korur. pnpm, genel bir depoya sabit bağlantılar yoluyla disk alanı tasarrufunda kazanır. Yönetici seçimi, ekip tercihlerine ve altyapıya bağlıdır.