Как да създадете шаблони и разширения за проекти за 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 отидете на менюто Project и изберете опцията „Експортиране на шаблон“:

Има два типа шаблони: Шаблон на проекта и Шаблон на елемент. Както в нашия случай създаваме шаблон на проекта, аз избрах основната опция:

Следващата стъпка е да конфигурирате името, описанието, иконата, която ще бъде показана на потребителите и преглед на изображението. Наистина е важно да настроите правилно тази информация, колкото е възможно по-високо качество, защото тя ще се появи на крайните потребители, които ще изтеглят и инсталират вашия шаблон / разширение.

И премахнете отметката от опцията „Автоматично импортиране в Visual Studio“. По този начин ще можете да инсталирате разширението, което създавате.

И накрая, процесът ще генерира компактна папка, която съдържа самия шаблон, но това не е краят на създаването:

Определение на етикетите

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

Тъй като най-новата версия на Visual Studio 2019, тези маркери са задължителни за тези, които искат да публикуват разширение. Без тях разширението ще бъде инсталирано, но шаблонът никога няма да бъде показан в списъка, дори ако потребителят го търси.

За да създадете тези тагове, отворете компактната папка, генерирана с шаблона в последната стъпка и отворете .vstemplate файла с помощта на текстов редактор:

В секцията „Данни за шаблона“ добавете след тага „ProvideDefaultName“ препратката към списъка с маркери към вашия шаблон, като платформа, тип проект, език и т.н. В моя случай посочих, както следва:

Пълният списък с налични маркери може да бъде намерен на връзката по-долу:

Създаване на разширението

С вече създадения шаблон и зададените маркери, сега е време да създадете инсталационния файл за разширението.

За това просто създайте проект от типа VSIX Project:

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

PS: Въпреки това създадох името на проекта, използвайки определени специални символи като „+“, само за учебни цели, моля, избягвайте да го правите в реални сценарии. По-добре е да създавате без празни интервали или специални символи, като това: TemplateVueJSAspNetCoreArtigoMedium, вместо името, което поставям. Това ще предотврати проблеми с изграждането, защото VS ще генерира автоматично пространства от имена и класове, използвайки това име.

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

Този проект има файл с манифест, който ще съдържа информацията в инструкциите за инсталиране на разширението и.

Ако щракнете двукратно в този файл, той ще бъде отворен като формуляр, който можете да попълните поле по поле.

Променете внимателно цялата необходима информация с качество, защото тя ще се появи на крайния потребител и в инсталацията и на пазара. Също така е необходимо да се посочи правилно полето „Автор“, тъй като обикновено то има името LAPTOP.

След това кликнете върху „Активи“:

Извадете съществуващите активи, в случай че има такива, и кликнете върху „Ново“:

Изберете опциите, които поставям, и в пътя посочете компактната папка, която сте добавили към проекта.

Поколение

За да създадете инсталационния файл, той просто изгражда проекта в режим на освобождаване. Той ще генерира .exe файла, използван за инсталиране на разширението на VS.

Свършен! Нашето разширение беше създадено. Можете да го тествате сега, преди да публикувате на пазара на Visual Studio, за да видите дали всичко работи добре.

Visual Studio Market Publish

В случай, че искате да публикувате разширението си за обществеността, можете да го направите на 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