Ako vytvoriť šablóny projektu a rozšírenie pre Visual Studio 2019

Ahoj!

Nedávno som vytvoril dve projektové šablóny pre Vue JS + Asp.Net Core, obe ako rozšírenia Visual Studio 2019. Zdieľali ich na trhu Visual Studio, ako vidíte na nižšie uvedenom odkaze:

  • Šablóna Vue JS + Asp.Net Core 3.1

Chceli by ste vedieť, ako vytvoriť vlastné rozšírenie a zverejniť svoju vlastnú šablónu? Ak áno, zvyšok článku je postupným postupom, ako to urobiť.

Tvorba projektu

Prvá vec, ktorú musíte urobiť, je vytvoriť projekt, ktorý chcete zdieľať ako šablónu. V tomto článku ukážem krok za krokom projekt Vue JS + Asp.Net Core, ktorý som už publikoval.

Export projektu

Po vytvorení projektu prejdite v ponuke Visual Studio 2019 do ponuky Project a vyberte možnosť „Export Template“:

Existujú dva typy šablón: Šablóna projektu a Šablóna položky. Rovnako ako v našom prípade vytvárame šablónu projektu, vybral som základnú možnosť:

Ďalším krokom je konfigurácia mena, popisu, ikony, ktorá sa zobrazí používateľom a ukážky obrázka. Je skutočne dôležité správne nastaviť tieto informácie v maximálnej možnej kvalite, pretože sa zobrazia koncovým používateľom, ktorí si stiahnu a nainštalujú vašu šablónu / príponu.

A zrušte začiarknutie možnosti „Automaticky importovať do Visual Studio“. Týmto spôsobom budete môcť nainštalovať rozšírenie, ktoré vytvárate.

Nakoniec proces vygeneruje kompaktný priečinok, ktorý obsahuje samotnú šablónu, ale nejde o koniec vytvorenia:

Definícia značiek

Keď vytvárame nový projekt na Visual Studio 2019, šablóny sa objavia spolu s niektorými konkrétnymi značkami, ktoré nám pomáhajú filtrovať šablóny:

Od poslednej verzie programu Visual Studio 2019 sú tieto značky povinné pre tých, ktorí chcú publikovať rozšírenie. Bez nich sa rozšírenie nainštaluje, ale šablóna sa v zozname nebude nikdy zobrazovať, a to ani vtedy, keď to používateľ vyhľadá.

Ak chcete vytvoriť tieto značky, otvorte kompaktný priečinok, ktorý bol vygenerovaný so šablónou v poslednom kroku, a otvorte súbor .vstemplate pomocou textového editora:

V časti „Údaje šablóny“ za značku „ProvideDefaultName“ pridajte odkaz na zoznam šablón na svoju šablónu, ako je platforma, typ projektu, jazyk atď. V mojom prípade som špecifikoval toto:

Úplný zoznam dostupných značiek nájdete na nižšie uvedenom odkaze:

Vytvorenie rozšírenia

S už vytvorenou šablónou a nastavenými značkami je teraz potrebné vytvoriť inštalačný súbor pre príponu.

Za týmto účelom vytvorte projekt typu VSIX Project:

Toto je základná štruktúra projektu:

PS: Názov projektu som však vytvoril pomocou určitých špeciálnych znakov ako „+“, iba na účely výučby. Vyhnite sa tomu v skutočných scenároch. Je lepšie vytvárať bez prázdnych medzier alebo špeciálnych znakov, napríklad: TemplateVueJSAspNetCoreArtigoMedium, namiesto mena, ktoré som dal. Zabráni tým problémom so zostavovaním, pretože VS bude automaticky generovať menné priestory a triedy s použitím tohto názvu.

Zahrňte do koreňového adresára odkaz na kompaktný priečinok na svoju šablónu. Je dôležité, aby kompaktný priečinok obsahoval zmeny súboru .vstemplate so značkami, ktoré som už spomenul. Nezabudnite na to.

Tento projekt obsahuje súbor manifestu, ktorý bude obsahovať informácie o inštalačných pokynoch pre rozšírenie.

Ak na tento súbor dvakrát kliknete, otvorí sa ako formulár, do ktorého môžete vyplniť pole po poli.

Dôkladne zmeňte všetky potrebné informácie s kvalitou, pretože sa objavia aj konečnému používateľovi v inštalácii a na trhu. Je tiež potrebné správne uviesť pole „Autor“, pretože zvyčajne má názov LAPTOP.

Potom kliknite na „Aktíva“:

Ak existujú, odstráňte existujúce aktíva a kliknite na „Nové“:

Vyberte možnosti, ktoré vložím, a do cesty zadajte kompaktný priečinok, ktorý ste do projektu pridali.

generácie

Ak chcete vytvoriť inštalačný súbor, iba stavia projekt do režimu vydania. Generuje súbor .exe používaný na inštaláciu prípony na VS.

Hotový! Naše rozšírenie bolo vytvorené. Pred zverejnením na trhu Visual Studio si môžete vyskúšať, či všetko funguje dobre.

Publikovanie trhu Visual Studio

Ak chcete svoje rozšírenie zverejniť pre verejnosť, môžete to urobiť na Visual Studio Marketplace.

Ak to chcete urobiť, prejdite na adresu marketplace.visualstudio.com a po prihlásení pomocou svojho účtu Microsoft prejdite na nasledujúce možnosti:

Nahrajte .exe prípony:

Vyplňte formulár pomocou šablóny a informácií o rozšírení. Keďže tieto informácie budú verejné, venujte osobitnú pozornosť.

Po dokončení procesu jednoducho uložte a čakajte na proces schválenia. Môže to trvať niekoľko minút.

záver

Dúfam, že vám tento článok pomohol. Ďakujem za prečítanie.

Nižšie sú uvedené moje profily sociálnych médií. Neváhajte sa spojiť a položiť otázku. V týchto profiloch často zdieľam obsah o webových technológiách a IT udalostiach.

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

Nedávno som tiež vytvoril kanál YouTube, aby som prispel do technickej komunity využívajúcej túto platformu. Zameral som sa na .NET Core, Vue JS, Azure a ďalšie. Ak vás tieto predmety zaujímajú, odporúčame vám prihlásiť sa na odber. Obsah bude čoskoro vydávaný pravidelne, zatiaľ čo nastavujem zvuk, video a obsah, aby som vám dal vysoko kvalitný zážitok.

Odkaz: https://www.youtube.com/channel/UC-KFGgYiot1eA8QFqIgLmqA