【研发工具】使用VSIX安装自定义项目模板(Visual Studio)

发布于:2025-06-25 ⋅ 阅读:(18) ⋅ 点赞:(0)

目录

一、目的

二、解决方案

2.1 什么是VSIX模板

2.2 创建项目模板

2.3 创建VSIX项目

2.4 ‌配置 VSIX 清单

2.5 生成与安装

2.6卸载VSIX扩展,删除模板

三、文章总结


一、目的

        为了方便多项目模板被团队内部更多人使用,方便安装和部署到团队其他成员项目中。考虑使用VSIX项目模板部署自定义项目模板。
        

二、解决方案

2.1 什么是VSIX模板

        ‌  VSIX项目模板  ‌是用于创建和打包扩展或现有扩展以供部署的一种工具,它是  Visual Studio Extension  (VSIX)的一部分。通过安装VSIX文件,可以将自定义的项目模板、项目项模板和项目工程模板添加到Visual Studio的模板列表中,从而简化项目的创建过程‌。
        VSIX 部署支持 VSPackage、程序集、MEF 组件、项目模板、项模板、工具箱控件和自定义扩展类型。
        可以使用 VSIX 项目模板在 VSIX 项目中包装一个或多个 Visual Studio 扩展,然后在 Visual Studio Marketplace  网站上发布包
若要使用 VSIX 项目,必须安装 Visual Studio SDK 。 有关 Visual Studio SDK 的详细信息,请参阅  Visual Studio SDK

2.2 创建项目模板

        前提是你需要有一个项目模板。( 通过 Visual Studio 的  项目> 导出模板  向导生成项目或项模板的  .zip  文件)
默认情况下,此模板位于: %USERPROFILE%\Documents\Visual Studio {Version}\Templates\ProjectTemplates
        对于项目模板创建,可以先了解: 【研发工具】.Net创建多项目模板(Visual Studio)-CSDN博客

2.3 创建VSIX项目

        在Visual Studio中选择“文件”>“新建”>“项目”,然后选择VSIX项目的C#或Visual Basic版本。

2.4 ‌配置 VSIX 清单

  • 双击项目中的 source.extension.vsixmanifest 文件。
  • 基本信息设置‌:
    • 产品名称、ID、作者、描述(例如:产品名称="我的项目模板")。
  • 添加模板资产‌:
    • 在 Assets 标签页 → 点击 新建 → 类型选择:
      • 项目模板:Microsoft.VisualStudio.ProjectTemplate
      • 项模板:Microsoft.VisualStudio.ItemTemplate
    • 来源选择 文件系统 → 浏览添加 .zip 文件。
  • 设置安装目标‌:
    • 指定兼容的 Visual Studio 版本(如 [17.0, 18.0) 支持 VS2022相关版本)。

2.5 生成与安装

        1.生成项目 → 输出目录生成 .vsix 文件。

        2.双击  .vsix 文件运行安装程序,按提示完成安装。
            ps:需要关闭所有已打开的visual stuido窗口
            3. 重启 Visual Studio‌ 后生效(新建项目/项时可见模板)。

      2.6卸载VSIX扩展,删除模板

              因为是基于VSIX安装的项目模板,若要删除在vs菜单栏“扩展 ”-》“ 管理扩展 ”,找到项目卸载即可 (卸载时需要所有vs窗体关闭)。

      三、文章总结

              VSIX支持扩展版本更新,同时还有更多丰富的使用方式,大家可以多多探索。
              
              把之所学,以文载之~ 欢迎大家,多多交流

      网站公告

      今日签到

      点亮在社区的每一天
      去签到