Dynamo Paketleri: Package Manager ile Kurulum ve Güvenli Kullanım
Beceri rehberi

Dynamo Paketleri: Package Manager ile Kurulum ve Güvenli Kullanım

Hazırlayan: Mindset Institute EditörlüğüGüncellendi: 5 dk okuma

Dynamo paketleri, çekirdek düğümlerin yetmediği yerde yeni düğümler ekler. Package Manager'dan paketi bulup kurmayı, kurulan düğümleri kitaplıkta görmeyi ve ekipte aynı paket klasörünü paylaşmayı öğrenin.

Bir bakışta

  1. Paket, Dynamo'ya yeni düğümler ekleyen bir koleksiyondur. Üçüncü taraf geliştiriciler yayımlar, Package Manager üzerinden indirilir.
  2. Kurulum, Package Manager penceresinden yapılır. Paketi arar, ayrıntılarına bakar ve Install ile kurarsınız; düğümler kitaplıkta yeni bir grupta görünür.
  3. Kurmadan önce sürüm, bağımlılık ve lisansa bakılır. View Details paneli bu bilgileri gösterir.
  4. Ekipte herkesin aynı paket sürümüyle çalışması gerekir. Paylaşılan paket klasörü tanımlamak bu tutarlılığı kolaylaştırır.
  5. Paketler her zaman en iyi çözüm değildir. Çekirdek düğümler işi görüyorsa bağımlılık eklememek grafiği daha taşınabilir tutar.

Paket nedir, neden kullanılır

Dynamo Primer, paketleri Dynamo'nun çekirdek özelliklerini genişleten özel düğüm ya da ek işlev koleksiyonları olarak tanımlar. Paketleri üçüncü taraf geliştiriciler yayımlar ve Dynamo Package Manager aracılığıyla indirilir. Bir paketi kurduğunuzda, içindeki düğümler kitaplığa eklenir ve diğer düğümler gibi kullanılır.

Paketlerin değeri, ortak ihtiyaçlar için hazır çözümler sunmasıdır. Revit'te bir parametreyi toplu okumak, liste işlemlerini kısaltmak, metin ve birim dönüşümü yapmak ya da Excel ile veri alışverişini kolaylaştırmak gibi işler için çekirdek düğümlerle uzun zincirler kurmak yerine tek düğümle ilerlenebilir. Böylece grafikler kısalır ve okunabilir hale gelir.

Ama paket eklemek her zaman kazanç değildir. Her paket, grafiğe bir bağımlılık getirir: grafiği açacak herkesin aynı paketi kurmuş olması gerekir. Bir paketin bakımının sürüp sürmediğini, hangi Dynamo ve Revit sürümleriyle uyumlu olduğunu bilmek, ileride grafiğin çalışmaz hale gelmesini önler.

Package Manager ile kurulum

Dynamo Primer'e göre paketleri Packages menüsündeki Package Manager seçeneğinden aranır. Açılan pencerede Search for Packages sekmesi paketleri sıralamanıza ve ana uygulama, durum ya da bağımlılığa göre süzmenize izin verir. Bir pakete tıklayıp View Details dediğinizde yan panelde sürüm, bağımlılık, URL ve lisans bilgileri görünür. Kurmak için Install'a basılır ve onay verilir.

Kurulumdan sonra paketin düğümleri, çoğunlukla geliştiricinin ya da paketin adını taşıyan yeni bir grup olarak Dynamo kitaplığında belirir. Kurulu paketlerin listesi için Package Manager içindeki Installed Packages görünümü kullanılır; paketin yanındaki menüden Show Root Directory seçeneğiyle paketin klasörü açılır.

Menü ve düğme adları, Dynamo arayüzünün diline ve sürümüne göre farklı görünebilir. Primer'de geçen İngilizce adlar kullanılır; Türkçe arayüzde karşılıklarını menüde bulabilirsiniz.

Ara sıra paketi güncellemek de gerekir; ancak çalışan bir projenin ortasında paket sürümü değiştirmek, grafiklerin davranışını değiştirebilir. Güncellemeyi önce deneme dosyasında yapıp sonra uygulamak daha güvenlidir.

Şekil 1

Kurulan paket, diskte bir klasör, kitaplıkta bir gruptur

Paketin farklı yüzleri

  1. Package ManagerPaketi arar, ayrıntıya bakar, Install ile kurarsınız.
  2. Paket klasörüDüğüm dosyaları, derlenmiş kitaplıklar ve örnekler diskte durur.
  3. Dynamo kitaplığıKurulan düğümler yeni bir grup olarak görünür ve kullanıma hazır olur.
Kaynak: sayfa içeriğiMindset Institute

Paket klasörünün içi ve örnek dosyalar

Kurulan bir paketin klasörü genelde belirli alt klasörler taşır: bin klasörü DLL dosyalarını ve Zero-Touch düğümlerini, dyf klasörü özel düğüm dosyalarını, extra klasörü örnek ve ek dosyaları, pkg dosyası ise paket ayarlarını içerir. Primer'e göre extra klasöründeki örnek grafikler paketin nasıl kullanıldığını gösterir; ancak her paket örnek içermez.

Bir paketi ilk kez kurduğunuzda yapılacak en yararlı iş, bu örnekleri açıp çalıştırmaktır. Düğüm adlarının tek başına verdiği fikir sınırlıdır; örnek grafik, düğümün hangi türde girdi beklediğini ve ne döndürdüğünü gösterir.

Paketlerin varsayılan saklama yeri kullanıcı profilindeki Dynamo klasörüdür. Konumu Dynamo'daki Preferences içinde Package Settings altında, Node and Package File Locations bölümünde görebilir ve değiştirebilirsiniz. Birden çok bilgisayar kullanıyorsanız ya da yedek yönetimi yapıyorsanız bu bilgi işe yarar.

Sık kullanılan paketlerden örnekler

Dynamo Primer'in yararlı paketler listesi, yaygın kullanılan birkaç paketi kısaca tanıtır. Aşağıdaki örnekler yalnızca o listede yazan tanımlara dayanır.

  • Clockwork: Revit ile ilgili çok sayıda araç, ayrıca liste yönetimi, matematik, metin, birim dönüşümü, geometri ve paneling düğümleri sunar.
  • Data|Shapes: Dynamo betiklerini genişletir ve özellikle Dynamo Player'a işlev katmaya odaklanır.
  • Bumblebee: Excel ile Dynamo arasında veri okuma ve yazmayı iyileştiren bir eklentidir.
  • Rhythm: Revit ve çekirdek düğümler ile bir görünüm eklentisi içerir.
  • Spring Nodes: Dynamo'nun Revit ile etkileşimini iyileştiren düğümler içerir.

Paketlerin işlevleri ve içerdiği düğümler zamanla değişir. Bu yüzden bir paketin güncel durumunu seçmeden önce Package Manager'daki ayrıntı panelinden ve paketin kendi belgelerinden kontrol edin. Aynı işi çözen birden çok paket olabilir; küçük bir deneme grafiğinde karşılaştırmak, uzun vadeli bağımlılık seçiminden önce iyi bir adımdır.

Ekipte paket yönetimi

Bir ekipte herkesin aynı grafikleri açabilmesi için aynı paketlerin, aynı sürümlerle kurulu olması gerekir. Aksi halde bir kişinin çalışan grafiği diğerinde eksik düğüm uyarısı verir. Primer, ofisler için paylaşılan bir paket klasörü kurma yolunu anlatır: Node and Package File Locations altında Add Path ile klasör eklenir ya da DynamoSettings.xml dosyası düzenlenir. Klasörün salt okunur yapılması merkezi yönetimi kolaylaştırır.

İkinci önemli nokta ağ konumudur. Primer, ikili dosya içeren paketlerin (örneğin Zero-Touch düğümleri taşıyanlar) .NET güvenlik kısıtlamaları yüzünden ağ yolundan yüklenemeyebileceğini belirtir. Önerilen çözüm yollarından biri ağ sürücüsünü bilgisayara eşlemek ve paket yolunu bu sürücüye yöneltmektir. BT biriminizle birlikte kurulum planı yapmak gerekir.

Belge disiplini de önemlidir: hangi grafiğin hangi paketlere bağlı olduğunu grafiğin açıklama alanında ya da ekip belgelerinde yazın. Yeni katılan biri için bu liste, ilk kurulumu hızlandırır.

Pakete mi başvurmalı, çekirdeğe mi

Paket kullanma kararı, işin tekrar sıklığına ve bağımlılık maliyetine göre verilir. Tek seferlik bir betikte pratik bir düğüm sizi hızlandırıyorsa sorun yoktur. Ekipçe yıllarca kullanılacak bir üretim grafiğinde ise bağımlılığın süreklilik riski daha ağır basar.

Şekil 2

Paket kararı, bağımlılık maliyetine bakılarak verilir

Karar ağacı

Bu paketi grafiğe eklemeli miyim?
  1. Çekirdek düğümler işi makul sürede görüyorPaket kurmaBağımlılık eklemeden grafiği taşınabilir tutun.
  2. Paket işi belirgin biçimde kısaltıyorDeneme grafiğinde sınaSürümünü ve bakım durumunu ayrıntı panelinden kontrol edin.
  3. Grafik ekipçe kullanılacakSürümü sabitle ve paylaşOrtak paket klasörü ve belge kaydı oluşturun.
Kaynak: sayfa içeriğiMindset Institute

Sık yapılan hatalar

Sık görülen hata, düğüm bulmak için paket kurup kurulu paketleri kayıt altına almamaktır; aylar sonra grafiği başka bir bilgisayarda açınca eksik düğüm uyarısı çıkar ve hangi paketin gerektiği bilinmez. Diğeri, paketi çalışan bir projede aniden güncellemek ve grafiklerin davranışını bozmaktır.

Bir başka hata, paketin ne yaptığını anlamadan kullanmaktır. Düğüm adı tanıdık gelse de girdi birimi, işlem sırası ve döndürdüğü veri tipi paketten pakete değişir. Örnek dosyayı çalıştırmadan üretim grafiğine eklemek bu yüzden risklidir. Son olarak, ağ konumundan paket yüklemeye çalışıp sorun yaşamak yaygındır; ağ sürücüsü eşleme yolunu tercih edin.

Bu beceriyi Mindset programlarında nerede çalışırsınız

Revit'te Dynamo ile Otomasyon Eğitimi, Dynamo temelleri ve arayüz, özel araç ve script geliştirme, proje otomasyonu ve iş akışları modüllerini içerir. Paket kullanımı bu modüllerin kesiştiği bir konudur: hazır düğümlerden ne zaman yararlanılacağı, ne zaman kendi aracınızı yazmanız gerektiği ekipte ortak bir otomasyon kütüphanesi kuranlar için özellikle önemlidir.

İlgili Mindset programı

Revit’te Dynamo ile Otomasyon Eğitimi

Sık sorulanlar

Sık sorulan sorular

Dynamo paketlerini nereden indiririm?

Dynamo içindeki Package Manager'dan. Packages menüsünden Package Manager'ı açar, paketi arar ve Install ile kurarsınız. Ayrıntı panelinde sürüm, bağımlılık, URL ve lisans bilgisi görünür. Kurulumdan sonra paketin düğümleri kitaplıkta yeni bir grupta yer alır.

Kurduğum paketin dosyaları nerede saklanır?

Varsayılan olarak kullanıcı profilindeki Dynamo klasöründe, sürüme göre ayrılmış bir yerde. Tam konumu Preferences altındaki Package Settings bölümünde Node and Package File Locations başlığında görebilirsiniz. Show Root Directory seçeneği de paket klasörünü doğrudan açar.

Grafiği başkasına gönderince eksik düğüm uyarısı alıyorum, neden?

Grafikte kullanılan paket karşı tarafta kurulu değildir. Hangi paketlerin gerektiğini grafik belgesinde belirtin ve karşı tarafın aynı paketi, mümkünse aynı sürümle kurmasını sağlayın. Ekip içinde ortak paket klasörü bu sorunu azaltır.

Clockwork ve Data|Shapes ne işe yarar?

Dynamo Primer'in tanımına göre Clockwork, Revit araçları ile liste, matematik, metin, birim dönüşümü, geometri ve paneling düğümleri sunar. Data|Shapes ise Dynamo betiklerini genişletir ve özellikle Dynamo Player'a işlev katmaya odaklanır. Güncel içerik için paketin kendi belgesine bakın.

Paket kullanmak zorunlu mu?

Hayır. Çekirdek düğümlerle çözülebilen işte paket eklemek çoğu zaman gereksiz bağımlılıktır. Paketler tekrar eden ve zahmetli bir işi belirgin şekilde kolaylaştırdığında değer taşır. Ekipçe kullanılacak grafiklerde bağımlılığın bakım maliyetini de hesaba katın.

Dynamo Paketleri Nasıl Kurulur ve Kullanılır?