Начало работы с шаблоном проекта VSIX

  • Статья

Шаблон проекта VSIX можно использовать для создания расширения или упаковки существующего расширения для развертывания. Шаблон проекта VSIX содержит версии Visual Basic и Visual C# и устанавливается в составе пакета SDK Visual Studio.

Шаблон проекта VSIX состоит только из source.extension.vsixmanifest файла, содержащего сведения о расширении и ресурсах, которые он поставляет.

Чтобы найти шаблон проекта VSIX, необходимо установить пакет SDK Visual Studio. См. дополнительные сведения о пакете SDK для Visual Studio.

Развертывание пользовательского шаблона проекта с помощью шаблона проекта VSIX

Ниже показано, как использовать проект VSIX для упаковки шаблона проекта, который можно предоставить другим разработчикам или отправить в коллекцию Visual Studio.

  1. Создайте шаблон проекта.

    1. Откройте проект, из которого нужно создать шаблон. Этот проект может иметь любой тип проекта.

    2. В меню Проект выберите команду Экспорт шаблона. Выполните действия мастера.

      Файл .zip создается в %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\.

  2. Создайте пустой проект VSIX.

    Выберите File>New>Project ( Файл > Создать > Проект). В поле поиска введите vsix и выберите версию C# или Visual Basic проекта VSIX.

  3. Добавьте в проект файл .zip. Задайте для свойства Copy значение Copy AlwaysOutput Directory.

  4. В Обозреватель решений дважды щелкните файл source.extension.vsixmanifest, чтобы открыть его в конструкторе манифестов VSIX, а затем внесите следующие изменения:

    • Задайте для поля "Имя продукта" значение "Мой шаблон проекта".

    • Задайте для поля "Идентификатор продукта" значение MyProjectTemplate - 1.

    • Задайте для поля Author значение Fabrikam.

    • Задайте для поля "Описание" шаблон проекта "Мой".

    • В разделе "Активы" добавьте тип Microsoft.VisualStudio.ProjectTemplate и задайте путь к имени файла .zip.

  5. Сохраните и закройте файл source.extension.vsixmanifest.

  6. Выполните сборку проекта.

  7. В выходном каталоге дважды щелкните .vsix файл.

  8. Появится окно сообщения установщика VSIX. Следуйте инструкциям по установке расширения.

  9. Закройте Visual Studio, а затем откройте среду повторно.

  10. Выберите "Управление расширениями" (в меню "Расширения") и выберите категорию "Шаблоны". Одним из доступных расширений должен быть шаблон "Мой проект".

  11. Новый шаблон проекта отображается в диалоговом окне "Новый проект " в том же месте, что и исходный шаблон проекта. Например, если вы создали шаблон с именем консоли VB из консольного приложения Visual Basic, консоль VB появится в той же области, что и шаблон консольного приложения Visual Basic.

Указание расположения шаблона в диалоговом окне "Новый проект"

  1. Папки шаблонов находятся в {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates каталогах и {Visual Studio Installation Path}\Common7\IDE\ItemTemplates каталогах. Имена разделов верхнего уровня в диалоговом окне "Новый проект " не совпадают с именами папок шаблона. Где они отличаются, используйте имя папки шаблона.

    Измените .vsix расширение .zipфайла на , а затем откройте файл.

  2. Создайте новую папку с тем же именем, что и раздел диалогового окна "Новый проект" , в который должен появиться шаблон.

  3. Если шаблон будет отображаться в подразделе, создайте вложенную папку с тем же именем.

  4. Переместите файл шаблона .zip в новую папку.

  5. Измените .zip расширение .vsixна .

  6. Откройте манифест VSIX.

  7. В манифесте VSIX обновите путь ресурса шаблона, чтобы он указывает на корень дерева каталогов, содержащего файл шаблона. Например, если шаблон находится в \CSharp\Windows, ссылка должна указывать на \CSharp.