如何:发布项目模板
更新:2007 年 11 月
若要使模板显示在“新建项目”对话框中,必须将其安装在计算机上的正确位置。若要使此过程更加轻松,可将您的模板 .zip 文件放在 Visual Studio 安装程序 (.vsi) 文件中,然后让 Visual Studio 内容安装程序将该模板放置在正确的位置。还可以通过使用 .vsi 文件与其他开发人员共享您的模板(或 Visual Studio 的其他模板)。
.VSI 文件
.vsi 文件是一个具有重命名的文件扩展名的 .zip 文件。.vsi 文件包含以下内容:
描述内容的 .xml 文件。此文件必须具有文件扩展名 .vscontent,且必须遵循特定的 XML 架构。有关 .vscontent XML 架构的完整定义,请参见如何:打包社区组件以使用 Visual Studio 内容安装程序。
内容文件:例如,模板 .zip 文件。有关创建模板 .zip 文件的信息,请参见创建项目模板和项模板。
有关如何安装 .vsi 文件的更多信息,请参见如何:安装社区组件。
您必须在模板的 .vscontent 文件中设置特定的值和属性,以便 Visual Studio 内容安装程序了解安装该模板的方式和位置。在模板的 .vscontent 文件中,您必须执行下列操作:
将 FileContentType 元素的值设置为 VSTemplate。
添加一个具有以下属性的 Attribute 元素:
ProjectType 属性:指定项目类型为 Visual Basic、Visual C# 或 Visual Web Developer。
ProjectSubType 属性:指定在其中显示“新建项目”对话框中的模板的子类别。
TemplateType 属性:指定模板的类型为 Project 或 Item。
创建一个模板 .vsi 文件
为内容创建一个有效的 .vscontent 文件。有关 .vscontent 文件架构的更多信息,请参见如何:打包社区组件以使用 Visual Studio 内容安装程序。
选择 .vscontent 文件和要包括在 .vsi 文件中的其他文件。右击所选的文件,单击“发送到”,然后单击“压缩(zipped)文件夹”。所选文件被压缩为一个 .zip 文件。
将 .zip 文件的文件扩展名重命名为 .vsi。
说明: 若要在 Visual Studio 内容安装程序中显示有关您的项目模板的出版商信息,必须为 .vsi 文件签名。有关更多信息,请与数字证书供应商联系。
示例
下面的示例为包含项目模板的 .vsi 文件显示 .vscontent 文件。下列文件将包含在此内容的 .vsi 文件中:
包含此示例中的代码的 .vscontent 文件。
项目模板 MyProjectTemplate.zip。
在此示例中,模板将安装在“新建项目”对话框的“Visual Basic”根类别中。若要将模板安装在“Visual Basic”子类别中,请将该子类别名称指定为 ProjectSubType 属性的值。
说明: |
---|
在下面的示例中,使用的 ContentVersion 元素值为 2.0。如果项目模板可由 Visual Studio 2005 或 Visual Studio 2008 使用,请使用值 1.0。如果项目模板是特定于 Visual Studio 2008 的,请使用 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>
请参见
任务
如何:打包社区组件以使用 Visual Studio 内容安装程序