Nasıl yapılır: Bir Modelleme Uzantısı Tanımlama ve Yükleme

Visual Studio Ultimate içinde istediğiniz uzantıları diyagramları modelleme için tanımlayabilirsiniz.Bu şekilde diyagramları ve modelleri kendi gereksinimlerinize uyarlayabilirsiniz.Örneğin; menü komutlarını, UML profillerini, doğrulama kısıtlamalarını ve araç kutusu öğelerini tanımlayabilirsiniz.Tek bir uzantıda çeşitli bileşenleri tanımlayabilirsiniz.Bu uzantıları biçiminde Visual Studio Ultimate diğer kullanıcılara dağıtmak için bir Visual Studio Integration uzantısı (VSIX). Bir VSIX VSIX projesini Visual Studio kullanarak oluşturabilirsiniz.

Gereksinimler

• Hangi elde edebilirsiniz ve Visual Studio sdk, Visual Studio galeri.

• Visual Studio görselleştirme ve elde edebilirsiniz modelleme sdk Visual Studio görselleştirme ve modelleme sdk kod Galerisi'nde bulunan.

Bir Modelleme Uzantısı Çözümü Oluşturma

Bir modelleme uzantısı tanımlamak için şu projeleri içeren bir çözüm oluşturmanız gerekir:

• Visual Studio Tümleştirme Uzantısı (VSIX) projesi.Bu, uzantınızın bileşenleri için yükleyici görevi gören bir dosya oluşturur.

• Program kodunu içeren bileşenler için gerekli bir sınıf kitaplığı projesi.

Çeşitli bileşenleri olan bir uzantı yapmak istiyorsanız, bunları tek bir çözümde geliştirebilirsiniz.Tek bir VSIX proje gerekir.

Özel araç kutusu öğeleri ve özel uml profilleri gibi bir kod gerektirmeyen bileşenleri ayrı sınıf kitaplığı projelerinde kullanmadan doğrudan VSIX projesine eklenebilir.Program kodu gerektiren bileşenler daha kolay bir ayrı class library projesi olarak tanımlanır.Kod gerektiren bileşenler hareketini işleyicileri, menü komutlarını ve doğrulama kodu içerir.

Menü komutlarını, hareketi işleyicileri veya doğrulama class library projesi oluşturmak için

1. Üzerinde dosyasını menüsünden seçin Yeni, Proje.

2. Altında Yüklü şablonlar, select Visual C# veya Visual Basic, sonra seçim Class Library.

VSIX proje oluşturmak için

1. Kodla bir bileşen oluşturuyorsanız, sınıf kitaplığı projesini ilk oluşturmak en kolayıdır.Bu projeye kodunuzu ekleyeceksiniz.

2. VSIX projesi oluşturur.

   1. İçinde Solution Explorer'da, çözümün kısayol menüsünü seçin Ekle, Yeni bir proje.

   2. Altında Yüklü şablonlar, genişletme Visual C# veya Visual Basic, sonra genişletilebilirlik.Orta sütunda seçme VSIX proje.

3. Çözümün başlangıç projesi olarak VSIX projesini ayarlayın.

   • Solution Explorer'da, VSIX project kısayol menüsünden seçim baþlangýç projesi olarak ayarlanmış.

4. source.extension.vsixmanifest öğesini açın.Dosya, bildirim düzenleyicisinde açılır.

5. Üzerinde meta verileri sekmesinde, adı ve VSIX, açıklayıcı alanlar ayarlayın.

6. Üzerinde Yükleme hedefleri sekmesinde, seçim Yeni ve Visual Studio Ultimate ve Premium sürümleri ayarlayın.

7. Üzerinde varlıklarını sekmesinde, bileşenlerinizin Visual Studio uzantısını ekleyin.

   1. Seçim Yeni.

   2. Bu alanların kodu içeren bir bileşen için ayarlanan Ekle yeni kıymet iletişim kutusu:

      Type =	Microsoft.VisualStudio.MefComponent
      Kaynak =	Bir projedeki geçerli çözümü
      Proje =	Class library projesi
      Bu klasörde embed =	(boş)

      Diğer bileşen türleri için sonraki bölümde yer alan bağlantılara bakın.

Bileşeni Geliştirme

Menü komutu veya hareket işleyicisi gibi her bileşen için, ayrı bir işleyici tanımlamalısınız.Aynı sınıf kitaplığı projesi birkaç işleyici koyabilirsiniz.Aşağıdaki tablo farklı tür işleyicileri özetler.

Uzantı türü	Konu	Her bileşen genellikle nasıl bildirilir
Menü Komutu	Nasıl yapılır: Modelleme Diyagramında Menü Komutu Tanımlama	[ClassDesignerExtension] // or other diagram types [Export(typeof(ICommandExtension))] public class MyCommand : ICommandExtension {...
Sürükle ve bırak veya çift tıkla	Nasıl yapılır: bir modelleme çizim hareketi işleyicisi tanımlamak	[ClassDesignerExtension] // or other diagram types [Export(typeof(IGestureExtension))] public class MyGesture : IGestureExtension {...
Doğrulama Kısıtlaması	UML Modelleri için Doğrulama Kısıtlamaları Nasıl Tanımlanır	[Export(typeof( System.Action<ValidationContext, object>))] [ValidationMethod(ValidationCategories.Save | ValidationCategories.Menu)] public void ValidateSomething (ValidationContext context, IClassifier elementToValidate) {...}
Iş Öğesi bağlantı olay işleyicisi	Bir İş Öğesi Bağlantı İşleyicisi Nasıl Tanımlanır	[Export(typeof(ILinkedWorkItemExtension))] public class MyWorkItemEventHandler : ILinkedWorkItemExtension {...
UML Profili	UML Genişletmek için Profil Nasıl Tanımlanır	(Tanımlanması için)
Araç Kutusu Öğesi	Nasıl yapılır: Özel Modelleme Araç Kutusu Öğesi Tanımlama	(Tanımlanması için)

Geliştirme Sırasında Bir Uzantıyı Çalıştırma

Geliştirme sırasında bir uzantıyı çalıştırmak için

1. De Visual StudioDebug menüsünden seçin Start Debugging komutunu.

   Proje oluşturulur ve Visual Studio'nun yeni örneği Deneysel modda başlar.

   • Alternatif olarak, seçim yapabileceğiniz Start Without Debugging komutunu.Bu, programı başlatmak için kullanılan süreyi azaltır.

2. Oluşturmak veya bir modelleme projesini Visual Studio Deneysel örneğinde açın ve oluşturun veya bir diyagram açın.

   Uzantınız yüklenecek ve çalışacaktır.

3. Daha önce kullandıysanız Start Without Debugging komutunu , ancak hata ayıklayıcıyı kullanmak istediğiniz ana Visual Studio örneğine dönün.Hata Ayıkla menüsünde, Sürece İliştir'e tıklayın.İletişim kutusunda, program adı olan Visual Studio Deneysel örneğini seçin devenv.

Bir uzantıyı yükleme ve kaldırma

Dahili numaranız Visual Studio ana örneğinde kendi bilgisayarınızda veya ağdaki diğer bilgisayarlarda çalıştırmak için aşağıdaki adımları uygulayın.

1. Bilgisayarınızda, uzantı projeniz tarafından oluşturulmuş .vsix dosyasını bulun.

   1. İçinde Solution Explorer'da, projenizin, kısayol menüsünde ve sonra seçin Klasörü Windows Gezgini'nde Aç.

   2. bin\*\Projeniz.vsix dosyasını bulun.

2. Uzantıyı yüklemek istediğiniz hedef bilgisayara .vsix dosyasını kopyalayın.Bu sizin kendi bilgisayarınız veya başka bir tane olabilir.

   • Hedef bilgisayar üzerinde belirtilen Visual Studio sürümleri birisi olmalıdır Yükleme hedefleri sekmesi, source.extension.vsixmanifest.

3. Hedef bilgisayarda açmak .vsix Örneğin dosyayı çift tıklatarak dosyayı.

   Visual Studio Uzantı Yükleyicisi uzantıyı açar ve yükler.

4. Başlat veya Visual Studio yeniden başlatın.

Bir uzantıyı kaldırmak için

1. Araçlar menüsünde, Uzantı Yöneticisi'ne tıklayın.

2. Yüklü Uzantıları genişletin.

3. Uzantıyı seçin ve sonra Kaldır'a tıklayın.

Nadiren, hatalı bir uzantı yüklemede başarısız olur ve hata penceresinde bir rapor oluşturur, ancak Uzantı Yöneticisi'nde görünmez.Bu durumda uzantıyı dosyayı %LocalAppData% öğesinin DriveName:\Users\UserName\AppData\Local olduğu şu konumdan silerek kaldırabilirsiniz:

%LocalAppData%\Microsoft\VisualStudio\11.0\Extensions

Ayrıca bkz.

Kavramlar

UML Genişletmek için Profil Nasıl Tanımlanır

Nasıl yapılır: Özel Modelleme Araç Kutusu Öğesi Tanımlama

UML Modelleri için Doğrulama Kısıtlamaları Nasıl Tanımlanır

Nasıl yapılır: Modelleme Diyagramında Menü Komutu Tanımlama