Cómo: Publicar plantillas de proyectos

Artículo
10/07/2008

Actualización: noviembre 2007

Para que una plantilla aparezca en el cuadro de diálogo Nuevo proyecto, debe estar instalada en la ubicación correcta del equipo. Para facilitar este proceso, puede colocar el archivo .zip de plantilla dentro de un archivo de Visual Studio Installer (.vsi) y dejar que el Instalador de contenido de Visual Studio se encargue de colocar la plantilla en la ubicación correcta. Además, el uso de un archivo .vsi permite compartir la plantilla (u otros componentes para Visual Studio) con otros programadores.

Archivos .VSI

Un archivo .vsi es un archivo .zip en cuyo nombre se ha cambiado la extensión de nombre de archivo. .Los archivos .vsi contienen lo siguiente:

Un archivo XML que describe el contenido. Este archivo debe tener la extensión de nombre de archivo .vscontent y debe seguir un esquema XML específico. Para ver una definición completa del esquema XML de .vscontent, consulte Cómo: Empaquetar componentes de la comunidad para utilizar el instalador de contenido de Visual Studio.
Los archivos de contenido, por ejemplo, un archivo .zip. Para obtener información sobre cómo crear archivos .zip de plantilla, consulte Crear plantillas de proyectos y de elementos.

Para obtener más información sobre cómo instalar archivos .vsi, consulte Cómo: Instalar componentes de la comunidad.

Debe establecer los valores y atributos específicos de la plantilla en el archivo .vscontent, para que el Instalador de contenido de Visual Studio sepa cómo y dónde instalarla. En el archivo .vscontent de una plantilla debe hacer lo siguiente:

Establecer el valor del elemento FileContentType en VSTemplate.
Agregar un elemento Attribute que tenga los atributos siguientes:
- Atributo ProjectType: especifica el tipo de proyecto, que puede ser Visual Basic, Visual C# o Visual Web Developer.
- Atributo ProjectSubType: especifica la subcategoría en la que se mostrará la plantilla en el cuadro de diálogo Nuevo proyecto.
- Atributo TemplateType: especifica el tipo de plantilla, que puede ser Project o Item.

Para crear un archivo .vsi de plantilla

Cree un archivo .vscontent válido para el contenido. Para obtener más información acerca del esquema de archivo .vscontent, consulte Cómo: Empaquetar componentes de la comunidad para utilizar el instalador de contenido de Visual Studio.
Seleccione el archivo .vscontent y los demás archivos que desea incluir en el archivo .vsi. Haga clic con el botón secundario en la selección, y haga clic sucesivamente en Enviar a y en Carpeta comprimida (en zip). Los archivos seleccionados se comprimen en un único archivo .zip.

Cambie la extensión del nombre de archivo .zip a .vsi.

Nota:
Para mostrar la información del editor de la plantilla acerca del proyecto en el Instalador de contenido de Visual Studio, deberá firmar el archivo .vsi. Para obtener más información, póngase en contacto con el proveedor del certificado digital.

Ejemplo

En el ejemplo siguiente se muestra el archivo .vscontent de un archivo .vsi que contiene una plantilla de proyecto. Para este contenido, el archivo .vsi incluirá los siguientes archivos:

Un archivo .vscontent que contiene el código de este ejemplo.
Una plantilla de proyecto, MyProjectTemplate.zip.

En este ejemplo, la plantilla se instalará en la categoría Visual Basic raíz del cuadro de diálogo Nuevo proyecto. Si prefiere instalar la plantilla en una subcategoría de Visual Basic, debe especificar el nombre de la subcategoría como valor del atributo ProjectSubType.

Nota:
En el ejemplo siguiente se utiliza el valor 2.0 para el elemento ContentVersion. Si la plantilla de proyecto podrán utilizarla tanto Visual Studio 2005 como Visual Studio 2008, utilice el valor 1.0. Si la plantilla de proyecto es específica de Visual Studio 2008, utilice 2.0.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyProjectTemplate.zip</FileName>
        <DisplayName>Sample Project Template</DisplayName>
        <Description>A project template created for this example.</Description>
        <FileContentType>VSTemplate</FileContentType>
        <ContentVersion>2.0</ContentVersion>
        <Attributes>
            <Attribute name="ProjectType" value="Visual Basic"/>
            <Attribute name="ProjectSubType" value=""/>
            <Attribute name="TemplateType" value="Project"/>
        </Attributes>
    </Content>
</VSContent>

Vea también

Tareas

Cómo: Empaquetar componentes de la comunidad para utilizar el instalador de contenido de Visual Studio

Otros recursos

Procedimientos avanzados de plantillas

Compartir a través de