Converto — Nasıl Kullanılır

Son Güncelleme: 1 Ocak 2026

Converto, bir Dynamo .dyn grafiğini okur ve derlemeye ve geliştirmeye hazır, eksiksiz bir C# Revit API eklenti iskeleti oluşturur.

Önkoşullar

Gereksinim Notlar
Autodesk Revit 2026 Eklentiyi çalıştırmak için gereklidir
.NET 8 SDK Oluşturulan iskelet projeleri derlemek için gereklidir
Visual Studio 2022 (isteğe bağlı) Oluşturulan kodu düzenlemek için önerilir
Claude veya OpenAI API anahtarı (isteğe bağlı) Yapay zekâ destekli kod oluşturma için gereklidir

Hızlı başlangıç

Adım 1 — Bir Revit projesi açın

Revit 2026'yı başlatın ve herhangi bir projeyi açın. Converto, aktif bir Revit oturumunda çalışır.

Adım 2 — Converto'yu açın

AvantLeap sekmesine gidin → CONVERTO paneli → Convert Graph butonuna tıklayın.

Adım 3 — .dyn dosyanızı yükleyin

"Dynamo Dosyası" alanının yanındaki Gözat düğmesine tıklayın ve .dyn grafiğinizi seçin.

Converto, grafiği ayrıştırır ve her düğüme ait aşağıdaki bilgileri gösteren bir analiz tablosu sunar:

Sütun Anlamı
Düğüm adı Dynamo düğüm etiketi
Durum Eşlendi / Kısmi / Eşlenmedi
Kategori Düğümün gruplandığı alan (Öğe, Filtre, Parametre, Görünüm, vb.)
Önerilen yöntem Converto'nun oluşturacağı C# metot adı
API ipucu (Eşlenen düğümler için) Revit API karşılığı

Adım 4 — Eşleme sonuçlarını inceleyin

  • Eşlendi düğümlerinin doğrudan C# Revit API karşılığı vardır. Bu metotların taslakları önceden doldurulmuş olur.
  • Eşlenmedi düğümler (üçüncü parti paketler, Python betikleri) TODO yorumu ile taslak metotlar üretir. Bunlar manuel uygulama veya yapay zekâ desteği gerektirir.
  • Eğer bir API anahtarı tanımlıysa, eşlenmemiş düğümler için yapay zekâdan ipucu almak için AI ile Öner düğmesine tıklayın.

Adım 5 — Çıktı ayarlarını yapılandırın

Alan Açıklama
Eklenti adı Oluşturulan Visual Studio projesinin ve DLL'nin adı
Namespace Kök C# namespace'i (örn. MyFirm.Tools)
Çıktı klasörü İskelet proje klasörünün nereye kaydedileceği

Adım 6 — Oluştur & Derle

Oluştur & Derle düğmesine tıklayın.

Converto şunları yapar:

  1. İskelet projeyi OutputFolder\{AddinName}\ dizinine yazar
  2. Eğer bir AI anahtarı tanımlıysa: Tüm taslak metotların gerçek Revit API koduyla doldurulmasını AI’dan ister
  3. Oluşturulan projede dotnet build çalıştırır
  4. Eğer derleme hatası alınırsa: Hataları AI’a gönderir ve düzeltmeleri uygular (en fazla 3 deneme)
  5. Son derleme sonucunu günlük panelinde bildirir

Başarılı bir derleme, {AddinName}\bin\Release\ klasöründe derlenmiş bir .dll üretir.

Yapay Zekâ Ayarları

API anahtarınızı yapılandırmak için (üstteki işlem çubuğunda görünen) ⚙ AI Ayarlarına tıklayın.

Ayar Açıklama
Sağlayıcı Claude (Anthropic) veya OpenAI (GPT-4o) seçin
API Anahtarı Kişisel API anahtarınızdır — yerel olarak saklanır, AvantLeap'e asla gönderilmez
Model Varsayılan: claude-sonnet-4-6 / gpt-4o
Eşlenmemişleri otomatik öner Bir grafik yüklenirken eşlenmeyen düğümler için otomatik olarak AI’dan ipucu alın

Oluşturma işleminden önce anahtarınızı doğrulamak için Bağlantıyı Test Et'e tıklayın.

İskeleti Doğrula

Varolan bir iskelet projeyi tam dönüştürmeyi yeniden çalıştırmadan derlemek ve düzeltmek için İskeleti Doğrula komutunu (AvantLeap → CONVERTO → Validate) kullanın.

  1. Gözat’a tıklayarak iskeletin .csproj dosyasını seçin
  2. Derle’ye tıklayarak dotnet build çalıştırın ve hataları görün
  3. AI ile Düzelt'e tıklayarak hataları AI’a gönderin ve düzeltmeleri uygulayın
  4. Başarıya ulaşana kadar yinelenebilir

Oluşturulan Projeyi Anlamak

OutputFolder\
└── MyTool\
    ├── MyTool.csproj           ← SDK tipi, net8.0-windows, RevitAPI referanslı
    ├── MyTool.addin            ← Revit manifestosu — Addins klasörüne kopyalayın
    ├── App.cs                  ← IExternalApplication + şerit (ribbon) butonları
    ├── Nodes\
    │   ├── ElementNodes.cs     ← Kategori başına statik yardımcı metotlar
    │   └── ...
    ├── Commands\
    │   ├── ElementCommand.cs   ← Her kategori için IExternalCommand
    │   └── ...
    └── README-converto.md      ← Oluşturulan projede hızlı başlangıç

Oluşturulan eklentiyi dağıtma

  1. İskeleti derleyin: dotnet build MyTool.csproj -c Release
  2. bin\Release\MyTool.dll dosyasını %APPDATA%\Autodesk\Revit\Addins\2026\MyTool\ dizinine kopyalayın
  3. MyTool.addin dosyasını %APPDATA%\Autodesk\Revit\Addins\2026\ dizinine kopyalayın
  4. Revit’i yeniden başlatın

Eşleme Seviyeleri

Seviye Kaynak Sonuç
1 — Çekirdek Dynamo Dahili Dynamo/Revit düğümleri Eşlendi → hazır C# kodu
2 — Üçüncü parti paket archilab, Clockwork, spring, BumbleBee vs. Eşlenmedi → taslak + TODO yorumu
3 — Python Betiği PythonScriptNode Eşlenmedi → yoruma gömülü Python betiği ile birlikte taslak

Seviye 2 ve 3 taslaklar, bir API anahtarı mevcutsa AI uygulama adımı ile tamamlanır.

Sorun Giderme

Sorun Çözüm
"Bağlantı Testi: Başarısız" API anahtarınızın doğru ve yeterli krediye sahip olduğundan emin olun. Tam hata mesajı butonun altında gösterilir.
AI düzeltmesinden sonra derleme hatası "AI ile Düzelt"e tekrar tıklayın — otomatik olarak en fazla 3 kez tekrar denenir. Karmaşık grafiklerde manuel düzeltme gerekebilir.
RevitAPI.dll bulunamadı Revit 2026’nın C:\Program Files\Autodesk\Revit 2026\ yoluna kurulu olduğundan emin olun
Tüm düğümler Eşlenmedi olarak görünüyor Grafik muhtemelen sadece üçüncü parti paketler kullanıyor. AI üretimi çoğunu çözecektir.
Oluşturulan şerit (ribbon) butonu eksik .addin dosyasındaki FullClassName’in App sınıfı isim alanı ile birebir aynı olduğundan emin olun.

Desteklenen Revit Sürümleri

Revit Destekleniyor
2026 Evet
2025 ve önceki Aşama 3 — yakında eklenecek

Destek için: https://www.avantleap.com/converto