Практическое руководство. Определение и установка расширения моделирования

В Visual Studio Ultimate можно определять расширения схем моделирования.Таким образом, пользователь может адаптировать схемы и модели к собственным потребностям.Например, можно определить команды меню, UML-профили, ограничения проверок и элементы панели элементов.В одном расширении можно определить несколько компонентов.Кроме того, эти расширения можно распределять другим пользователям Visual Studio Ultimate в форме расширения Visual Studio Integration Extension (VSIX). Можно создать VSIX с проектом VSIX в Visual Studio.

Требования

Создание решения расширения моделирования

Чтобы определить расширение моделирования, необходимо создать решение, содержащее эти проекты.

  • Проект Visual Studio Integration Extension (VSIX).Создает файл, выступающий установщиком компонентов расширения.

  • Проект библиотеки классов, необходимый для компонентов, включающих код программы.

Если требуется создать расширение, включающее несколько компонентов, их можно разрабатывать в виде единого решения.Требуется только один проект VSIX.

Компоненты, не требующие кода, например пользовательские элементы панели инструментов или пользовательские UML-профили, могут быть добавлены непосредственно в проект VSIX без использования отдельных проектов.Такие компоненты как команды меню, требующие программного кода, проще определить в виде отдельных проектов.Компоненты, которые требуют кода включая обработчики жестов, команд меню, и код проверки.

Создание проекта библиотеки классов для команд меню, обработчиков жестов или проверки

  1. В меню Файл выберите Создать, Проект.

  2. В разделе Установленные шаблоны выберите Visual Basic или Visual C#, а затем — Класс.

Создание проекта VSIX

  1. При создании компонентов, включающих код, проще всего в первую очередь создать проект библиотеки классов.Вы будете добавлять код в этот проект.

  2. Создание проекта VSIX.

    1. В Обозреватель решений, в контекстном меню выберите Добавить решения, Создать проект.

    2. В разделе Установленные шаблоны разверните узел Visual C# или Visual Basic, а затем выберите пункт Расширение среды.В среднем столбце щелкните Проект VSIX.

  3. Сделайте проект VSIX автоматически загружаемым проектом решения.

    • В окне обозревателе решений в контекстном меню проекта VSIX выберите команду Назначить запускаемым проектом.
  4. Откройте source.extension.vsixmanifest.Файл откроется в редакторе манифестов.

  5. На вкладке метаданные задайте имя и поля описания VSIX.

  6. На вкладке Цели установки выберите Создать и задайте стандартные и наградные выпуски Visual Studio.

  7. На вкладке Активы добавьте компоненты в расширение Visual Studio.

    1. Выберите Создать.

    2. Для компонента с кодом, присвойте эти поля в диалоговом окне Добавить новый актив:

      Тип =

      Microsoft.VisualStudio.MefComponent

      Source =

      Проект в текущем решении

      Проект =

      Проект библиотеки классов.

      Добавить в эту папку =

      (пусто)

      Для остальных типов компонентов см. ссылки в следующем разделе.

Разработка компонента

Для каждого компонента (команда меню или обработчик жестов) нужно определить отдельный обработчик.Можно поместить несколько обработчиков в тот же проект библиотеки классов.Сводная информация по основным типам обработчиков представлена в следующей таблице.

Тип расширения

Раздел

Стандартный способ объявления каждого компонента

Команда меню

Практическое руководство. Определение команды меню на схеме моделирования

[ClassDesignerExtension]

// or other diagram types

[Export(typeof(ICommandExtension))]

public class MyCommand : ICommandExtension

{...

Перетаскивание или двойной щелчок

Практическое руководство. Определение обработчика жестов на схеме моделирования

[ClassDesignerExtension]

// or other diagram types

[Export(typeof(IGestureExtension))]

public class MyGesture : IGestureExtension

{...

Ограничение проверки

Практическое руководство. Определение ограничений проверки для моделей UML

[Export(typeof( System.Action<ValidationContext, object>))]

[ValidationMethod(ValidationCategories.Save

| ValidationCategories.Menu)]

public void ValidateSomething

(ValidationContext context, IClassifier elementToValidate)

{...}

Обработчик события ссылки рабочего элемента

Практическое руководство. Определение обработчика связей рабочего элемента

[Export(typeof(ILinkedWorkItemExtension))]

public class MyWorkItemEventHandler : ILinkedWorkItemExtension

{...

UML-профиль

Практическое руководство. Определение профиля для расширения UML

(Определены)

Элемент панели элементов

Практическое руководство. Определение настраиваемого элемента панели элементов моделирования

(Определены)

Запуск расширения во время разработки

Запуск расширения во время разработки

  1. В Visual Studio в меню Отладка выберите Начать отладку.

    Создается проект, и новый экземпляр Visual Studio запускается в экспериментальном режиме.

    • Кроме того, можно щелкнуть Запустить без отладки.Это позволяет быстрее запустить программу.
  2. Создайте или откройте проект моделирования в экспериментальном экземпляре и создайте или откройте схему.

    Это позволит загрузить и запустить расширение.

  3. Если был выбран вариант Запустить без отладки, но необходимо использовать отладчик, следует вернуться к основному экземпляру Visual Studio.В меню Отладка выберите пункт Присоединение к процессу.В диалоговом окне выберите экспериментальный экземпляр с именем программы devenv.

Установка и удаление расширения

Выполните следующие шаги, чтобы запустить расширение в основном экземпляре Visual Studio или в собственном компьютере или на других компьютерах.

  1. Найдите на компьютере файл .vsix, который был создан проектом расширения.

    1. В обозревателе решений в проекте откройте контекстное меню вакшего проекта, затем выберите пункт Открыть папку в Windows Explorer.

    2. Найдите файл bin\*\Ваш_проект.vsix

  2. Скопируйте файл .vsix на конечный компьютер, на котором необходимо установить расширение.Это может быть ваш компьютер или любой другой.

    • Конечный компьютер должен иметь один из выпусков Visual Studio, указанные во вкладке Installation Targets в source.extension.vsixmanifest.
  3. На целевом компьютере, откройте файл .vsix, например, дважды щелкнув его.

    Visual Studio Extension Installer откроет и установит расширение.

  4. Запустите или перезапустите Visual Studio.

Удаление расширения

  1. В меню Сервис выберите пункт Диспетчер расширений.

  2. Разверните Установленные расширения.

  3. Выберите расширение и щелкните Удалить.

Иногда не удается загрузить ошибочное расширение. В этом случае создается отчет в окне ошибок, но расширение не отображается в диспетчере расширений.В этом случае расширение можно удалить, удалив файл из следующего расположения, где %LocalAppData% — это обычно ИмяДиска:\Users\ИмяПользователя\AppData\Local:

%LocalAppData%\Microsoft\VisualStudio\11.0\Extensions

См. также

Основные понятия

Практическое руководство. Определение профиля для расширения UML

Практическое руководство. Определение настраиваемого элемента панели элементов моделирования

Практическое руководство. Определение ограничений проверки для моделей UML

Практическое руководство. Определение команды меню на схеме моделирования