Přidání značek do šablon projektů

Článek
01/13/2024

Od sady Visual Studio 2019 verze 16.1 Preview 2 můžete do šablon projektů přidat značky jazyka, platformy a typu projektu.

Značky se používají na dvou místech v dialogovém okně Nový projekt :

Značky se zobrazí pod popisem šablony.
Značky umožňují, aby byla šablona prohledána a filtrována.

Značky můžete přidat aktualizací souboru .vstemplate XML. Můžete použít značky šablon, které jsou integrované v sadě Visual Studio, nebo můžete vytvořit vlastní značky šablon. Značky šablon se zobrazí jenom v dialogovém okně Nový projekt sady Visual Studio 2019. Značky šablon nemají vliv na vykreslení šablony ve starších verzích sady Visual Studio.

Přidání nebo úprava značek

Pokud provedete jednu z následujících akcí, můžete chtít přidat nebo upravit značky v souboru XML šablony projektu .vstemplate :

Pomocí průvodce exportem šablony vytvořte novou šablonu projektu.
Aktualizujte existující šablonu projektu.
Vytvořte novou šablonu projektu VSIX.

Syntaxe

<LanguageTag> Language Name </LanguageTag>
<PlatformTag> Platform Name </PlatformTag>
<ProjectTypeTag> Project Type </ProjectTypeTag>

Atributy

V pokročilých uživatelských scénářích můžete použít následující volitelné atributy:

Atribut	Popis
`Package`	Identifikátor GUID, který určuje ID balíčku sady Visual Studio.
`ID`	Určuje ID prostředku sady Visual Studio.

Syntaxe:

<LanguageTag Package="{PackageID}" ID="ResourceID" />
<PlatformTag Package="{PackageID}" ID="ResourceID" />
<ProjectTypeTag Package="{PackageID}" ID="ResourceID" />

Elementy

Podřízené prvky

Nezaokrouhlovat.

Nadřazené prvky

Element (Prvek)	Popis
TemplateData	(Povinné) Kategorizuje šablonu a definuje, jak se zobrazí v dialogovém okně Nový projekt nebo v dialogovém okně Přidat novou položku .

Textová hodnota

Textová hodnota se vyžaduje, pokud nepoužíváte Package atributy.ID

Text obsahuje název šablony.

Předdefinované značky

Visual Studio nabízí seznam předdefinovaných značek. Když přidáte integrovanou značku, vykreslí značka lokalizovaný prostředek.

Následující seznam ukazuje předdefinované značky, které jsou k dispozici v sadě Visual Studio. Odpovídající hodnoty se zobrazují v závorkách.

Značka jazyka	Značka platformy	Značka typu projektu
C++ (`cpp`)	Android (`android`)	Cloud (`cloud`)
C# (`csharp`)	Azure (`azure`)	Konzola (`console`)
F# (`fsharp`)	iOS (`ios`)	Plocha (`desktop`)
Java (`java`)	Linux (`linux`)	Rozšíření (`extension`)
JavaScript (`javascript`)	macOS (`macos`)	Hry (`games`)
Python (`python`)	tvOS (`tvos`)	IoT (`iot`)
Dotazovací jazyk (`querylanguage`)	Windows (`windows`)	Knihovna (`library`)
TypeScript (`typescript`)	Windows App SDK (`windowsappsdk`)	Učení stroje (`machinelearning`)
Visual Basic (`visualbasic`)	Xbox (`xbox`)	Mobilní zařízení (`mobile`)
XAML (`xaml`)		Office (`office`)
		Jiné (`other`)
		Služba (`service`)
		Test (`test`)
		UPW (`uwp`)
		Web (`web`)
		WinUI (`winui`)

Příklad

Následující příklad ukazuje metadata šablony projektu pro aplikaci Visual C#:

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic template</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>csharp</ProjectType>
        <LanguageTag>csharp</LanguageTag>
        <PlatformTag>windows</PlatformTag>
        <PlatformTag>linux</PlatformTag>
        <PlatformTag>My Platform</PlatformTag>
        <ProjectTypeTag>console</ProjectTypeTag>
        <ProjectTypeTag>desktop</ProjectTypeTag>
    </TemplateData>
    <TemplateContent>
        <Project File="MyTemplate.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

Sdílet prostřednictvím