Hur man skapar projektmallar och tillägg för Visual Studio 2019

Hej!

Nyligen skapade jag två projektmallar för Vue JS + Asp.Net Core, båda som Visual Studio 2019-tillägg. De delades på Visual Studio-marknaden, som du kan se på länken nedan:

  • Mall Vue JS + Asp.Net Core 3.1

Vill du veta hur du skapar ditt eget tillägg och publicerar din egen mall? Om ja, resten av artikeln är en steg för steg-process för hur du gör det.

Projekt skapande

Det första du måste göra är att skapa ett projekt som du vill dela som en mall. I den här artikeln kommer jag att visa steg för steg med Vue JS + Asp.Net Core-projektet som jag redan publicerade.

Projekt export

När projektet har skapats, gå till Visual Studio 2019 till alternativet Project meny och välj alternativet "Exportera mall":

Det finns två typer av mallar: Projektmall och Objektmall. Som i vårt fall skapar vi en projektmall, jag valde det underliggande alternativet:

Nästa steg är att konfigurera namn, beskrivning, ikon som kommer att visas för användare och förhandsgranska bilden. Det är verkligen viktigt att ställa in denna information korrekt, så mycket som du kan, för den kommer att visas för slutanvändare som kommer att ladda ner och installera din mall / tillägg.

Och avmarkera alternativet "Automatiskt importera till Visual Studio". På det sättet kan du installera tillägget som du skapar.

Slutligen kommer processen att generera en kompakt mapp som innehåller själva mallen, men det är inte slutet på skapelsen:

Definition av taggar

När vi skapar ett nytt projekt på Visual Studio 2019 visas mallarna tillsammans med vissa specifika taggar som hjälper oss att filtrera mallarna:

Sedan den senaste versionen av Visual Studio 2019 är dessa taggar obligatoriska för de som vill publicera ett tillägg. Utan dessa kommer tillägget att installeras, men mallen visas aldrig i listan, även om användaren söker efter det.

För att skapa dessa taggar, öppnar du den kompakta mappen som genererades med mallen i det sista steget och öppnar .vstemplate-filen med en texteditor:

I avsnittet "Malldata" lägger du till taggen "ProvideDefaultName" efter taggen med referens till din mall, till exempel plattform, projekttyp, språk osv. I mitt fall specificerade jag följande:

Den fullständiga tillgängliga taglistan finns på länken nedan:

Skapandet av tillägget

När mallen redan skapats och taggarna är inställda är det nu dags att skapa installationsfilen för tillägget.

För det skapar du bara ett projekt av typen VSIX-projekt:

Detta är projektets grundläggande struktur:

PS: Men jag skapade projektnamnet med hjälp av vissa specialtecken som "+", bara för undervisningsändamål. Undvik att göra det i riktiga scenarier. Det är bättre att skapa utan några tomma utrymmen eller specialtecken, som det: MallVueJSAspNetCoreArtigoMedium, istället för det namn jag sätter. Det kommer att förhindra byggproblem, på grund av att VS genererar automatiskt namnutrymmen och klasser med det namnet.

Inkludera i roten den kompakta mappreferensen till din mall. Det är viktigt att den kompakta mappen innehåller .vstemplate-filändringarna med taggarna som jag nämnde tidigare. Glöm inte det.

Detta projekt har en manifestfil som kommer att innehålla informationen i installationsanvisningarna för tillägg e.

Om du dubbelklickar i den filen kommer den att vara öppen som ett formulär, vilket du kan fylla i fält för fält.

Ändra noggrant all nödvändig information med kvalitet, eftersom den också kommer att visas för den slutliga användaren på installation och marknadsplats. Det är också nödvändigt att ange fältet "Författare" på rätt sätt, eftersom det normalt har LAPTOP-namnet.

Klicka sedan på “Tillgångar”:

Ta bort befintliga tillgångar, om det finns sådana, och klicka på "Ny":

Välj alternativen som jag lägger och ange i den sökväg den kompakta mappen som du har lagt till i projektet.

Generation

För att skapa installationsfilen bygger det bara projektet i släppläge. Det kommer att generera .exe-filen som används för att installera tillägget på VS.

Gjort! Vår tillägg skapades. Du kan testa det nu innan du publicerar på Visual Studio-marknaden för att se om allt fungerar bra.

Visual Studio Market Publicera

Om du vill publicera din anknytning till allmänheten kan du göra det på Visual Studio Marketplace.

För att göra det går du till marketplace.visualstudio.com och, efter inloggning med ditt Microsoft-konto, gå till alternativen nedan:

Ladda upp .exe för din anknytning:

Fyll i formuläret med mallen och tilläggsinfo. Eftersom denna information kommer att vara offentlig, var uppmärksam på i detalj.

När processen är klar sparar du bara och väntar på godkännandeprocessen. Det kan ta några minuter.

Slutsats

Jag hoppas att den här artikeln hjälpte dig. Tack för att du läste den.

Nedan följer mina sociala medieprofiler. Känn dig fri att ansluta och ställa en fråga. I dessa profiler delar jag ofta innehåll om webbteknologier och IT-evenemang.

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

Jag skapade nyligen en Youtube-kanal för att bidra till den tekniska gemenskapen med denna plattform också, fokuserad på .NET Core, Vue JS, Azure och mer. Om du är intresserad av dessa ämnen rekommenderar jag att du prenumererar. Snart släpps innehåll regelbundet medan jag ställer in ljud, video och innehåll för att ge dig en högkvalitativ upplevelse.

Länk: https://www.youtube.com/channel/UC-KFGgYiot1eA8QFqIgLmqA