Kodunuzdan bağımlılık diyagramları oluşturma

Yazılım sisteminizin üst düzey, mantıksal mimarisini görselleştirmek için Visual Studio dependency diyagramı oluşturun. Kodunuzun bu tasarımla tutarlı kaldığından emin olmak için kodunuzu bir bağımlılık diyagramıyla doğrulayın. Visual C# ve Visual Basic projeleri için bağımlılık diyagramları oluşturabilirsiniz. Hangi Visual Studio sürümlerinin bu özelliği desteklediğini görmek için bkz. Mimari ve modelleme araçları için sürüm desteği.

Bağımlılık diyagramı oluşturma

Bağımlılık diyagramı, Visual Studio çözüm öğelerini layers adlı mantıksal, soyut gruplar halinde düzenlemenize olanak tanır. Bu yapıtların gerçekleştirdiği ana görevleri veya sistemin ana bileşenlerini açıklamak için katmanları kullanabilirsiniz.

Her katman, daha ayrıntılı görevleri açıklayan başka katmanlar içerebilir. Katmanlar arasında istenen veya var olan bağımlılıkları da belirtebilirsiniz. Ok olarak temsil edilen bu bağımlılıklar, diğer katmanlar tarafından temsil edilen işlevselliği kullanan veya kullanabilen katmanları gösterir. Kodun mimari denetimini korumak için diyagramda hedeflenen bağımlılıkları gösterin ve ardından kodu diyagrama göre doğrulayın.

Video: Mimari bağımlılıklarınızı gerçek zamanlı olarak doğrulama

Bağımlılık diyagramı oluşturma

Bağımlılık diyagramı oluşturmadan önce çözümünüzün bir modelleme projesi olduğundan emin olun.

Important

Mevcut bağımlılık diyagramını bir modelleme projesinden başka bir modelleme projesine veya çözümdeki başka bir yere eklemeyin, sürüklemeyin veya kopyalamayın. Bu, diyagramı değiştirseniz bile özgün diyagramdaki başvuruları korur. Bu ayrıca katman doğrulamasının düzgün çalışmasını engeller ve diyagramı açmaya çalıştığınızda eksik öğeler veya diğer hatalar gibi başka sorunlara neden olabilir.

Bunun yerine modelleme projesine yeni bir bağımlılık diyagramı ekleyin. Kaynak diyagramdaki öğeleri yeni diyagrama kopyalayın. Hem modelleme projesini hem de yeni bağımlılık diyagramını kaydedin.

Modelleme projesine yeni bağımlılık diyagramı ekleme

Uyarı

.NET Core projeleri için bağımlılık diyagramları, 2019 sürüm 16.2 Visual Studio den itibaren desteklenir.

  1. Çözüm Gezgini'da modelleme projenize sağ tıklayın ve Add>Yeni Öğe'yi seçin.

  2. Yeni Öğe Ekle penceresinde Bağımlılık Doğrulama Diyagramı'nı seçin, pencerenin en altındaki diyagram için bir ad girin ve Ekle'yi seçin.

Kod Eşlemesi'nden sürükleyip bırakın veya kopyalayıp yapıştırın

  1. Mimari menüsünü kullanarak çözüm için bir Kod Haritası oluşturun.

  2. Yalnızca ürün kodunda bağımlılıkları zorunlu kılmak istiyorsanız çözüm klasörlerini ve "Test Varlıkları" öğesini kaldırmak için Kod Eşlemesi filtresi uygulamayı göz önünde bulundurun.

  3. Oluşturulan Kod Eşlemesinde, "Dış" düğümünü kaldırın veya ad alanı bağımlılıklarını zorlamak isteyip istemediğinize bağlı olarak dış derlemeleri gösterecek şekilde genişletin. Kod Eşlemesi'nden gerekli olmayan derlemeleri silin.

  4. Çözümünüzdeki Bağımlılık Doğrulama projesine bir Bağımlılık Doğrulama Diyagramı öğesi ekleyin.

  5. Kod Haritası'nda tüm düğümleri seçin ( Ctrl + A kullanın veya tıklamadan, sürüklemeden ve bırakmadan önce Shift tuşuna basarak lastik bant seçimini kullanın).

  6. Seçili öğeleri yeni Bağımlılık Doğrulama diyagramına sürükleyip bırakın veya kopyalayıp yapıştırın.

  7. Bu, geçerli uygulama mimarisini gösterir. Mimarinin ne olmasını istediğinize karar verin ve bağımlılık diyagramını uygun şekilde değiştirin.

Kod Eşlemesinden oluşturulan bağımlılık diyagramını gösteren ekran görüntüsü.

Artifaktlardan katman oluşturma

Projeler, kod dosyaları, ad alanları, sınıflar ve yöntemler gibi Visual Studio çözüm öğelerinden katmanlar oluşturabilirsiniz. Bu, katman doğrulama işlemine dahil olmak üzere katmanlar ve öğeler arasında otomatik olarak bağlantılar oluşturur.

Word belgeleri veya PowerPoint sunuları gibi doğrulamayı desteklemeyen öğelere katmanları bağlayabilirsiniz. Bu, bir katmanı belirtimler veya planlarla ilişkilendirmenizi sağlar. Katmanları birden çok uygulama arasında paylaşılan projelerdeki dosyalara da bağlayabilirsiniz, ancak doğrulama işlemi "Katman 1" ve "Katman 2" gibi genel adlarla görünen bu katmanları içermez.

Bağlantılı bir öğenin doğrulamayı destekleyip desteklemediğini görmek için Katman Gezgini'ni açın ve öğenin Doğrulamayı Destekler özelliğini inceleyin. Bkz Eser bağlantılarını yönetme.

'dan'e Şu adımları izleyin
Tek bir yapıt için katman oluşturma
  1. Öğeyi şu kaynaklardan bağımlılık diyagramına sürükleyin:
    Diyagramda bir katman görünür ve yapıta bağlanır.
  2. Katmanı, ilişkili kodun veya yapıtların sorumluluklarını yansıtacak şekilde yeniden adlandırın.

Önemli: İkili dosyaları bağımlılık diyagramına sürüklemek, başvurularını modelleme projesine otomatik olarak eklemez. Doğrulamak istediğiniz ikili dosyaları modelleme projesine el ile ekleyin. Modelleme projesine ikili dosyalar eklemek için
  1. Çözüm Gezgini'da modelleme projesinin kısayol menüsünü açın ve Varolan Öğeyi Ekle'i seçin.
  2. Var Olan Öğe Ekle iletişim kutusunda ikili dosyalara göz atın, bunları seçin ve ardından Tamam'ı seçin. İkili dosyalar modelleme projesinde görünür.
  3. Çözüm Gezgini'da, eklediğiniz ikili dosyayı seçin ve F4 tuşlarına basarak Properties penceresini açın.
  4. Her ikili dosyada Derleme Eylemi özelliğini Doğrula olarak ayarlayın.
Seçili tüm yapıtlar için tek bir katman oluşturma Tüm yapıtları aynı anda bağımlılık diyagramına sürükleyin.

Diyagramda bir katman görünür ve tüm yapıtlara bağlanır.
Seçilen her yapıt için katman oluşturma Tüm yapıtları aynı anda bağımlılık diyagramına sürüklerken SHIFT tuşunu basılı tutun.
Not: Bir öğe aralığı seçmek için SHIFT tuşunu kullanırsanız, yapıtları seçtikten sonra anahtarı bırakın. Tekrar basılı tutun ve yapıtları diyagrama sürükleyin.

Diyagramda her yapıt için bir katman görünür ve her yapıta bağlanır.
Katmana bir nesne ekleyin Öğeyi katmana sürükleyin.
Yeni bir bağlantısız katman oluşturma Araç Kutusu'ndaBağımlılık Diyagramı bölümünü genişletin ve bağımlılık diyagramına bir Katman sürükleyin.

Birden çok katman eklemek için araci çift tıklayın. İşiniz bittiğinde İşaretçi aracını seçin veya ESC tuşuna basın.

-veya-

Bağımlılık diyagramının kısayol menüsünü açın, Ekle'yi ve ardından Katman'ı seçin.
İç içe katmanlar oluşturma Mevcut bir katmanı başka bir katmana sürükleyin.

-veya-

Katmanın kısayol menüsünü açın, Ekle'yi ve ardından Katman'ı seçin.
İki veya daha fazla mevcut katmanı içeren yeni bir katman oluşturma Katmanları seçin, seçiminizin kısayol menüsünü açın ve ardından Gruplandır'ı seçin.
Katmanın rengini değiştirme Color özelliğini istediğiniz renge ayarlayın.
Bir katmanla ilişkilendirilmiş yapıtların belirtilen ad alanlarına ait olmaması gerektiğini belirtin Katmanın Yasak Ad Alanları özelliğine ad alanlarını yazın. Ad alanlarını ayırmak için noktalı virgül (;) kullanın.
Bir katmanla ilişkilendirilmiş yapıtların belirtilen ad alanlarına bağımlı olmadığını belirtin Katmanın Yasak Ad Alanı Bağımlılıkları özelliğine ad alanlarını yazın. Ad alanlarını ayırmak için noktalı virgül (;) kullanın.
Bir katmanla ilişkilendirilmiş yapıtların belirtilen ad alanlarına ait olması gerektiğini belirtin Katmanın Gerekli Ad Alanları özelliğine ad alanını yazın. Ad alanlarını ayırmak için noktalı virgül (;) kullanın.

Katmandaki sayı, katmana bağlı yapıt sayısını gösterir. Ancak, bu sayıyı okurken şunları unutmayın:

  • Katman başka yapıtlar içeren bir yapıta bağlanıyorsa ancak katman doğrudan diğer yapıtlara bağlanmıyorsa, sayı yalnızca bağlantılı yapıtı içerir. Ancak diğer artefaktlar katman doğrulama sırasında analize dahil edilir.

    Örneğin, bir katman tek bir ad alanına bağlıysa, ad alanı sınıflar içerse bile bağlantılı yapıt sayısı 1 olur. Katmanın ad alanında her sınıfa da bağlantıları varsa, sayı bağlantılı sınıfları içerir.

  • Katman yapıtlara bağlı başka katmanlar içeriyorsa, kapsayıcı katmanındaki sayı bu yapıtları içermese bile kapsayıcı katmanı bu yapıtlara da bağlanır.

Katmanlar ve yapıtlar arasındaki bağlantıları yönetme

  1. Bağımlılık diyagramında katmanın kısayol menüsünü açın ve bağlantıları görüntüle'yi seçin.

    Katman Gezgini seçili katman için yapıt bağlantılarını gösterir.

  2. Bu bağlantıları yönetmek için aşağıdaki görevleri kullanın:

'dan'e Katman Gezgini'nde
Katman ile yapıt arasındaki bağlantıyı silme Yapıt bağlantısının kısayol menüsünü açın ve sil'i seçin.
Bağlantıyı bir katmandan diğerine taşıma Yapıt bağlantısını diyagramdaki mevcut bir katmana sürükleyin.

-veya-

1. Artifact bağlantısının kısayol menüsünü açın ve Kes seçin.
2. Bağımlılık diyagramında, katmanın kısayol menüsünü açın ve yapıştır'ı seçin.
Bağlantıyı bir katmandan diğerine kopyalama 1. Yapıt bağlantısının kısayol menüsünü açın ve kopyala'yı seçin.
2. Bağımlılık diyagramında, katmanın kısayol menüsünü açın ve yapıştır'ı seçin.
Mevcut yapıt bağlantısından yeni katman oluşturma Yapıt bağlantısını diyagramdaki boş bir alana sürükleyin.
Bağlı yapıtın bağımlılık diyagramında doğrulamayı desteklediğini doğrulayın. Yapıt bağlantısının Doğrulamayı Destekler sütununa bakın.

Mevcut bağımlılıklara ters mühendislik uygulama

Bağımlılık, bir katmanla ilişkilendirilmiş bir yapıtın başka bir katmanla ilişkilendirilmiş bir yapıta başvurusu olduğunda bulunur. Örneğin, bir katmandaki bir sınıf, başka bir katmanda sınıfı olan bir değişken bildirir. Diyagramdaki katmanlara bağlı yapıtlar için mevcut bağımlılıklara ters mühendislik yapabilirsiniz.

Uyarı

Belirli türdeki teknolojik yapıtlar için bağımlılıklara tersine mühendislik uygulanamaz. Örneğin, metin dosyasına bağlı bir katmandan veya katmana ters mühendislik uygulanmaz. Ters mühendislik yapabileceğiniz bağımlılıkları olan yapıtları görmek için, bir veya birden çok katmanın kısayol menüsünü açın ve bağlantıları görüntüle'yi seçin. Katman Gezgini'ndeDoğrulamayı Destekler sütununu inceleyin. Bağımlılıklar, bu sütunda False olarak gösterilen yapıtlar için tersine mühendislik uygulanamaz.

  • Bir veya birden çok katman seçin, seçili katmanın kısayol menüsünü açın ve Bağımlılıkları Oluştur'u seçin.

    Mevcut olmaması gereken bazı bağımlılıklar görürseniz, bu bağımlılıkları hedeflenen tasarımla uyumlu hale getirmek için düzenleyebilirsiniz.

Amaçlanan tasarımı göstermek için katmanları ve bağımlılıkları düzenleme

Sisteminizde veya hedeflenen mimaride yapmayı planladığınız değişiklikleri açıklamak için bağımlılık diyagramını düzenleyin:

'dan'e Bu adımları gerçekleştirin
Bağımlılığın yönünü değiştirme veya kısıtlama Direction özelliğini ayarlayın.
Yeni bağımlılıklar oluşturma Bağımlılık ve Çift Yönlü Bağımlılık araçlarını kullanın.

Birden çok bağımlılık çizmek için ara çubuğuna çift tıklayın. İşiniz bittiğinde İşaretçi aracını seçin veya ESC tuşuna basın.
Bir katmanla ilişkilendirilmiş yapıtların belirtilen ad alanlarına bağımlı olmadığını belirtin Katmanın Yasak Ad Alanı Bağımlılıkları özelliğine ad alanlarını yazın. Ad alanlarını ayırmak için noktalı virgül (;) kullanın.
Bir katmanla ilişkilendirilmiş yapıtların belirtilen ad alanlarına ait olmaması gerektiğini belirtin Katmanın Yasak Ad Alanları özelliğine ad alanlarını yazın. Ad alanlarını ayırmak için noktalı virgül (;) kullanın.
Bir katmanla ilişkilendirilmiş yapıtların belirtilen ad alanlarına ait olması gerektiğini belirtin Katmanın Gerekli Ad Alanları özelliğine ad alanını yazın. Ad alanlarını ayırmak için noktalı virgül (;) kullanın.

Öğelerin diyagramda nasıl görüneceğini değiştirme

Katmanların boyutunu, şeklini, rengini ve konumunu ya da bağımlılıkların rengini özelliklerini düzenleyerek değiştirebilirsiniz.

Kod haritasındaki desenleri ve bağımlılıkları bulma

Bağımlılık diyagramları oluştururken kod eşlemeleri de oluşturabilirsiniz. Bu diyagramlar, kodu keşfederken desenleri ve bağımlılıkları keşfetmenize yardımcı olabilir. Derlemeleri, ad alanlarını ve sınıfları keşfetmek için Çözüm Gezgini, Sınıf Görünümü veya Nesne Tarayıcısı'nı kullanın. Bunlar genellikle mevcut katmanlara iyi karşılık gelir. Kod eşlemeleri hakkında daha fazla bilgi için bkz: