SDK API ve V-Ray sürümleri #
Uygulama SDK’sı, (çoğunlukla) render motorundan bağımsız olarak geliştirilen daha üst düzey bir API katmanı olduğundan, kendi API sürümüne sahiptir. Örneğin, şu anda 4.x sürümündeyken, V-Ray çekirdeği 6.x sürümündedir. Uygulama SDK’sındaki büyük değişikliklerin V-Ray’in ana sürümüyle mutlaka bağlantılı olmayabileceği ve bunun tersinin de geçerli olabileceği için aynı ana sürüm numarasını kullanmak istemedik.
Başka bir deyişle, Uygulama SDK API sürümü API’nin evrimini yansıtırken, V-Ray sürümü (ürün sürümü) ise render motorunun kendisinin evrimini yansıtır.
Hem API sürümü hem de V-Ray sürümü, aşağıda açıklanan bazı özel ayrıntılarla birlikte, anlamsal sürümleme için XYZ veya Major.Minor.Patch şeklinde üç sayıdan oluşmaktadır.
Semantik sürüm şeması #
-
API’de büyük ve uyumsuz değişiklikler yapıldığında ana sürüm numarası artabilir. V-Ray için ana sürüm numarası, büyük ürün sürümlerini yansıtır ve yeni lisanslar gerektirir.
-
Yeni özelliklerin eklenmesiyle birlikte küçük sürüm numarası artar ve geriye dönük API uyumluluğunu korumalıdır.
-
Buradaki sayı birer birer artar; tek sayılar ara gece derleme sürümleri için, çift sayılar ise kararlı sürümler için kullanılır.
-
Örneğin, 1.04.xx kararlı bir sürümdür, bir sonraki kararlı sürüm 1.06.xx olur ve bunların arasındaki tüm gece sürümleri 1.05.xx’tir.
-
-
Yama sürümü, kararlı sürümlerdeki hataları düzelten içeriklerle güncellendi.
Uygulama SDK’sının kararlı sürümleri, çekirdeğin kararlı bir sürümünü içerir ve Uygulama SDK’sının gece sürümleri, gece sürümünün çekirdeğini kullanır.
Programatik erişim #
Çalışma zamanında API sürümünü ve V-Ray render çekirdeğini sorgulamak için modül düzeyinde çeşitli işlevler mevcuttur:
-
getAPIVersion() – Uygulama SDK API’sinin Major, Minor ve Patch sürüm numaralarını dile bağlı bir biçimde döndürür.
-
getVRayVersion() – V-Ray’in ana, alt ve yama sürüm numaralarını dile bağlı bir biçimde döndürür.
-
getVRayVersionDetails() – V-Ray sürümünü ve ek ayrıntıları (git hash ve derleme zamanı) içeren bir dize döndürür. Bunlar çoğunlukla gece derlemelerinde ve DLL’lerin yanlış konumdan yüklenmesi gibi sorunların hata ayıklamasında kullanışlıdır.
Bu fonksiyonlar Globals sınıfında yer alır ve .Net’te isimleri büyük harfle başlar.
