Cómo: Crear plantillas de varios proyectos

Artículo
08/10/2011

Las plantillas de varios proyectos actúan como contenedores de dos o más proyectos. Cuando se crea un proyecto basado en una plantilla de varios proyectos desde el cuadro de diálogo Nuevo proyecto, todos los proyectos de la plantilla se agregan a la solución.

Una plantilla de varios proyectos debe incluir los elementos siguientes, comprimidos en un archivo .zip:

Un archivo .vstemplate raíz para la plantilla de varios proyectos completa. Este archivo .vstemplate raíz contiene los metadatos que se muestran en el cuadro de diálogo Nuevo proyecto y especifica dónde encontrar los archivos .vstemplate de los proyectos de la plantilla. Este archivo debe estar en la raíz del archivo .zip.
Una o más carpetas que contienen los archivos que son necesarios para una plantilla de proyecto completa. Esto incluye todos los archivos de código del proyecto, así como un archivo .vstemplate para el proyecto.

Por ejemplo, un archivo .zip de plantilla de varios proyectos que contenga dos proyectos podría tener los archivos y directorios siguientes:

MultiProjectTemplate.vstemplate

\Project1\Project1.vstemplate

\Project1\Project1.vbproj

\Project1\Class.vb

\Project2\Project2.vstemplate

\Project2\Project2.vbproj

\Project2\Class.vb

El archivo .vstemplate raíz de una plantilla de varios proyectos se diferencia del de una plantilla de un solo proyecto en lo siguiente:

El atributo Type del elemento VSTemplate contiene el valor ProjectGroup. Por ejemplo:

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">

El elemento TemplateContent contiene un elemento ProjectCollection que tiene uno o varios elementos ProjectTemplateLink que definen las rutas de acceso a los archivos .vstemplate de los proyectos incluidos. Por ejemplo:

<TemplateContent>
    <ProjectCollection>
        <ProjectTemplateLink>
            Project1\Project1.vstemplate
        </ProjectTemplateLink>
        <ProjectTemplateLink>
            Project2\Project2.vstemplate
        </ProjectTemplateLink>
    </ProjectCollection>
</TemplateContent>

Las plantillas de varios proyectos también se comportan de manera diferente que las normales. Las plantillas de varios proyectos tienen las siguientes características específicas:

No se puede asignar nombres a los proyectos individuales de una plantilla de varios proyectos desde el cuadro de diálogo Nuevo proyecto. En su lugar, utilice el atributo ProjectName del elemento ProjectTemplateLink para especificar el nombre de cada proyecto. Para obtener más información, vea el primer ejemplo de la sección siguiente.
Las plantillas de varios proyectos pueden contener proyectos escritos en distintos lenguajes, pero la plantilla completa propiamente dicha solo se puede colocar en una categoría mediante el elemento ProjectType.

Para crear una plantilla de varios proyectos

Cree los proyectos que desee incluir en la plantilla de varios proyectos.
Cree archivos .vstemplate para cada proyecto. Para obtener más información, vea Cómo: Crear plantillas de proyectos y Cómo: Crear plantillas de proyecto manualmente.
Cree un archivo .vstemplate raíz para contener los metadatos de la plantilla de varios proyectos. Para obtener más información, vea el primer ejemplo de la sección siguiente.
Seleccione los archivos y las carpetas incluidos en la plantilla, haga clic con el botón secundario del mouse en la selección, haga clic en Enviar a y, a continuación, haga clic en Carpeta comprimida (en zip). Los archivos y las carpetas se comprimen en un archivo .zip.
Coloque el archivo de plantilla .zip en el directorio de plantillas de proyecto de Visual Studio. De manera predeterminada, este directorio es \Mis documentos\Visual Studio 2010\Templates\ProjectTemplates\.

Ejemplo

En este ejemplo se muestra un archivo .vstemplate raíz básico de varios proyectos. En este ejemplo, la plantilla contiene dos proyectos, My Windows Application y My Class Library. El atributo ProjectName del elemento ProjectTemplateLink establece el nombre que Visual Studio debe asignar a este proyecto. Si el atributo ProjectName no existe, se utiliza el nombre del archivo .vstemplate como nombre del proyecto.

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-Project Template Sample</Name>
        <Description>An example of a multi-project template</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectCollection>
            <ProjectTemplateLink ProjectName="My Windows Application">
                WindowsApp\MyTemplate.vstemplate
            </ProjectTemplateLink>
            <ProjectTemplateLink ProjectName="My Class Library">
                ClassLib\MyTemplate.vstemplate
            </ProjectTemplateLink>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Este ejemplo utiliza el elemento SolutionFolder para dividir los proyectos en dos grupos, Math Classes y Graphics Classes. La plantilla contiene cuatro proyectos, dos de los cuales se encuentran en cada carpeta de soluciones.

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-Project Template Sample</Name>
        <Description>An example of a multi-project template</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectCollection>
            <SolutionFolder Name="Math Classes">
                <ProjectTemplateLink ProjectName="MathClassLib1">
                    MathClassLib1\MyTemplate.vstemplate
                </ProjectTemplateLink>
                <ProjectTemplateLink ProjectName="MathClassLib2">
                    MathClassLib2\MyTemplate.vstemplate
                </ProjectTemplateLink>
            </SolutionFolder>
            <SolutionFolder Name="Graphics Classes">
                <ProjectTemplateLink ProjectName="GraphicsClassLib1">
                    GraphicsClassLib1\MyTemplate.vstemplate
                </ProjectTemplateLink>
                <ProjectTemplateLink ProjectName="GraphicsClassLib2">
                    GraphicsClassLib2\MyTemplate.vstemplate
                </ProjectTemplateLink>
            </SolutionFolder>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Vea también

Compartir a través de

Cómo: Crear plantillas de varios proyectos

Para crear una plantilla de varios proyectos

Ejemplo

Vea también

Tareas

Referencia

Otros recursos

Recursos adicionales