# SketchUp Ruby API ile eklenti geliştirmeye başlangıç: adım adım rehber

Kaynak: https://3dsinifi.com/haber/sketchup-ruby-api-ile-eklenti-gelistirmeye-baslangic-adim · Kategori: Eğitimler · Yayın: 7 Kasım 2026

> SketchUp Ruby API, SketchUp’ın içinden çalışan eklentilerle model ve uygulamayla etkileşim kurmayı sağlıyor. Bu rehber, başlangıç gereksinimlerini, geliştirme kaynaklarını ve test seçeneklerini açıklıyor.

## Kısaca
- SketchUp Ruby API tek başına çalışmaz; SketchUp uygulamasının içinden kullanılmalıdır.
- API etkileşimlerinin beklenmedik davranışları ve kararsızlığı önlemek için ana iş parçacığında yapılması gerekir.
- TestUp, SketchUp içinde çalışan Minitest tabanlı testler ve bunları yönetmek için grafik arayüz sunar.
- LayOut Ruby API, SketchUp 2018’den itibaren LayOut belgeleri oluşturup düzenlemeye imkân tanır.

## Bu rehberde ne öğreneceksiniz?

SketchUp Ruby API, SketchUp modelleri ve uygulamasıyla etkileşim kurmak için kullanılan bir arayüz. SketchUp’ın resmi belgelendirmesine göre API, SketchUp uygulamasının içinde kullanılabiliyor; tek başına çalışan bir araç değil. Bu nedenle geliştirmeye başlarken ilk karar, otomatikleştirilmek istenen işin SketchUp içinde nasıl bir eklentiye dönüşeceğini belirlemek olmalı.

Bu rehber; API’nin sınırlarını tanımaya, uygun resmi başlangıç kaynaklarını seçmeye, IDE ve hata ayıklama hazırlığı yapmaya, ardından test sürecini kurmaya odaklanıyor. Belirli bir SketchUp sürümü için API uyumluluğu veya kurulum adımları kaynaklarda ayrıntılandırılmadığından, burada sürüm ya da menü yolu varsayılmıyor.

## Gereksinimler ve başlamadan önce

- **SketchUp:** Ruby API, SketchUp’ın içinden çalışır ve kendi başına kullanılamaz. Dolayısıyla geliştirme ve deneme sürecinde SketchUp uygulamasına ihtiyaç vardır.
- **Ruby bilgisi:** Kaynaklar API’yi Ruby üzerinden tanımlar. İleri düzey bir Ruby bilgisi şartı belirtilmiyor; ancak yazılacak eklentinin kodu Ruby kullanır.
- **Geliştirici kaynakları:** Resmî SketchUp Ruby API belgeleri, Ruby API Overview ve SketchUp Developer Center başlangıç için başvurulabilecek kaynaklar arasında.
- **IDE ve hata ayıklama:** SketchUp, Ruby Debug protokolünü destekleyen IDE ve editörlerle kullanılabilecek bir hata ayıklama arayüzü sağlıyor. RubyMine için kurulum örneği, VSCode için de proje örneği sunuluyor.
- **Test:** SketchUp içinde çalışan kodu, SketchUp dışındaki Ruby konsoluna göre tasarlanmış standart test akışlarıyla sınamak zor olabilir. TestUp bu kullanım için Minitest üzerine kurulmuş bir sarmalayıcı ve testleri yönetmeye yönelik grafik arayüz sağlıyor.

Kaynaklarda ücret, hesap gereksinimi veya tüm SketchUp sürümleri için uyumluluk tablosu açıklanmıyor. Bu nedenle proje başlamadan önce hedeflenen SketchUp sürümünün resmi API belgeleri ve örnekleri ayrıca incelenmeli.

## SketchUp Ruby API ile geliştirme adımları

### 1. Otomatikleştirilecek işi tanımlayın

Önce eklentinin hangi tekrarlı işi kolaylaştıracağını netleştirin. SketchUp’ın geliştirici merkezi, eklentilerin iş akışlarını otomatikleştirebileceğini ve harici verilerle entegrasyon kurabileceğini belirtiyor. Bu, proje kapsamını belirlemek için yararlı bir başlangıç noktasıdır; ancak yapılacak işlemin API’de hangi yöntemlerle gerçekleştirileceği ilgili belgelere bakılarak doğrulanmalıdır.

İlk aşamada kapsamı küçük tutmak, bir eklentinin hangi girdileri alacağını ve kullanıcıya ne sonuç sunacağını anlamayı kolaylaştırır. Bu bir proje planlama önerisidir; belirli bir API özelliği veya SketchUp içi menü adımı değildir.

### 2. Resmî genel bakış ve örneklerle ilerleyin

SketchUp Ruby API belgelerindeki Ruby API Overview, temel yönlendirme noktasıdır. Resmî dokümantasyon ayrıca yaygın senaryoları ve kavramları anlatan örnekler ile eğitimlere bağlantı veriyor. İlk uygulamada örnekleri inceleyip eklentinin hedefiyle ilişkili olanları seçin; belgede gösterilmeyen bir sınıf, yöntem ya da davranışı varsaymak yerine açıklamasını doğrulayın.

SketchUp Developer Center da başlangıç içerikleri, örnek uzantılar ve API kaynaklarını bir araya getiriyor. Buradaki içerikler, bir eklentinin SketchUp içinde yeni araç ve işlevler sunma yaklaşımını anlamaya yardımcı olabilir. Uzantıyı başkalarıyla paylaşma hedefi varsa Extension Warehouse üzerinden yayımlama seçeneği de geliştirici merkezinde yer alıyor.

### 3. IDE’nizi API’ye hazırlayın

Ruby API stubları, geliştirme ortamının SketchUp API’si hakkında bilgi sahibi olmasına yardımcı olmak için sunuluyor. Resmî kaynaklarda RubyMine için proje hazırlama anlatımı ve VSCode için bir proje örneği bulunuyor. Kullanılan IDE’ye uygun örneği seçin ve belgelenen kurulum adımlarını izleyin.

Hata ayıklama için SketchUp Ruby Debugger arayüzü kullanılabiliyor. Bu arayüz, Ruby Debug protokolünü destekleyen editör ve IDE’lerin hata ayıklama işlevleriyle çalışacak şekilde tanımlanıyor. Kaynaklarda belirli bir IDE’nin zorunlu olduğu belirtilmiyor; dolayısıyla seçim, geliştirme ekibinin mevcut araçlarına göre yapılabilir.

### 4. API çağrılarını ana iş parçacığında tutun

Resmî API dokümantasyonu, Ruby API ile yapılan tüm etkileşimlerin ana iş parçacığında yürütülmesi gerektiği konusunda uyarıyor. Aksi durumda beklenmedik davranışlar ve uygulama kararsızlığı yaşanabilir. Bu koşulu, eklentinin tasarımını yaparken göz önünde bulundurun; özellikle iş akışını farklı parçalara ayıran bir yapı planlanıyorsa ilgili işlemlerin nasıl yürütüleceğini resmi belgelere göre doğrulayın.

Bu uyarı yalnızca yayımlama aşamasında kontrol edilecek bir ayrıntı değil, geliştirme ve test planının parçasıdır. Eklenti beklenen sonucu verse bile ana iş parçacığı gerekliliği göz ardı edilmemelidir.

### 5. Testleri SketchUp içinde çalıştırın

SketchUp dışında çalışan Ruby testlerinin, uygulamanın içinde yürütülmesi gereken kodları sınamakta yetersiz kalabileceği resmi kaynakta belirtiliyor. TestUp, Minitest üzerine kurulu bir çözüm olarak bu duruma yanıt veriyor ve testleri yönetmek için bir grafik arayüz sunuyor. Test senaryolarını, eklentinin hedeflediği davranışları doğrulayacak biçimde oluşturun ve testleri SketchUp içindeki kullanım koşullarında değerlendirin.

TestUp için kaynaklarda her test türünün nasıl yazılacağına dair ayrıntılı örnek verilmediğinden, test altyapısına geçerken aracın resmi deposundaki açıklamalar ve API eğitimleri izlenmeli. Bu yaklaşım, belgelerde olmayan bir test sözdizimi veya otomatik kurulum adımı varsaymayı önler.

### 6. LayOut desteği gerekiyorsa kapsamı doğrulayın

Ruby API, SketchUp 2018’den itibaren LayOut belgelerini oluşturma ve düzenleme desteği de sunuyor. LayOut Ruby API’nin de yalnızca SketchUp içinden kullanılabildiği belirtiliyor. Eklentinin LayOut belgelerine dokunması gerekiyorsa, bu işlevi ayrı bir gereksinim olarak ele alın ve LayOut API Overview belgelerini inceleyin. Kaynaklar daha ayrıntılı sürüm uyumluluğu veya kullanım adımları vermediği için bu konularda ilgili resmi dokümana başvurmak gerekir.

## Sık karşılaşılan hatalar

- **API’yi bağımsız çalıştırmaya çalışmak:** Ruby API, SketchUp olmadan kullanılabilen bağımsız bir araç değildir.
- **Ana iş parçacığı uyarısını gözden kaçırmak:** API etkileşimleri ana iş parçacığında yapılmalıdır; aksi davranış uygulama kararsızlığına yol açabilir.
- **SketchUp dışındaki testleri yeterli saymak:** SketchUp içinde çalışan kod için TestUp gibi uygulama içi test seçeneklerini değerlendirin.
- **Belgelenmemiş ayrıntıları varsaymak:** Sürüm, yöntem ve uyumluluk bilgileri için resmi API belgelerini kontrol edin.
- **IDE yapılandırmasını atlamak:** API stubları, IDE örnekleri ve hata ayıklama rehberleri geliştirme ortamını hazırlamak için mevcut kaynaklardır.

## Sonraki adımlar

İlk eklenti tamamlandıktan sonra, kullanım hedefi gerektiriyorsa yayımlama seçeneğini değerlendirin. SketchUp Developer Center, uzantıların Extension Warehouse’da paylaşılabileceğini belirtiyor. Extension Warehouse dışında dağıtım planlanıyorsa geliştirici merkezi dijital imzalama ve güvenlik sertifikası sürecine de yönlendiriyor.

Daha karmaşık işlevler için resmi kaynaklarda Ruby C uzantılarına yönelik örnekler de bulunuyor. Bunlar daha karmaşık işlevler ve olası performans iyileştirmeleri için bir seçenek olarak sunuluyor; her projede gerekli oldukları söylenmiyor. Önce Ruby API ile çözümün sınırlarını belirleyip ardından ilgili örnekleri incelemek daha kontrollü bir geliştirme akışı sağlar.

## Kaynak ve lisans

Bu rehber, SketchUp Ruby API’nin resmî dokümantasyonu ile SketchUp Developer Center’daki geliştirici kaynakları temel alınarak Türkçe uyarlanmıştır. Kaynak kayıtlarında her iki sayfa da “serbest” olarak işaretlenmiştir; ayrıca belirli bir Creative Commons lisansı belirtilmemiştir.

## Pro ipucu
SketchUp Ruby API çağrılarının ana iş parçacığında yürütüldüğünü geliştirme planına baştan dahil edin; uygulama içi testler için TestUp’ı inceleyin.

## 3dsınıfı yorumu
Türkiye’de SketchUp kullanan mimarlık ve iç mimarlık ofisleri için Ruby API, tekrarlanan modelleme işlerini veya harici veriyle bağlantılı süreçleri eklentiye dönüştürme potansiyeli taşıyor. Özellikle ekip içinde benzer adımlar sık yineleniyorsa küçük kapsamlı bir otomasyon bile iş akışını düzenleyebilir.

Yatırımın karşılığını değerlendirirken yalnızca geliştirme süresine değil, eklentinin hedeflenen SketchUp sürümüyle uyumuna, test ve bakım ihtiyacına da bakmak gerekir. Kaynaklarda ücret veya donanım gereksinimi açıklanmıyor; bu yüzden maliyet ya da performans avantajı varsaymak doğru olmaz. Ana iş parçacığı kuralı ve uygulama içi test gereksinimi, üretim öncesinde özellikle doğrulanmalı.

## Kaynaklar
- [ruby.sketchup.com](https://ruby.sketchup.com/) (özet)
- [developer.sketchup.com](https://developer.sketchup.com/) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_