Sunday, May 31, 2009

Additional notes for exporting project template


Template Directory Setting

The default location on XP for VS.2008 for template storage is at
      %USERPROFILE%\My Documents\Visual Studio 2008\Templates

You can change this setting at the VS.2008 menu bar: Tools --> Options.
Projects and Solutions

Export Template and Location

Create a blank project, edit it, import and reference your vital libraries.  When you're done, go File menu to choose Export Template.... Follow the wizard to complete the rest.

A project template is always exported to the default output folder where you cannot change:
      %USERPROFILE%\My Documents\Visual Studio 2008\My Exported Templates

The location you set at Projects and Solutions is primarily for the IDE to locate and load your custom templates.

If you accept the default setting Automatically import the template into Visual Studio when you export the template, IDE will automatically save a copy under that template folder where Projects and Solutions specifies.

Additional Template Folders

Project Templates Location
For the first time project template creation, three (3) additional folders will be automatically created for your template organization:
  • Visual Basic
  • Visual C#
  • Visual Web Developer
And your template file will stay with them at the same directory level. In my example, it is MyC#WebApplication.zip.

I won't bother to put the template into one of those folders. You can drag the zip file into them if you want to organize it. As long as the template is under the template folder, the IDE is smart enough to loop through its sub-folders and find your template.

Edit Template Project Description

If you want to display a descriptive name on the IDE, go to the designated project templates folder and then do the editing. In my case, it is locate at H:\dev\Visual Studio 2008\Templates\ProjectTemplates.
  • Extract MyTemplate.vstemplate from the zip file and then open it for edit.
  • Locate <Name> and give descriptive name, e.g., My ASP.NET Web Application in C#
    <VSTemplate Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vstemplate/2005" Type="Project">
      <TemplateData>
        <Name>My ASP.NET Web Application in C#</Name>
        <Description>A C# Web Application with a specific port (.NET Framework 3.5)</Description>
        <ProjectType>CSharp</ProjectType>
        ...
    
  • Save it and then zip it back to the original zip file.
Now try to add a new project, you will see the new template shown under My Templates. Add New Template

No comments:

Post a Comment