Adición de etiquetas en plantillas de proyecto

Artículo
01/13/2024

A partir de Visual Studio 2019, versión 16.1 Preview 2, puede agregar etiquetas de tipo de proyecto, plataforma y lenguaje a las plantillas de proyecto.

Las etiquetas se usan en dos lugares del cuadro de diálogo Nuevo proyecto:

Las etiquetas aparecen en la descripción de la plantilla.
Las etiquetas permiten filtrar la plantilla y realizar búsquedas en ella.

Para agregar etiquetas, actualice el archivo XML .vstemplate. Puede usar etiquetas de plantilla integradas en Visual Studio, o bien crear etiquetas de plantilla personalizadas. Las etiquetas de plantilla solo aparecen en el cuadro de diálogo Nuevo proyecto de Visual Studio 2019. Las etiquetas de plantilla no afectan al modo de representar la plantilla en versiones anteriores de Visual Studio.

Adición o edición de etiquetas

Es posible que quiera agregar o editar etiquetas en el archivo XML .vstemplate de la plantilla del proyecto al realizar las siguientes acciones:

Crear una nueva plantilla de proyecto mediante el Asistente para exportar plantillas.
Actualizar la plantilla de proyecto existente.
Crear una nueva plantilla de proyecto VSIX.

Sintaxis

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

Atributos

Puede usar los siguientes atributos opcionales en escenarios de usuario avanzado:

Atributo	Descripción
`Package`	Un identificador GUID que especifica el id. paquete de Visual Studio.
`ID`	Especifica el identificador de recurso de Visual Studio.

Sintaxis:

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

Elementos

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
TemplateData	(Obligatorio) Clasifica la plantilla y define cómo se muestra en el cuadro de diálogo Nuevo proyecto o Agregar nuevo elemento.

Valor de texto

Se requiere un valor de texto, a menos que use los atributos Package y ID.

El texto proporciona el nombre de la plantilla.

Etiquetas integradas

Visual Studio ofrece una lista de etiquetas integradas. Al agregar una etiqueta integrada, esta representa un recurso localizado.

En la siguiente lista se muestran las etiquetas integradas disponibles en Visual Studio. Los valores correspondientes se muestran entre paréntesis.

Etiqueta de idioma	Etiqueta de plataforma	Etiqueta de tipo de proyecto
C++ (`cpp`)	Android (`android`)	Nube (`cloud`)
C# (`csharp`)	Azure (`azure`)	Consola (`console`)
F# (`fsharp`)	iOS (`ios`)	Escritorio (`desktop`)
Java (`java`)	Linux (`linux`)	Extensiones (`extension`)
JavaScript (`javascript`)	macOS (`macos`)	Juegos (`games`)
Python (`python`)	tvOS (`tvos`)	IoT (`iot`)
Lenguaje de consulta (`querylanguage`)	Windows (`windows`)	Biblioteca (`library`)
TypeScript (`typescript`)	SDK de Aplicaciones para Windows (`windowsappsdk`)	Machine Learning (`machinelearning`)
Visual Basic (`visualbasic`)	Xbox (`xbox`)	Para dispositivos móviles (`mobile`)
XAML (`xaml`)		Office (`office`)
		Otros (`other`)
		Servicio (`service`)
		Prueba (`test`)
		UWP (`uwp`)
		Web (`web`)
		WinUI (`winui`)

Ejemplo

El ejemplo siguiente muestra los metadatos de una plantilla de proyecto para una aplicación 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>

Share via