Как создавать шаблоны проектов и расширения для Visual Studio 2019

Здравствуй!

Недавно я создал два шаблона проекта для Vue JS + Asp.Net Core, оба из которых являются расширениями Visual Studio 2019. Они были опубликованы на торговой площадке Visual Studio, как вы можете видеть по ссылке ниже:

  • Шаблон Vue JS + Asp.Net Core 3.1

Хотите знать, как создать собственное расширение и опубликовать собственный шаблон? Если да, то остальная часть статьи представляет собой пошаговый процесс о том, как это сделать.

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

Первое, что вам нужно сделать, это создать проект, которым вы хотите поделиться как шаблон. В этой статье я покажу шаг за шагом, используя проект Vue JS + Asp.Net Core, который я уже опубликовал.

Экспорт проекта

После создания проекта в Visual Studio 2019 перейдите в пункт меню «Проект» и выберите «Экспорт шаблона»:

Существует два типа шаблонов: шаблон проекта и шаблон элемента. Так как в нашем случае мы создаем шаблон проекта, я выбрал базовую опцию:

Следующим шагом является настройка имени, описания, значка, который будет отображаться пользователям, и предварительного просмотра изображения. Очень важно правильно настроить эту информацию, насколько это возможно, потому что она будет доступна конечным пользователям, которые загрузят и установят ваш шаблон / расширение.

И снимите флажок «Автоматически импортировать в Visual Studio». Таким образом, вы сможете установить создаваемое расширение.

Наконец, процесс создаст компактную папку, которая содержит сам шаблон, но это не конец создания:

Определение тегов

Когда мы создаем новый проект в Visual Studio 2019, шаблоны появляются вместе с некоторыми конкретными тегами, которые помогают нам фильтровать шаблоны:

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

Чтобы создать эти теги, откройте компактную папку, созданную с помощью шаблона на последнем шаге, и откройте файл .vstemplate с помощью текстового редактора:

В разделе «Данные шаблона» добавьте после тега «ProvideDefaultName» ссылку на список тегов для вашего шаблона, например платформу, тип проекта, язык и т. Д. В моем случае я указал следующее:

Полный список доступных тегов можно найти по ссылке ниже:

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

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

Для этого просто создайте проект типа VSIX Project:

Это основная структура проекта:

PS: однако я создал название проекта, используя определенные специальные символы как «+», просто для учебных целей, пожалуйста, избегайте делать это в реальных сценариях. Лучше создавать без каких-либо пустых мест или специальных символов, например: TemplateVueJSAspNetCoreArtigoMedium, вместо имени, которое я поставил. Это предотвратит проблемы со сборкой, потому что VS будет автоматически генерировать пространства имен и классы, использующие это имя.

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

Этот проект имеет файл манифеста, который будет содержать информацию о расширении и инструкции по установке.

Если дважды щелкнуть этот файл, он будет открыт как форма, которую вы можете заполнить поле за полем.

Тщательно измените всю необходимую информацию качественно, так как она будет отображаться конечному пользователю в установке и на торговой площадке. Кроме того, необходимо правильно указать поле «Автор», поскольку оно обычно имеет имя LAPTOP.

После этого нажмите на «Активы»:

Удалите существующие активы, если они есть, и нажмите «Создать»:

Выберите параметры, которые я поставил, и в пути укажите компактную папку, которую вы добавили в проект.

поколение

Чтобы создать установочный файл, это просто сборка проекта в режиме выпуска. Он сгенерирует файл .exe, используемый для установки расширения на VS.

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

Visual Studio Market Опубликовать

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

Для этого перейдите на marketplace.visualstudio.com и, после входа в свою учетную запись Microsoft, перейдите к следующим параметрам:

Загрузите .exe вашего расширения:

Заполните форму с информацией о шаблоне и расширении. Поскольку эта информация будет общедоступной, обратите внимание подробно.

Как только процесс завершится, просто сохраните и дождитесь процесса утверждения. Это может занять несколько минут.

Вывод

Я надеюсь, что эта статья помогла вам. Спасибо, что прочитали это.

Ниже приведены мои профили в социальных сетях. Не стесняйтесь подключиться и задать вопрос. В этих профилях я часто делюсь информацией о веб-технологиях и ИТ-событиях.

Twitter: https://twitter.com/alemalavasi Linkedin: https://www.linkedin.com/in/alexandremalavasi/

Я также недавно создал канал Youtube, чтобы внести свой вклад в техническое сообщество, использующее эту платформу, и сфокусированный на .NET Core, Vue JS, Azure и других. Если вы заинтересованы в этих темах, я рекомендую вам подписаться. Скоро будет регулярно выпускаться контент, пока я настраиваю аудио, видео и контент, чтобы дать вам качественный опыт.

Ссылка: https://www.youtube.com/channel/UC-KFGgYiot1eA8QFqIgLmqA