Yarn Paket Yöneticisine Hızlı Bir Giriş
Modern web geliştirme dünyasında bağımlılık yönetimi, projelerin karmaşıklığı arttıkça hayati bir rol oynamaktadır. JavaScript ekosistemi, sayısız kütüphane ve araçla dolup taşarken, bu bağımlılıkları etkili bir şekilde yönetmek, geliştirme sürecinin sorunsuz ilerlemesi için kritik öneme sahiptir. Bu noktada, paket yöneticileri devreye girer. Yıllardır JavaScript geliştiricilerinin birincil tercihi olan npm (Node Package Manager) ile birlikte, son yıllarda popülaritesi hızla artan bir diğer güçlü araç ise Yarn’dır.
Yarn, Facebook (şimdiki adıyla Meta) tarafından 2016 yılında, npm’in o dönemdeki bazı performans, güvenlik ve güvenilirlik eksikliklerini gidermek amacıyla geliştirilmiş, hızlı, güvenli ve güvenilir bir JavaScript paket yöneticisidir. Açık kaynak kodlu yapısı sayesinde kısa sürede geniş bir geliştirici kitlesi tarafından benimsenmiş ve JavaScript projelerinde bağımlılık yönetiminin standartlarından biri haline gelmiştir. Bu makale, Yarn’ın ne olduğunu, neden ortaya çıktığını, temel özelliklerini, kurulumunu, sık kullanılan komutlarını ve ileri düzey yeteneklerini kapsamlı bir şekilde ele alacaktır.
Yarn’ın Tarihçesi ve Ortaya Çıkışı
Yarn’ın hikayesi, npm’in belirli zorluklarla karşılaştığı bir dönemde başlar. 2010’lu yılların ortalarında, npm büyük ve karmaşık projelerde bağımlılıkları kurarken zaman zaman performans sorunları yaşıyordu. Özellikle büyük monorepo’larda veya çok sayıda bağımlılığı olan projelerde kurulum süreleri uzayabiliyor, bu da geliştirme verimliliğini olumsuz etkiliyordu. Ayrıca, npm’in o dönemdeki deterministik olmayan bağımlılık kurulumu, farklı geliştirme ortamlarında veya CI/CD (Sürekli Entegrasyon/Sürekli Dağıtım) süreçlerinde tutarsızlıklara yol açabiliyordu. Bir proje bir ortamda çalışırken, başka bir ortamda farklı bağımlılık versiyonları nedeniyle hatalar verebiliyordu.
Facebook gibi büyük ölçekli şirketler, kendi iç projelerinde bu tür sorunları sıkça yaşıyordu. Binlerce bağımlılığı olan projelerde, kurulumun dakikalar hatta bazen saatler sürmesi kabul edilemezdi. Bu sorunları çözmek ve daha iyi bir geliştirme deneyimi sağlamak amacıyla Facebook, Exponent (şimdiki adıyla Expo), Google ve Tilde gibi şirketlerle iş birliği yaparak Yarn’ı geliştirdi. Yarn’ın temel amacı, hızlı, güvenli ve deterministik bağımlılık yönetimi sunmaktı.
Yarn’ın piyasaya sürülmesiyle birlikte, npm de bu rekabetten ders çıkararak kendi performansını ve özelliklerini önemli ölçüde geliştirdi. Ancak Yarn, özellikle büyük ölçekli projeler ve monorepo’lar için sunduğu avantajlarla kendine sağlam bir yer edinmeyi başardı.
Yarn’ın Temel Özellikleri ve Avantajları
Yarn, npm’e kıyasla bir dizi önemli avantaj sunar:
Hız
- Paralel Kurulum: Yarn, bağımlılıkları aynı anda ve paralel olarak indirerek kurulum sürelerini önemli ölçüde kısaltır. npm’in eski versiyonları bağımlılıkları genellikle seri olarak kurarken, Yarn bu süreci optimize eder.
- Önbellekleme (Caching): Yarn, daha önce indirilen paketleri yerel bir önbellekte saklar. Bu sayede, aynı bağımlılıklar farklı projelerde veya aynı projenin sonraki kurulumlarında tekrar indirilmek yerine önbellekten hızlıca alınır. Bu özellik, özellikle çevrimdışı çalışırken veya zayıf internet bağlantısı olan ortamlarda büyük bir avantaj sağlar.
Güvenilirlik ve Deterministik Bağımlılık Yönetimi
yarn.lockDosyası: Yarn, bağımlılık ağacının tam ve kesin bir kaydını tutan biryarn.lockdosyası oluşturur. Bu dosya, her bir bağımlılığın tam olarak hangi versiyonunun ve alt bağımlılıklarının kullanıldığını belirtir. Bu sayede, projenin farklı ortamlarda (geliştirme, test, üretim) veya farklı geliştiriciler tarafından kurulduğunda her zaman aynı bağımlılık ağacının elde edilmesi garanti edilir. Bu deterministik yaklaşım, “benim makinemde çalışıyor” sorununu ortadan kaldırır.
Güvenlik
- Sağlama Toplamları (Checksums): Yarn, indirilen paketlerin bütünlüğünü ve güvenliğini sağlamak için sağlama toplamları kullanır.
yarn.lockdosyasında her paketin sağlama toplamı (integrity hash) bulunur ve paket indirildiğinde bu değer doğrulanır. Bu, kötü niyetli bir paketin indirilmesini veya paketin aktarım sırasında bozulmasını engeller. - Sınırlı Kod Yürütme: Yarn, paket kurulumu sırasında rastgele kod yürütme riskini en aza indirmek için tasarlanmıştır. Bu, potansiyel güvenlik açıklarını azaltır.
Çevrimdışı Mod
- Yarn’ın güçlü önbellekleme mekanizması sayesinde, bir kez indirilen paketler yerel önbellekte saklandığından, daha sonraki kurulumlar internet bağlantısı olmasa bile gerçekleştirilebilir. Bu, özellikle seyahat eden geliştiriciler veya kısıtlı ağ erişimi olan ortamlar için büyük bir kolaylık sağlar.
Monorepo Desteği (Yarn Workspaces)
- Yarn, monorepo adı verilen, birden fazla projenin (alt paketin) tek bir depoda yönetildiği yapılar için özel olarak tasarlanmış Workspaces (Çalışma Alanları) özelliğini sunar. Bu özellik, bağımlılıkların tek bir merkezden yönetilmesini, alt paketler arası yerel bağlantıların kolayca kurulmasını ve genel olarak monorepo geliştirme deneyimini büyük ölçüde iyileştirir.
Eklenti Sistemi (Yarn Berry ile)
- Yarn’ın modern versiyonları (Yarn 2 ve sonrası, genellikle Yarn Berry olarak anılır), güçlü bir eklenti sistemi sunar. Bu sistem, Yarn’ın çekirdek işlevselliğini genişletmeye ve özelleştirmeye olanak tanır. Geliştiriciler, kendi eklentilerini yazabilir veya topluluk tarafından geliştirilen eklentileri kullanarak yeni özellikler ekleyebilirler (örneğin, TypeScript desteği, dlx komutu gibi).
Yarn Kurulumu
Yarn’ı kullanmaya başlamak oldukça basittir. Node.js ve npm’in sisteminizde kurulu olduğunu varsayıyoruz, çünkü Yarn genellikle npm aracılığıyla veya Node.js ile birlikte dağıtılan bir araç olarak kurulur.
npm ile Kurulum
En yaygın kurulum yöntemi, npm global olarak kurmaktır:
npm install -g yarn
Bu komut, Yarn CLI’yı sisteminizde global olarak erişilebilir hale getirir. Kurulumdan sonra, Yarn’ın doğru bir şekilde kurulup kurulmadığını ve versiyonunu kontrol edebilirsiniz:
yarn --version
Eğer bir versiyon numarası görüyorsanız, kurulum başarılı demektir.
Homebrew (macOS) ile Kurulum
macOS kullanıcıları için Homebrew paket yöneticisi ile kurulum da popüler bir seçenektir:
brew install yarn
Bu yöntem, Node.js’i de kurar (eğer kurulu değilse). Eğer Node.js zaten kuruluysa, sadece Yarn’ı kurar.
Diğer Kurulum Yöntemleri
- Windows için MSI Yükleyici: Yarn’ın resmi web sitesinden (
yarnpkg.com) Windows için bir MSI yükleyici indirebilirsiniz. - Standalone Script: Gelişmiş kullanıcılar veya belirli ortamlar için, Yarn’ı Node.js’e bağımlı olmadan standalone bir script olarak da kurmak mümkündür. Ancak bu yöntem daha az yaygındır ve genellikle özel durumlar için kullanılır.
Önemli Not: Yarn’ın modern versiyonları (Yarn 2/3/4, yani Yarn Berry), projeye özgü kurulumları teşvik eder. Bu, her projenin kendi Yarn versiyonunu ve yapılandırmasını taşımasına olanak tanır. Global kurulum yerine, projenin kök dizininde yarn set version stable gibi bir komutla Yarn’ı projeye kurmanız önerilir. Bu, projenin .yarn/releases dizinine Yarn binary’sini indirir ve .yarnrc.yml dosyasında yapılandırmayı yapar. Bu sayede, farklı projelerde farklı Yarn versiyonlarını güvenle kullanabilirsiniz.
Temel Yarn Komutları
Yarn’ın kullanımı, npm’e benzer bir komut satırı arayüzüne sahiptir. İşte en sık kullanılan Yarn komutları:
yarn init
Yeni bir Yarn projesi başlatmak için kullanılır. Proje dizininde etkileşimli bir şekilde package.json dosyasını oluşturmanızı sağlar. Proje adı, versiyon, açıklama, giriş noktası gibi bilgileri sorar.
yarn init
yarn add [paket_adı]
Bir paketi projenize bağımlılık olarak eklemek için kullanılır. Paketi indirir, package.json dosyasına kaydeder ve yarn.lock dosyasını günceller.
yarn add lodash
Geliştirme bağımlılığı olarak eklemek için (devDependencies):
yarn add -D webpack
Opsiyonel bağımlılık olarak eklemek için (optionalDependencies):
yarn add -O fsevents
Belirli bir versiyonu eklemek için:
yarn add react@17.0.2
yarn install veya yarn
Projenin package.json dosyasında belirtilen tüm bağımlılıkları ve yarn.lock dosyasında kilitlenen versiyonları kurmak için kullanılır. Genellikle projeyi klonladıktan veya yeni bağımlılıklar ekledikten sonra çalıştırılır.
yarn install
veya kısaca:
yarn
yarn remove [paket_adı]
Bir paketi projenin bağımlılıklarından kaldırmak için kullanılır. Paketi node_modules dizininden siler, package.json dosyasından kaldırır ve yarn.lock dosyasını günceller.
yarn remove lodash
yarn upgrade [paket_adı]
Bir veya daha fazla paketi en son uyumlu versiyonlarına güncellemek için kullanılır. Eğer paket adı belirtilmezse, tüm bağımlılıklar güncellenir (package.json‘daki semver aralığına göre).
yarn upgrade
Belirli bir paketi güncellemek için:
yarn upgrade react
Tüm bağımlılıkları package.json‘da belirtilen semver aralığının dışındaki en son versiyonlarına güncellemek için (dikkatli kullanılmalıdır):
yarn upgrade --latest
yarn run [script_adı]
package.json dosyasının scripts bölümünde tanımlanmış özel komutları çalıştırmak için kullanılır.
yarn run start
Eğer script adı yaygın bir isimse (start, test, build gibi), run kelimesini atlayarak doğrudan çalıştırabilirsiniz:
yarn start
yarn link
Yerel bir paketi başka bir projede test etmek için sembolik bağlantılar oluşturur. Geliştirme aşamasındaki kütüphaneleri ana projenize bağlamak için kullanışlıdır.
- Kütüphane projesinde:
yarn link - Ana projede:
yarn link [kütüphane_adı] - Bağlantıyı kaldırmak için:
yarn unlink [kütüphane_adı]
yarn global add [paket_adı]
Bir paketi global olarak kurmak için kullanılır, böylece paketin CLI araçları sistemin herhangi bir yerinden erişilebilir olur (örneğin, Create React App CLI).
yarn global add create-react-app
yarn cache clean
Yarn’ın yerel önbelleğini temizlemek için kullanılır. Nadiren gerekli olsa da, önbellekle ilgili sorunlar yaşandığında faydalı olabilir.
yarn cache clean
yarn why [paket_adı]
Belirli bir paketin neden projenizde bulunduğunu (hangi bağımlılık tarafından çekildiğini) gösterir. Bağımlılık ağacını anlamak ve istenmeyen bağımlılıkları tespit etmek için çok kullanışlıdır.
yarn why lodash
package.json ve yarn.lock Dosyaları
Bu iki dosya, Yarn projelerinin temelini oluşturur:
package.json
Bu dosya, bir JavaScript projesinin kalbidir. Projenin meta verilerini (adı, versiyonu, açıklaması, lisansı vb.) ve en önemlisi, projenin bağımlılıklarını (dependencies, devDependencies, peerDependencies vb.) tanımlar. Ayrıca, projenin çalıştırılabilir komutlarını (scripts) ve diğer yapılandırma bilgilerini içerir. Yarn, bu dosyayı kullanarak hangi paketlerin kurulması gerektiğini ve hangi versiyon aralıklarında olması gerektiğini anlar.
yarn.lock
yarn.lock dosyası, Yarn’ın en önemli özelliklerinden biridir. Projenin bağımlılık ağacının tam ve deterministik bir anlık görüntüsünü (snapshot) içerir. Her bir bağımlılığın ve alt bağımlılığının tam olarak hangi versiyonunun, hangi URL’den indirildiğinin ve hangi sağlama toplamına (integrity hash) sahip olduğunun kaydını tutar. Bu dosya sayesinde, aynı proje farklı makinelerde veya farklı zamanlarda kurulduğunda her zaman aynı bağımlılık setine sahip olur. Bu, “benim makinemde çalışıyor” sorununu ortadan kaldırır ve CI/CD süreçlerinde tutarlılık sağlar. yarn.lock dosyası her zaman versiyon kontrol sistemine (git gibi) dahil edilmelidir.
Yarn Workspaces (Çalışma Alanları)
Yarn Workspaces, monorepo mimarileri için tasarlanmış güçlü bir özelliktir. Monorepo, birden fazla projenin veya paketin tek bir Git deposunda birlikte barındırıldığı bir geliştirme stratejisidir. Örneğin, bir frontend uygulaması, bir backend API’si ve ortak kullanılan bir UI kütüphanesi gibi farklı alt projeler tek bir depoda yönetilebilir.
Yarn Workspaces Ne İşe Yarar?
- Merkezi Bağımlılık Yönetimi: Tüm alt projelerin bağımlılıkları tek bir
node_modulesdizini altında yönetilebilir (Yarn Berry ile bu durum değişebilir, PnP modu ilenode_modulestamamen ortadan kalkabilir). Bu, disk alanından tasarruf sağlar ve bağımlılık çakışmalarını azaltır. - Yerel Paket Bağlantısı: Alt projeler birbirlerini doğrudan bağımlılık olarak kullanabilir. Örneğin, bir UI kütüphanesi projesi, ana frontend uygulaması tarafından doğrudan referans alınabilir. Yarn, bu yerel bağlantıları otomatik olarak yönetir, böylece geliştiricilerin
yarn linkgibi manuel komutlarla uğraşmasına gerek kalmaz. - Tek Komutla Kurulum: Ana depoda
yarn installçalıştırıldığında, tüm alt projelerin bağımlılıkları tek seferde kurulur. - Tutarlılık: Tüm alt projeler aynı bağımlılık versiyonlarını kullanmaya teşvik edilir, bu da tutarlılığı artırır ve beklenmedik hataları azaltır.
Yarn Workspaces Nasıl Yapılandırılır?
Workspaces özelliğini etkinleştirmek için, ana (root) package.json dosyanıza bir "workspaces" alanı eklemeniz gerekir. Bu alan, alt projelerin dizinlerini belirten bir dizi glob deseni alır:
// package.json (root)
{
"name": "my-monorepo",
"version": "1.0.0",
"private": true, // Monorepo'nun kendisi yayımlanmayacağı için true olarak ayarlanır
"workspaces": [
"packages/*",
"apps/*"
]
}
Bu yapılandırma, packages/ dizini altındaki tüm alt dizinleri ve apps/ dizini altındaki tüm alt dizinleri birer çalışma alanı olarak tanımlar. Her bir çalışma alanının kendi package.json dosyası olmalıdır.
Örnek bir alt proje package.json dosyası:
// packages/my-ui-library/package.json
{
"name": "@my-monorepo/ui-library",
"version": "1.0.0",
"main": "src/index.js",
"dependencies": {
"react": "^18.0.0"
}
}
Ana uygulamada bu kütüphaneyi kullanmak için:
// apps/my-frontend-app/package.json
{
"name": "@my-monorepo/frontend-app",
"version": "1.0.0",
"dependencies": {
"react": "^18.0.0",
"@my-monorepo/ui-library": "workspace:^" // Yerel workspace'i referans alma
}
}
"workspace:^" veya "workspace:*" gibi protokoller, Yarn’a bu bağımlılığın aynı monorepo içindeki bir çalışma alanı olduğunu belirtir. Bu sayede, my-frontend-app projesi, my-ui-library‘nin yerel versiyonunu kullanır ve değişiklikler anında yansır.
Yarn Plug’inleri ve Gelişmiş Özellikler (Yarn Berry)
Yarn’ın evrimi, özellikle Yarn 2 (daha sonra 3 ve 4 olarak devam eden) ile büyük bir dönüşüm yaşadı. Bu versiyonlar genellikle “Yarn Berry” olarak anılır ve bir dizi devrim niteliğinde özellik sunar:
Plug’n’Play (PnP)
Yarn Berry’nin en dikkat çekici özelliği Plug’n’Play (PnP) mimarisidir. Geleneksel olarak, Node.js projeleri bağımlılıklarını node_modules dizininde saklar. Bu dizin, derin iç içe geçmiş yapısıyla karmaşık ve disk alanını tüketen bir hale gelebilir. PnP, node_modules dizinini tamamen ortadan kaldırır. Bunun yerine, Yarn, .pnp.cjs (veya .pnp.js) adında tek bir dosya oluşturur. Bu dosya, Node.js’e her bir paketin disk üzerindeki konumunu ve bağımlılıklarını nasıl çözmesi gerektiğini tam olarak söyler.
PnP’nin avantajları:
- Daha Hızlı Kurulum:
node_modulesoluşturma ve yönetme yükü ortadan kalktığı için kurulum süreleri kısalır. - Daha Az Disk Alanı: Binlerce dosya ve dizin yerine tek bir dosya ve sıkıştırılmış paketler sayesinde disk alanı tasarrufu sağlanır.
- Daha Hızlı Başlangıç Süresi: Node.js’in bağımlılıkları çözümleme süresi önemli ölçüde azalır.
- Daha Deterministik: Bağımlılık çözümlemesi daha katı ve öngörülebilirdir.
PnP’nin bir dezavantajı, bazı araçların (IDE’ler, linter’lar vb.) PnP modunu doğrudan desteklemesi için ek yapılandırma veya eklentilere ihtiyaç duymasıdır. Ancak Yarn, bu entegrasyonları kolaylaştırmak için çeşitli eklentiler ve araçlar sunar.
Zero-Installs
PnP ile birlikte gelen bir diğer harika özellik de Zero-Installs’dır. Bu özellik sayesinde, projenizin bağımlılıkları .yarn/cache dizininde sıkıştırılmış zip dosyaları olarak saklanır. Bu dizin, yarn.lock dosyasıyla birlikte versiyon kontrol sistemine (Git) dahil edilebilir. Bunun anlamı şudur: Projeyi klonladığınızda, tüm bağımlılıklar zaten depoda olduğu için yarn install komutunu çalıştırmanıza bile gerek kalmaz (veya çok hızlı bir işlem olur). Bu, özellikle CI/CD ortamlarında ve yeni bir geliştiricinin projeye başlamasında kurulum süresini sıfıra indirir.
Protokoller
Yarn Berry, bağımlılıkların nasıl çözüleceğini veya nereden alınacağını belirten çeşitli protokoller sunar:
npm:Varsayılan npm kayıt defterinden paketleri getirir.workspace:Monorepo içindeki yerel çalışma alanlarına işaret eder (yukarıda bahsedildiği gibi).portal:Yerel diskteki bir dizine veya symlink’e işaret eder. Geliştirme aşamasındaki paketleri test etmek için kullanışlıdır.patch:Bir paketi yamalamak için kullanılır, böylece paketin kaynak kodunda değişiklik yapmadan davranışını özelleştirebilirsiniz.git:Git depolarından paketleri doğrudan çekmek için kullanılır.
Eklentiler (Plugins)
Yarn Berry, çekirdek işlevselliğini genişletmek için güçlü bir eklenti sistemi kullanır. Çoğu “ekstra” özellik aslında bir eklenti olarak gelir. Bazı popüler eklentiler:
@yarnpkg/plugin-typescript: TypeScript projeleri için gelişmiş destek sağlar.@yarnpkg/plugin-dlx: Tek seferlik komutları çalıştırmak içinyarn dlxkomutunu ekler (npm’dekinpxbenzeri).@yarnpkg/plugin-version: Sürüm yönetimi ve değişiklik günlüğü (changelog) oluşturma yetenekleri ekler.@yarnpkg/plugin-interactive-tools: Gelişmiş, etkileşimli CLI araçları sağlar.
Eklentiler, projenizin .yarnrc.yml dosyasında yapılandırılır ve yarn plugin import [plugin_adı] komutuyla kolayca eklenebilir.
npm vs. Yarn: Kısa Bir Karşılaştırma
Yarn, npm’in eksikliklerini gidermek için ortaya çıkmış olsa da, npm de yıllar içinde önemli ölçüde gelişti. Günümüzdeki npm (versiyon 7 ve üzeri) ve Yarn (Berry) arasındaki farklar, ilk versiyonlardaki kadar büyük değildir. Her iki paket yöneticisi de hızlı, güvenli ve deterministik bağımlılık yönetimi sunar.
- Hız: Her ikisi de modern versiyonlarında oldukça hızlıdır. Yarn Berry’nin PnP ve Zero-Installs özellikleri, özellikle büyük projelerde veya CI/CD’de hala bir miktar avantaj sağlayabilir.
- Determinizm: Her ikisi de kilit dosyaları (
yarn.lockvepackage-lock.json) kullanarak deterministik kurulum sağlar. - Monorepo Desteği: Yarn Workspaces bu alanda uzun süredir liderdi, ancak npm de
npm workspacesözelliği ile benzer yetenekler sunar. - Ekosistem: npm hala daha geniş bir kullanıcı tabanına ve daha eski, daha yaygın araç entegrasyonlarına sahiptir. Yarn Berry’nin PnP modu, bazı eski araçlarla uyumluluk sorunları yaşayabilir (ancak bu sorunlar giderek azalmaktadır).
- Gelişmiş Özellikler: Yarn Berry’nin PnP, Zero-Installs ve güçlü eklenti sistemi, özellikle büyük ve karmaşık projeler için benzersiz avantajlar sunar.
Sonuç olarak, her iki araç da mükemmeldir ve seçim genellikle kişisel tercihlere, proje gereksinimlerine ve geliştirme ekibinin alışkanlıklarına bağlıdır. Ancak Yarn, özellikle monorepo’lar, performans odaklı projeler ve en yeni bağımlılık yönetimi özelliklerini kullanmak isteyenler için güçlü bir alternatiftir.
Sonuç ve Gelecek
Yarn, JavaScript ekosistemindeki bağımlılık yönetimi araçlarının gelişiminde önemli bir dönüm noktası olmuştur. Hızı, güvenilirliği ve deterministik yaklaşımıyla geliştiricilerin hayatını kolaylaştırmış, özellikle büyük ölçekli projelerde ve monorepo’larda verimliliği artırmıştır. Yarn Berry ile gelen PnP, Zero-Installs ve eklenti sistemi gibi yenilikler, paket yönetimini daha da ileriye taşımış, performans ve disk alanı kullanımı konusunda yeni standartlar belirlemiştir.
Gelecekte, JavaScript projelerinin karmaşıklığı artmaya devam ettikçe, Yarn gibi gelişmiş paket yöneticilerinin rolü daha da önem kazanacaktır. Sürekli yenilikler ve topluluk desteği sayesinde Yarn, modern web geliştirme süreçlerinin vazgeçilmez bir parçası olmaya devam edecektir. Geliştiricilerin, projelerinin ihtiyaçlarına en uygun paket yöneticisini seçerken Yarn’ın sunduğu güçlü özellikleri göz önünde bulundurması, daha verimli ve sorunsuz bir geliştirme deneyimi sağlayacaktır.
