Partager via


Creating Extensions By Using the VSIX Project Template

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 2013 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 <version>\My Exported Templates\.

  2. Create an empty VSIX project.

    On the File menu, click New and then click Project. Select either Visual Basic or Visual C#. Under the selected node, 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 the VSIX Manifest Designer, and then make the following changes:

    • Set the Product Name field to My Project Template.

    • Set the Product ID field to MyProjectTemplate - 1.

    • Set the Author field to Fabrikam.

    • Set the Description field to My project template.

    • In the Assets section, add a Microsoft.VisualStudio.ProjectTemplate 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 VSIX Installer message box appears. Follow the instructions to install the extension.

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

  10. Select Extensions and Updates (on the Tools menu) and select the Templates category. One of the available extensions should be My Project Template.

  11. The new project template appears in the New Project dialog in the same place as the original project template. For example, if you created a template named VB Console from a Visual Basic console application, VB Console appears in the same pane as 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, change the .vsix file extension to .zip, 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

Concepts

Developing Visual Studio Extensions