Bir eklenti neden 2025'te çalışıp 2022'de çalışmaz?

Bir eklenti satın alıyorsunuz, kuruyorsunuz, SketchUp'ı yeniden başlatıyorsunuz — ama araç çubuğu hiç görünmüyor. Ya da görünüyor, tıklıyorsunuz ve Ruby Konsolu kırmızı bir satırla beklenmedik bir argüman hatası veriyor. Aynı .rbz dosyası, aynı projede, iş arkadaşınızın bilgisayarında tıkır tıkır çalışıyor.

Kimse size yalan söylemedi, dosya da bozuk değil. SketchUp 2021 ile 2026 arasında bütün eklenti sisteminin altındaki Ruby motoru kuşak değiştirdi. Bir sürümde tamamen geçerli olan kod, başka bir sürümde sözdizimi hatası veriyor — üstelik çoğu zaman hiç ses çıkarmadan.

Bu yazı pratik bir harita: sürümler arasında gerçekte ne değişiyor, .rbz kurulumu perde arkasında nasıl çalışıyor, eklentiler diskte tam olarak nerede duruyor ve para harcamadan önce hangi kısa listeyi kontrol etmelisiniz.

Değişen tek şey değil, üç şey var

Çoğu kişi "SketchUp sürümü"nü tek bir sayı sanır. Oysa bir eklenti için bu üç ayrı sistem demektir ve eklenti üçünden herhangi birinde takılabilir. Üç durumda da belirti aynıdır: hiçbir şey olmaz.

• Ruby yorumlayıcısı — SketchUp 2021 ve 2022 Ruby 2.7 kullanır. SketchUp 2023 Ruby 3.1'e, 2024 Ruby 3.2'ye geçti; 2025 ve 2026 da 3.x hattında devam ediyor.
• SketchUp Ruby API'si — neredeyse her sürümle yeni sınıflar ve metotlar geliyor. Örneğin Overlays (bindirme) API'si yalnızca SketchUp 2023 ve sonrasında var.
• Gömülü tarayıcı — modern eklenti panelleri HtmlDialog pencereleridir, yani Chromium'dur. SketchUp 2021'in içindeki Chromium sürümü, 2026'nınkinden yıllarca eski.

1. Ruby 2.7'den 3.x'e: anahtar argüman ayrımı

Bu dönemin en büyük kırılması bu. Ruby 2.7'de, anahtar argüman bekleyen bir metoda düz bir hash verebiliyordunuz; Ruby bunu sessizce dönüştürüyordu. Ruby 3.0 bunu yapmayı bıraktı. Sağlıklı görünen çok sayıda eklenti kodu, yeni bir SketchUp ile karşılaştığı gün ArgumentError'a dönüştü. Ruby 3 ayrıca yıllardır kullanımdan kaldırılmış şeyleri tamamen tasfiye etti — URI.escape yok, Object#taint artık hiçbir şey yapmıyor — ve standart kütüphanenin bir kısmını varsayılan setin dışına taşıdı. Artık pakete dahil olmayan bir kütüphaneyi sessizce çağıran bir eklenti, 2022'de mutlu mesut yüklenir, 2024'te ölür.

Ters yön de en az o kadar can yakıyor. Ruby 3 için yazılmış bir kod — yeni desen eşleme biçimleri, kısaltılmış hash sözdizimi — 2024'te sorunsuz okunur, 2022'de sözdizimi hatası verir. En kötü hata türü budur, çünkü dosya hiç yüklenmez. Araç çubuğu yok, menü yok, mesaj yok. Eklenti orada değildir, o kadar.

2. Henüz var olmayan API çağrıları

SketchUp Ruby API'si her yıl büyüyor. Overlays, SketchUp 2023 ile geldi ve eklentilere modelin üzerine temiz biçimde çizim yapma imkânı verdi. Sketchup::Overlay çağıran bir eklenti, yazarı önce sürüm kontrolü yapıp bir yedek yol bırakmadıysa 2021 ve 2022'de NameError verir. İyi yazılmış eklentiler Sketchup.version_number ile dallanır ve zarifçe geri çekilir. Aceleye gelmiş olanlar en yeni sürümü varsayar, sorunu keşfetmeyi kullanıcıya bırakır.

3. Panel bir tarayıcıdır ve eski SketchUp'ta eski bir tarayıcıdır

Modern eklenti arayüzlerinin neredeyse tamamı HtmlDialog'dur: o SketchUp sürümünün içindeki Chromium tarafından render edilen HTML, CSS ve JavaScript. Opsiyonel zincirleme, CSS :has() seçicisi, container query'ler, structuredClone — hepsi güncel bir Chromium'da gayet iyi çalışır, eskisinde ölümcül olabilir. SketchUp 2026'da geliştirilen bir panel, 2021'de bomboş açılabilir ve Ruby Konsolunda tek satır hata çıkmaz; çünkü JavaScript tek bir piksel çizmeden durmuştur. "2021-2026" iddiasının teknik olarak doğru ama 2021'de pratikte işe yaramaz olmasının en yaygın sebebi budur.

"2021-2026" rozeti gerçekte ne anlama gelmeli?

Geliştiricinin eklentiyi bu sürümlerin her birine kurup çalıştırdığı anlamına gelmeli. Bunun mümkün olup olmadığını anlamanın iyi bir yapısal göstergesi var: saf Ruby, derlenmiş ikili dosya yok. Derlenmiş bir C eklentisi tek bir Ruby ABI'sine göre derlenir; 2.7 için üretilmiş bir ikili dosya 3.2'ye hiç yüklenmez. Altı sürümü iki işletim sisteminde karşılamak için üreticinin bir ikili dosya matrisi taşıması gerekir. Saf Ruby eklentilerinde bu hata yüzeyi hiç yoktur.

Bir de şu var: dar ama net bir aralık, muğlak bir ifadeden çok daha iyi bir işarettir. Kendi kataloğumuzda WindowFun Studio ve Dynamic Skirting SketchUp 2024-2026 der ve orada durur. FloorStudio, Kapı Stüdyosu ve PerdeNeşe Studio ise 2021'den 2026'ya kadar her sürümü tek tek sayar. İkisi de işinize yarar. "SketchUp'ın son sürümleriyle uyumludur" ise hiçbir şey söylemez.

RBZ kurulumu aslında nasıl çalışır?

.rbz dosyası, adı değiştirilmiş bir .zip'tir; herhangi bir arşiv programıyla açıp içine bakabilirsiniz. Alışılmış yapı şudur: en üstte tek bir yükleyici .rb dosyası, yanında aynı adı taşıyan ve geri kalan her şeyi barındıran bir klasör. Yükleyici dosya bir SketchupExtension nesnesi kaydeder; böylece Uzantı Yöneticisi eklentiyi listeleyebilir, açıp kapatabilir. Kurulum ise bu ikisini tek bir SketchUp sürümünün Plugins klasörüne açmaktan ibarettir.

• Pencere > Uzantı Yöneticisi > Uzantı Yükle yolunu izleyin ve .rbz dosyasını seçin.
• Dosyanın nereden geldiğini biliyorsanız güven uyarısını onaylayın.
• SketchUp'ı yeniden başlatın. Her zaman şart değildir ama her zaman daha güvenlidir.
• Araç çubuğu yok mu? Windows'ta Görünüm > Araç Çubukları, macOS'te Görünüm > Araç Paletleri'ne bakın; eklenti yüklenmiş ama çubuğu gizli olabilir.
• Yine yok mu? Yeniden başlatmadan önce Ruby Konsolunu açın; yükleme hataları SketchUp açılırken oraya yazılır.

Eklentiler diskte tam olarak nerede durur?

Her SketchUp yılının kendi Plugins klasörü vardır. Sürüm yükselttikten sonra yaşanan "eklentilerim kayboldu" panik anlarının çoğunu tek başına bu gerçek açıklar.

• Windows: %AppData%\SketchUp\SketchUp 2026\SketchUp\Plugins
• macOS: ~/Library/Application Support/SketchUp 2026/SketchUp/Plugins
• Yıl kısmını baktığınız sürümle değiştirin. SketchUp 2025 ile 2026 hiçbir şeyi paylaşmaz — ne eklentileri ne de ayarlarını.

Yani eklentileriniz kaybolmadı; hâlâ geçen yılın klasöründe duruyorlar. Temiz çözüm, orijinal .rbz dosyasını yeni yıla yeniden kurmaktır. Klasörü elle kopyalamak genelde işe yarar ama güven ve imza adımını atlar, üstelik eski dosyaları da beraberinde taşır.

İmzalar ve sessizce yüklenmeme durumu

Uzantı Yöneticisi'nde üç kademeli bir yükleme politikası vardır: kısıtlamasız; tanımlanamayan uzantıları tek tek onaylatan; ve yalnızca dijital imzalı olanları kabul eden kademe. Katı ayarda imzasız bir .rbz kurulur ama yüklenmez ve SketchUp bunu pek yüksek sesle söylemez. Eklenti listede görünüyor ama menü ya da araç çubuğu hiç gelmiyorsa, destek ekibine yazmadan önce Yönet sekmesinden politikayı kontrol edin.

Model el değiştirdiğinde neler hayatta kalır?

Bir eklentinin ürettiği geometri, sıradan SketchUp geometrisidir — yüzeyler, kenarlar, gruplar, bileşenler. Eklentiye sahip olmayan biri de modeli açabilir. Parametrik araçlar ayrıca ayarlarını grubun ya da bileşenin üzerindeki attribute dictionary'lerde tutar; bunlar da .skp dosyasının içinde birlikte gider. Yani farklı sürümdeki bir meslektaşınız zemini, kapıyı ve perdeyi modellendiği gibi görür. Sadece eklenti kurulu olmadan parametreleri açıp değiştiremez.

Asıl tek yönlü yol .skp dosyasının kendisidir. 2026'da kaydedilmiş bir model 2021'de açılmaz. İşi daha eski sürüm kullanan bir ofise devredecekseniz Dosya > Farklı Kaydet ile eski SketchUp biçimini bilerek seçin — biri arayıp söyleyene kadar unutulması çok kolaydır.

Satın almadan önce bakılacak altı şey

• Ürün sayfası tam olarak sizin SketchUp yılınızı yazıyor. "Yeni sürümler" değil, "en son sürüm" değil.
• İşletim sisteminiz de yazıyor. Derlenmiş kod içeren her şey Windows'ta ve macOS'te ayrı bir yapıdır.
• Deneme sürümü var ya da kurup panelini kendi elinizle açmanıza yetecek bir iade süresi var.
• Arayüz sizin sürümünüzde gerçekten çiziliyor — ilkini değil, bütün pencereleri birer kez açın.
• Üretici, gelecek yılki sürüm yükseltmesinde ne olacağını söylüyor: .rbz'den yeniden kurulum ve lisansın taşınıp taşınmadığı.
• Mesajlara cevap veren biri var. Altı SketchUp sürümüyle uyum, dosyanın doğuştan sahip olduğu bir özellik değil, sürekli yapılan bir bakım işidir.

Bunların hiçbiri egzotik şeyler değil. Bir detay kütüphanesini içe aktarmadan önce milimetre mi diye bakmakla aynı disiplin. SketchUp 2027 çıkacak, Ruby yine yer değiştirecek ve hayatta kalan eklentiler, yazarlarının altı sürüme kurup düğmelerine gerçekten bastığı eklentiler olacak.