Sürüm (Versiyon) Nedir? Sürümleme Nasıl Okunur?

Sürüm numarası yazılım hakkında hangi bilgiyi verir?

Sürüm, bir yazılımın belirli bir gelişim anındaki tanımlayıcısıdır. Aynı uygulamanın farklı tarihlerdeki durumlarını birbirinden ayırır. Örneğin v2.23.10 ile v2.23.11 aynı ürünün farklı sürümleridir; aradaki değişikliğin ne olduğu ise yalnızca numaradan değil, sürüm notlarından öğrenilir.

Sürüm numarasının temel işlevi kimliklendirmedir. Kullanıcı destek ekibine sorun bildirirken kullandığı sürümü söyler. Geliştirici, hatanın hangi sürümde ortaya çıktığını veya düzeltildiğini araştırır. Projede görev alan ekipler de kaynak kodunun, belgelerin ve test sonuçlarının hangi sürüme ait olduğunu ayırabilir.

Burada önemli sınır şudur: Sürüm numarası değişikliğin niteliği hakkında bir işaret verebilir, fakat tek başına ayrıntılı değişiklik listesi değildir. Örneğin son basamakta artış görülmesi genellikle küçük düzeltmelerle ilişkilendirilir; bu, o sürümde güvenlik düzeltmesi bulunduğunu kanıtlamaz. Güvenlik, performans veya özellik değişikliği için sürüm notlarına bakılmalıdır.

Sürüm ile güncelleme de aynı kavram değildir. Sürüm, ortaya çıkan yazılım durumunun adıdır; güncelleme ise mevcut yazılımdan başka bir sürüme geçiş işlemidir. Bir uygulamanın v2.23.10'dan v2.23.11'e taşınması güncellemedir; v2.23.11 ise güncelleme sonunda kullanılan sürümdür.

v3.2.1 ifadesindeki üç basamak nasıl okunur?

Yaygın bir yaklaşım, sürüm numarasını $major.minor.patch$ biçiminde göstermektir. Buna göre v3.2.1 şu şekilde okunur:

• Major (ana sürüm) = 3: Ana sürüm artışı, kullanılan politika semantik sürümlemeyse geriye dönük uyumluluğu bozabilecek değişikliklere işaret eder. Sürüm numarası, değişikliğin kapsamını veya tasarım yeniliklerini tek başına kanıtlamaz. Ancak her ekip, ana sürüm artışını aynı kuralla uygulamaz.
• Minor (küçük sürüm) = 2: Minor sürüm artışı, ilgili politika semantik sürümlemeyse geriye dönük uyumlu yeni işlevlerin veya özelliklerin eklendiğine işaret eder. Değişikliğin kapsamı ve ayrıntıları sürüm notlarından doğrulanmalıdır. Buradaki 'uyumluluğu koruma' yorumu, kullanılan sürümleme politikasına bağlıdır; yalnızca sayıya bakılarak garanti kabul edilmemelidir.
• Patch (yama) = 1: Hata düzeltmeleri, güvenlik yamaları veya küçük performans iyileştirmeleri için kullanılan basamak olabilir. Yama sürümü kullanıcı arayüzünü değiştirmeyebilir; fakat güvenlik düzeltmesi gibi kullanıcı açısından önemli bir değişiklik içerebilir.

Bu sıranın karar kuralı, basamakların kendisinden çok artış yönünde görülür. v3.2.1'den v3.2.2'ye geçişte yalnızca patch değeri artıyorsa değişikliğin daha sınırlı olması beklenir. v3.2.1'den v3.3.0'a geçiş, çoğunlukla yeni özelliklerin bulunduğu bir minor değişikliği anlatır. v3.2.1'den v4.0.0'a geçiş ise daha kapsamlı ve uyumluluk açısından incelenmesi gereken bir değişim sinyalidir.

Bu yorumlama, ana.küçük.yama düzenini kullanan projeler için geçerlidir. Bir ürünün kendi belgelerinde farklı anlamlar tanımlanmışsa o belge önceliklidir. Ayrıca sürüm numarasının başında yer alan 'v' harfi çoğu kullanımda yalnızca 'version' kısaltmasıdır; v3.2.1 ile 3.2.1 arasında bu açıdan anlam farkı olmayabilir.

Uyumluluk kararı yalnızca ana numaraya bakılarak verilir mi?

Hayır. Ana sürüm numarası, geriye dönük uyumluluk açısından incelenmesi gereken bir işaret olabilir; fakat tek başına uyumluluğu kanıtlamaz veya bozmaz. Uyumluluk, yazılımın işletim sistemi, cihaz, eklenti, veri biçimi ve diğer uygulamalarla birlikte çalışabilmesini ifade eder.

Örneğin v2.23.10'dan v2.23.11'e geçiş küçük göründüğü için riskin düşük olduğu düşünülebilir. Yine de yeni sürüm, belirli bir işletim sistemi sürümünü gerektirebilir veya bir hata düzeltmesi başka bir bileşenle etkileşebilir. Tersine, v3.0.0 gibi ana sürüm değişikliği önemli bir yeniden tasarım içerebilir; fakat geliştirici geriye dönük uyumluluğu korumayı tercih etmiş de olabilir.

Güncelleme öncesi izlenecek pratik sıra şöyledir:

1. Mevcut sürümü uygulamanın ayarlar veya hakkında bölümünden belirleyin.
2. Yeni sürüm numarasını ve sürüm notlarını karşılaştırın.
3. İşletim sistemi, cihaz ve bağlı eklentiler için gereksinimleri okuyun.
4. Verilerin yedeklenmesi gerekip gerekmediğini kontrol edin.
5. Özellikle ana sürüm değişiminde, kullandığınız kritik işlevlerin yeni sürümde çalıştığını doğrulayın.

Bu adımların amacı, 'büyük numara artmışsa uyumsuzdur' veya 'son basamak artmışsa risksizdir' gibi aşırı genellemelerden kaçınmaktır. Sürüm numarası hızlı bir ön değerlendirme sağlar; nihai karar için sürüm notu ve uyumluluk belgeleri gerekir.

Bir hata bildirirken sürüm numarası neden kritik olur?

Aynı uygulamanın farklı sürümlerinde farklı hata davranışları görülebilir. Kullanıcının yalnızca 'uygulama çalışmıyor' demesi, sorunu yeniden üretmek için yetersiz kalabilir. Sürüm numarası, hata kaydına önemli bir bağlam ekler.

İyi bir hata bildiriminde en azından kullanılan sürüm, cihaz veya işletim sistemi, hatayı oluşturma adımları, beklenen davranış ve gerçekleşen davranış yer almalıdır. Örneğin 'v2.23.10 sürümünde giriş düğmesine bastığımda uygulama kapanıyor; v2.23.11'e güncelledikten sonra sorun devam ediyor' ifadesi, iki sürüm arasındaki durumu karşılaştırma olanağı verir.

Geliştirici açısından sürüm numarası şu soruların yanıtlanmasına yardım eder: Hata hangi sürümde başladı? Daha önce çalışıyor muydu? Yeni sürümde düzeltildi mi? Sorun yalnızca belirli bir sürümde mi görülüyor? Bu araştırma, bug kayıtlarını sınıflandırmayı ve debug sürecini daraltmayı kolaylaştırır.

Ancak sürüm numarası hata nedeninin kendisi değildir. Aynı sürümde farklı cihazlarda farklı sonuçlar alınabilir. Ağ bağlantısı, işletim sistemi, kullanıcı ayarı veya dış hizmetler de etkili olabilir. Bu nedenle sürüm bilgisini hata adımları ve ortam bilgileriyle birlikte vermek gerekir.

Çözümlü örnekler: numara artışından hangi sonuç çıkarılır?

Örnek 1: Üç basamaklı sürümleri karşılaştırma

Verilenler: Bir uygulamanın mevcut sürümü v3.2.1, mağazada bulunan yeni sürümü v3.2.2 olarak gösteriliyor. Proje ana.küçük.yama yaklaşımını kullanıyor.

Çözüm adımları:

1. Major basamaklarını karşılaştırın: 3 ve 3. Ana sürüm değişmemiştir.
2. Minor basamaklarını karşılaştırın: 2 ve 2. Yeni bir küçük sürüm seviyesine geçilmemiştir.
3. Patch basamaklarını karşılaştırın: 1'den 2'ye çıkılmıştır.
4. Bu politika altında değişiklik, öncelikle hata düzeltmesi, güvenlik yaması veya küçük iyileştirme beklentisi oluşturur.
5. Bununla birlikte güvenlik düzeltmesi olduğunu kesinleştirmek için sürüm notunu okuyun.

Sonuç: v3.2.2, v3.2.1'e göre patch düzeyinde bir değişiklik sinyalidir. Numara, değişikliğin küçük sınıfta olduğunu düşündürür; hangi hatanın düzeltildiğini tek başına açıklamaz.

Örnek 2: Ana sürüm değişikliğini değerlendirme

Verilenler: Bir yazılım v3.2.1'den v4.0.0'a yükseltiliyor. Yazılımın kaynak koduna bağlanan bir eklenti kullanılıyor.

Çözüm adımları:

1. Major değeri 3'ten 4'e çıkmıştır; bu, kapsamlı değişiklik veya geriye dönük uyumluluk incelemesi gerektiren bir işarettir.
2. Minor ve patch değerlerinin 0 olması, yeni sürümün başlangıç numaralandırmasıdır; 'hiç hata yok' anlamına gelmez.
3. Eklentinin v4 ile uyumlu olup olmadığı kontrol edilir.
4. Kullanılan işlevler sürüm notlarında tek tek karşılaştırılır.
5. Kritik veriler yedeklenir ve mümkünse önce deneme ortamında test yapılır.

Sonuç: v4.0.0'a geçiş, yalnızca numaraya bakılarak otomatik biçimde yapılmamalıdır. Ana sürüm değişikliği inceleme gerektiren güçlü bir sinyaldir; kesin uyumluluk kararı belgeler ve testlerle verilir.

Sık yapılan hatalar ve karıştırılan kavramlar

'En büyük sayı en iyi sürümdür' yanılgısı: Sürüm numarası kalite puanı değildir. v4.0.0, v3.2.1'den daha yeni olabilir; fakat kullanıcının ihtiyacı olan özellik, uyumluluk veya kararlılık açısından otomatik olarak daha iyi olduğu sonucu çıkarılamaz.

Her son basamak artışını önemsiz sanmak: Patch değişiklikleri küçük kapsamlı olarak adlandırılsa da güvenlik düzeltmeleri içerebilir. Bu nedenle 'arayüz değişmiyor, güncellemeye gerek yok' kararı doğru olmayabilir.

Sürüm ile güncellemeyi eş anlamlı kullanmak: Sürüm, yazılımın belirli durumunu; güncelleme, bir durumdan daha yeni duruma geçişi ifade eder.

Ana numara değişince bütün eski işlevlerin kaybolacağını düşünmek: Major artışı uyumluluk incelemesi için uyarıdır, kesin işlev kaybı kanıtı değildir.

Sürüm numarasını sürüm notu yerine kullanmak: v2.23.11 ifadesi değişikliğin ayrıntısını söylemez. Yeni özellik, hata düzeltmesi, güvenlik değişikliği ve sistem gereksinimi için yayınlanan notlar incelenmelidir.

'v1.0 her ürünün ilk gerçek sürümüdür' demek: v1.0 yaygın bir adlandırma olabilir; fakat bazı ekipler deneme veya beta aşamalarını farklı etiketlerle gösterir, bazıları ise başka bir numaralandırma kullanır. Bu nedenle ilk sürüm adı ürünün kendi politikasına göre değerlendirilmelidir.

Sürüm numarasını hata raporunda tek bilgi olarak vermek: Sorunun yeniden üretilebilmesi için cihaz, işletim sistemi, hata adımları ve beklenen sonuç da yazılmalıdır.