Jak vytvořit šablony projektu a rozšíření pro Visual Studio 2019

Ahoj!

Nedávno jsem vytvořil dvě projektové šablony pro Vue JS + Asp.Net Core, obě jako rozšíření Visual Studio 2019. Byli sdíleni na trhu Visual Studio, jak můžete vidět na odkazu níže:

  • Šablona Vue JS + Asp.Net Core 3.1

Chtěli byste vědět, jak vytvořit vlastní rozšíření a publikovat vlastní šablonu? Pokud ano, zbytek článku je postupným postupem, jak to udělat.

Vytvoření projektu

První věc, kterou musíte udělat, je vytvořit projekt, který chcete sdílet jako šablonu. V tomto článku ukážu krok za krokem projekt Vue JS + Asp.Net Core, který jsem již publikoval.

Export projektu

Po vytvoření projektu přejděte v nabídce Visual Studio 2019 do nabídky Project a vyberte možnost „Exportovat šablonu“:

Existují dva typy šablon: Šablona projektu a Šablona položky. Stejně jako v našem případě vytváříme šablonu projektu, vybral jsem základní možnost:

Dalším krokem je konfigurace názvu, popisu, ikony, která se zobrazí uživatelům a náhledu obrázku. Je opravdu důležité tyto informace správně nastavit, a to v nejvyšší možné kvalitě, protože se zobrazí konečným uživatelům, kteří si stáhnou a nainstalují vaši šablonu / příponu.

Zrušte zaškrtnutí políčka „Automaticky importovat do Visual Studio“. Tímto způsobem budete moci nainstalovat rozšíření, které vytváříte.

Nakonec proces vygeneruje kompaktní složku, která obsahuje samotnou šablonu, ale není to konec vytvoření:

Definice značek

Když vytváříme nový projekt v aplikaci Visual Studio 2019, zobrazí se šablony spolu s některými konkrétními značkami, které nám pomáhají filtrovat šablony:

Od nejnovější verze Visual Studio 2019 jsou tyto značky povinné pro ty, kteří chtějí publikovat rozšíření. Bez nich bude rozšíření nainstalováno, ale šablona nebude nikdy zobrazena v seznamu, i když to uživatel vyhledá.

Chcete-li vytvořit tyto značky, otevřete kompaktní složku, která byla vygenerována pomocí šablony v posledním kroku, a otevřete soubor .vstemplate pomocí textového editoru:

V sekci „Data šablon“ za značku „ProvideDefaultName“ přidejte odkaz na seznam šablon k vaší šabloně, jako je platforma, typ projektu, jazyk atd. V mém případě jsem uvedl následující:

Úplný seznam dostupných značek naleznete na níže uvedeném odkazu:

Vytvoření rozšíření

S již vytvořenou šablonou a nastavenými značkami je nyní třeba vytvořit instalační soubor pro příponu.

Za tímto účelem stačí vytvořit projekt typu Projekt VSIX:

Toto je základní struktura projektu:

PS: Název projektu jsem však vytvořil pomocí určitých speciálních znaků jako „+“, pouze pro účely výuky, prosím, vyhněte se tomu ve skutečných scénářích. Je lepší vytvořit bez prázdných mezer nebo speciálních znaků, například: TemplateVueJSAspNetCoreArtigoMedium, namísto jména, které jsem vložil. Zabrání se problémům se sestavením, protože VS bude automaticky generovat jmenné prostory a třídy pomocí tohoto názvu.

Zahrňte do kořenového adresáře odkaz na kompaktní složku na vaši šablonu. Je důležité, aby kompaktní složka obsahovala změny souboru .vstemplate se značkami, které jsem zmínil dříve. Nezapomeňte na to.

Tento projekt obsahuje soubor manifestu, který bude obsahovat informace o pokynech pro instalaci rozšíření.

Pokud na tento soubor dvakrát kliknete, otevře se jako formulář, do kterého můžete vyplnit pole po poli.

Pečlivě měňte všechny potřebné informace s kvalitou, protože se objeví i konečnému uživateli v instalaci a na trhu. Také je nutné správně zadat pole „Autor“, protože obvykle má název LAPTOP.

Poté klikněte na „Aktiva“:

Odstraňte existující aktiva, pokud existují, a klikněte na „Nový“:

Vyberte možnosti, které jsem vložil, a do cesty určete kompaktní složku, kterou jste do projektu přidali.

Generace

Chcete-li vytvořit instalační soubor, staví projekt pouze v režimu vydání. Generuje soubor .exe používaný k instalaci přípony na VS.

Hotovo! Naše rozšíření bylo vytvořeno. Můžete to vyzkoušet hned před publikováním na trhu Visual Studio, abyste zjistili, zda všechno funguje dobře.

Publikování trhu Visual Studio Market

V případě, že chcete své rozšíření zveřejnit, můžete to udělat na Visual Studio Marketplace.

Chcete-li to provést, přejděte na adresu marketplace.visualstudio.com a po přihlášení pomocí svého účtu Microsoft přejděte na níže uvedené možnosti:

Nahrajte .exe rozšíření:

Vyplňte formulář šablonou a informacemi o rozšíření. Protože tyto informace budou veřejné, věnujte pozornost podrobně.

Po dokončení procesu uložte a počkejte na proces schválení. To by mohlo trvat několik minut.

Závěr

Doufám, že vám tento článek pomohl. Děkuji za přečtení.

Níže jsou mé profily sociálních médií. Nebojte se připojit a položit otázku. V těchto profilech často sdílím obsah o webových technologiích a událostech IT.

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

Nedávno jsem také vytvořil kanál YouTube, abych přispěl do technické komunity pomocí této platformy a zaměřil se na .NET Core, Vue JS, Azure a další. Pokud vás tyto předměty zajímají, doporučujeme se přihlásit. Obsah bude brzy vydáván pravidelně, zatímco nastavuji zvuk, video a obsah, abych vám poskytl vysoce kvalitní zážitek.

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