Visual Studio

Visual Studio’da Build Numaralandırma Formatını Değiştirme

.NET uygulaması yönetirken, geliştiricilerin sıkça karşılaştığı teknik zorluklardan biri yazılımlarının versiyonlamasıdır. Kullanıcı dostu bir versiyonlama sistemi, kullanıcıların hata veya sorun bildirdiklerinde iletişimde oldukça önemlidir. Bu kılavuz, Visual Studio’daki versiyon numarası formatını değiştirmek için gereken adımları tanıtacak ve süreci daha basit ve öz hâle getirmenize yardımcı olacaktır.

Sorun

Bir .NET uygulamasını devraldınız ve bu uygulama her build ile birlikte versiyon numarasını otomatik olarak güncelliyor. Otomasyon genellikle faydalıdır, ancak mevcut versiyonlama formatı arzu edilenin altında kalabilir. Örneğin, 3.5.3167.26981 gibi bir versiyon dizesi, kullanıcıların hata ayıklarken referans vermesi açısından oldukça zorlayıcı olabilir.

İstenilen Format

Amacınız, versiyonlama sürecini sadeleştirmektir. Kullanıcıların iletişim kurmasının daha kolay olacağı bir format istiyorsunuz, örneğin 3.5 (build 3198), burada:

  • Ana ve alt versiyonlar manuel olarak güncellenir.
  • Build numarası otomatik olarak artar.
  • Artış, yalnızca RELEASE build sürecinde gerçekleşir.

Çözüm

Adım 1: Proje Dosyanızı Bulun

Değiştirmek istediğiniz versiyon numarası genellikle AssemblyInfo.cs adlı bir proje dosyasında yapılandırılmıştır. Bu dosyada, aşağıdaki gibi görünen assembly versiyon özniteliğini arıyorsunuz:

[assembly: AssemblyVersion("3.5.*")]

* karakteri, Visual Studio’ya build ve revizyon numaralarını otomatik olarak ataması talimatını verir.

Adım 2: Versiyon Numarasını Sabitleyin

Versiyonlama formatınızı özelleştirmek için, otomatik versiyonlamayı istenen formatınıza uygun olan sabit bir dize ile değiştirin:

[assembly: AssemblyVersion("3.5.3198.0")]

Versiyon formatının bir dökümünü aşağıda bulabilirsiniz:

  • Ana versiyon: 3
  • Alt versiyon: 5
  • Build numarası: 3198 (Bu otomatik olarak oluşturulacak)
  • Revizyon: Bunu 0 olarak veya tercihinize göre başka bir numara ile ayarlayabilirsiniz.

Adım 3: Hata Ayıklama ve Yayınlama Builds için Özelleştirin

Build numarasının yalnızca bir yaygın build sırasında artmasını sağlamak için, derleyici ön işleme direktiflerini kullanabilirsiniz. Burada işler biraz daha ilerlemiş hale geliyor, ancak bu, güçlü bir araçtır.

AssemblyInfo.cs dosyasına şu koşullu kodu yazabilirsiniz:

#if DEBUG
[assembly: AssemblyVersion("3.5.0.0")]
#else
[assembly: AssemblyVersion("3.5.*")]
#endif

Bu ayar şunları garanti eder:

  • DEBUG build sırasında versiyon sabit kalır.
  • RELEASE build sırasında versiyon numarası build sistemine göre güncellenir.

Sonuç

Visual Studio’da build numaralandırma formatını değiştirmek, kullanıcı deneyimini önemli ölçüde iyileştirebilecek basit bir süreçtir. Bu adımları takip ederek, kullanıcıların iletişim kurmasını kolaylaştıran ve geliştirme sürecinizle daha iyi uyumlu bir versiyonlama yapısı oluşturabilirsiniz.

Versiyonlama stratejinizi özelleştirerek, kullanıcılarınıza sorunları etkin bir şekilde raporlama imkanı tanır ve dolayısıyla geliştiriciler ile kullanıcılar arasında iletişimi geliştirirsiniz.

İyi kodlamalar!