Creating Extensions By Using the VSIX Project Template

  • Article

You can use the VSIX Project template to create an extension or to package an existing extension for deployment. The VSIX Project template has both Visual Basic and Visual C# versions, and is installed as part of the Visual Studio SDK.

The VSIX Project template consists of a source.extension.vsixmanifest file, which contains information about the extension, and an AssemblyInfo.cs file, which contains information about the assembly.

To find the VSIX project template, you must install the Visual Studio 2012 SDK. For more information, see Visual Studio Software Development Kit (SDK).

Creating an Installable Project Template Extension By Using the VSIX Project Template

The following steps show how to use the VSIX project to package a project template that you can share with other developers or upload to the Visual Studio Gallery.

To create an installable project template extension by using the VSIX project template

  1. Create a project template.

    1. Open the project from which to create a template. This project can be of any project type.

    2. On the File menu, click Export Template. Complete the steps of the wizard.

      A .zip file is created in %USERPROFILE%\My Documents\Visual Studio 2012\My Exported Templates\.

  2. Create an empty VSIX project by using the VSIX project template.

    On the File menu, click New and then click Project. Select either Visual Basic or Visual C#, select Extensibility, and then select VSIX Project.

  3. Add the .zip file to the project. Set its Copy to Output Directory property to Copy Always.

  4. Double-click the source.extension.vsixmanifest file to open it in VSIX Manifest Designer, and then make the following changes:

    • Set the ID field to MyProjectTemplate - 1.

    • Set the Product Name field to My Project Template.

    • Set the Author field to Fabrikam.

    • Set the Description field to My project template.

    • In the Content section, add a Project Template content type and set its path to the name of the .zip file.

  5. Save and close the source.extension.vsixmanifest file.

  6. Build the project.

  7. In the output directory, double-click the .vsix file.

  8. A Visual Studio Extension Installer message box appears and asks whether you want to install the extension. Click Install.

  9. When the installation is finished, click Close.

  10. Close Visual Studio and then re-open it.

  11. Open Extension Manager (on the Tools menu). One of the available extensions should be My Project Template.

  12. The project template is installed in the same location as the project type that created it. For example, if you created the template from a Visual Basic console application, My Project Template appears together with the Visual Basic Console Application template.

To Specify the Location of the Template in the New Project Dialog Box

  1. Template folders are located in the Visual Studio Installation Path\Common7\IDE\ProjectTemplates and Visual Studio Installation Path\Common7\IDE\ItemTemplates directories. The names of the top level sections in the New Project dialog do not exactly match the names of the template folders. Where they differ, use the name of the template folder.

    In Windows Explorer, rename the .vsix file to have a .zip extension, and then open the file.

  2. Create a new folder with the same name as the section of the New Project dialog the template should appear in.

  3. If the template is to appear in a subsection, create a subfolder of the same name.

  4. Move the template .zip file into the new folder.

  5. Restore the modified .vsix file to its original name.

  6. Open the VSIX manifest.

  7. Update the Reference Element for the template to point to the root of the directory tree that contains the template .zip file. For example, if the template is in \CSharp\Windows, the reference should point to \CSharp.

See Also

Reference

Developing Visual Studio Extensions