ANKA MÜHENDİSLİKSincan / Ankara
Yazılım Temelleri • Başlangıç

Semantik Versiyonlama nedir?

Semantic Versioning (SemVer)

Yazılım sürümlerini MAJOR.MINOR.PATCH biçiminde numaralandırarak değişikliğin türünü ve uyumluluk etkisini anlatan sürümleme kuralı.

Semantik versiyonlama (SemVer), yazılım sürüm numaralarına anlam yükleyen yaygın bir kurallar dizisidir. Sürüm numarası MAJOR.MINOR.PATCH biçimindedir; örneğin 2.5.1. Bu numaraya bakarak bir güncellemenin mevcut kodunuzu bozup bozmayacağını tahmin edebilirsiniz.

Kurallar şöyledir: geriye dönük uyumsuz (breaking) bir değişiklik yapıldığında MAJOR artırılır (2.5.1 → 3.0.0); geriye dönük uyumlu yeni bir özellik eklendiğinde MINOR artırılır (2.5.1 → 2.6.0); yalnızca geriye dönük uyumlu hata düzeltmesi yapıldığında PATCH artırılır (2.5.1 → 2.5.2). 1.0.0'dan önceki 0.y.z sürümleri ilk geliştirme aşaması sayılır ve her an değişebilir. 1.0.0-beta.1 gibi ön sürüm etiketleri de tanımlıdır.

Paket yöneticileri bu kurala dayanır. npm'de ^1.4.2 ifadesi 2.0.0'dan küçük ve 1.4.2'ye eşit veya büyük sürümleri, ~1.4.2 ise 1.5.0'dan küçük sürümleri kabul eder. Kütüphane geliştirenlerin SemVer'e uyması, onu kullananların güvenle güncelleme yapabilmesini sağlar. Git etiketleri (tag) sürümleri işaretlemek için sıkça kullanılır.

Örnek: Sürüm artırma ve Git etiketi

# Mevcut: 1.4.2
npm version patch   # 1.4.3  (hata düzeltmesi)
npm version minor   # 1.5.0  (yeni, uyumlu özellik)
npm version major   # 2.0.0  (uyumsuz değişiklik)

# npm version komutu ayrıca bir git etiketi oluşturur
git push --follow-tags

İpuçları

  • Bir API'den bir alanı kaldırmak veya adını değiştirmek MAJOR değişikliktir.
  • Her sürümde neyin değiştiğini bir CHANGELOG dosyasında belgeleyin.